Keywords

You can create and manage keywords, using these available fields.

Fields

Name

Description

Type

Add

Update

Campaign ID

The ID of the parent campaign. Required if the keyword is being defined at campaign level (for campaign negative kw’s).

long

Required if keyword is set at campaign level.

optional

Ad Group ID

The ID of the parent ad group. Required if the keyword is set up at the ad group level.

long

Required if keyword is set at the ad group level.

optional

Object ID

The ID of the keyword. Not required for creation. Required for updates and deletes. Note that in general, the bulk file will return a leading apostrophe with the Keyword ID (i.e., the Object Id) if the ID is greater than 11 digits. For example, for the keyword Mothers Day Flowers, for the Object Id 23456789123 the Object Id is shown as ‘23456789123. Use the object id with the leading apostrophe if this exists.

long

N/A

required

Keyword

The actual keyword. Maximum limit is 255 characters. Note that the value for an existing keyword cannot be updated. To update this field, a new keyword must be created. Therefore, this field will be ignored if passed when attempting to update a keyword.

string

required

optional

Match Type

The matching algorithm that will be used. Supported match types:

  • Broad

  • Exact

  • Phrase

  • NegativeExact

  • NegativePhrase

Note: Will default to Broad if not provided. Note also that updates to match type are not supported for existing keywords.

string

optional

optional

Landing URL

The landing page URL is the web address that a user is sent to after clicking on the ad triggered by the keyword. A URL set at the keyword level overrides the landing URL set at the ad level. Maximum limit is 2048 characters.

string

optional

optional

Status

The status of the keyword. Valid values are:

  • Active

  • Paused

Keywords are defaulted to Active if no status is provided upon creation.

enum

optional

optional

Search CPC

The bid amount in the currency of your account. A bid specified at the keyword level will override the ad group level bid. The minimum accepted CPC bid is $0.05. Note that this field for CPC needs to be simply a decimal. If a $ sign appears, the bid will fail.

decimal

optional

optional

param1

Dynamic substitution text that can be called when the ad serves, using the macro. The character limit for this field is 1022.

string

optional

optional

param2

Dynamic substitution text that can be called when the ad serves, using the macro. The character limit for this field is 70.

string

optional

optional

param3

Dynamic substitution text that can be called when the ad serves, using the macro. The character limit for this field is 70.

string

optional

optional

Note

Search CPC, landing URL, param values, and status are the only keyword level updates that can be made.

Create a Keyword

The following example contains the fields required for creating a keyword. All other fields in this spreadsheet are blank and are not shown:

Action

Object Type

Campaign ID

Ad Group ID

Keyword

Match Type

Status

Add

Keyword

400

  1. If it is campaign level keyword creation, please fill in campaign ID column, if it is ad group level keyword creation, please fill in ad group ID column.

The keyword value.

EXACT

Active (Will default to Active if not provided).

Update a Keyword

When updating a keyword, the only required fields are Action, Object Type, Object ID, and the fields you would like to update.

Action

Object Type

Object ID

Match Type

Update

Keyword

‘274951606041

PHRASE