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