You can create and manage keywords, using these available fields.
|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|
The matching algorithm that will be used. Supported match types:
Note: Will default to Broad if not provided. Note also that updates to match type are not supported for existing keywords.
|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|
The status of the keyword. Valid values are:
Keywords are defaulted to Active if no status is provided upon creation.
|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|
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|
||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|