This article refers to campaigns with keyword-level search engine tracking enabled where search engines are defined per keyword. For campaigns where search engines are defined per campaign (most campaigns), see this article instead.

If you have a long list of keywords or wish to include additional keyword details such as Tags, Preferred Landing Page, or Translation, we recommend adding keywords by file.

Choose the tab labeled Import from File

There are two options to choose from:

Option 1: Track all keywords in the file in the same search engines

When this option is selected, you will first choose which search engines all keywords in the file will be tracking.

(If you need to track different keywords on different search engines, you'll need to repeat this process with different files for each set of search engines)

Once you've chosen your search engines, download the Excel template

Open the Excel template, remove the example keywords and add your own. The only required field is Keyword, others may be omitted. Learn more about optional keyword fields

When finished adding keywords, save the file, click Upload new keywords, and select the file.

Keywords will be added, and you will have a chance to look verify the import results. You can click any fields to make additional edits, or click Close to finish.

Option 2: Specify which search engines each keyword should be tracking in the file

With this option selected, instead of choosing the search engines for all keywords in the file, you will be able to specify the search engine for each keyword separately in the file.

Open the Excel template, remove the example keywords and add your own. The only required fields are Keyword and Search Engine, while others may be omitted.

For the search engines column, you'll need to use the a list of search engine IDs separated by a comma. Learn more about keyword fields and how to find search engine IDs

When finished adding keywords, save the file, click Upload new keywords, and select the file.

Keywords will be added, and you will have a chance to look verify the import results. You can click any fields to make additional edits, or click Close to finish.

Common issues with importing keyword files

Use the template file provided

Always use the template file as a starting point to add or update your keywords. For best results, download a new template file in the same context where you will upload the new file. Using an old or outdated template file, or a template file intended for another area could have unexpected results.

Removing columns in the Excel file

Do not remove any columns from the template file. If you do not plan to update a column, simply leave it blank. We'll try our best to understand how the file has been modified if a column is removed, the results cannot be guaranteed.

Renaming column headers in the Excel file

Do not rename any column headers in the template Excel file. We'll try our best to understand how the file has been modified if a column is renamed, but the results cannot be guaranteed.

Preferred Landing Page must be a valid URL

All values for Preferred Landing Page must be a valid URL. Use an absolute URL instead of a relative URL.

Separate tags by comma

Spaces in tags are okay, but commas indicate that's the end of a tag. Only use commas to separate tags.

Search engine IDs are not valid

If keyword-level search engine tracking is enabled for this campaign, a list of all tracking search engines must be specified for each keyword.

When uploading from a file, you will need to include a list of each desired search engine ID.

The format for the search engine ID is:

{SEARCH ENGINE NAME}|{COUNTRY CODE}|{LANGUAGE CODE}|{DEVICE}|{LOCATION (OPTIONAL)}

For example for Google search engine in the United States in English language on desktop devices and the location of Los Angeles, you'd enter it as:

google|us|en|desktop|Los Angeles\, California\, United States

Please note that commas in locations must be escaped with a leading forward slash.

Multiple search engines should be separated by a comma. For example:

google|us|en|desktop, google|us|en|mobile|Los Angeles\, California\, United States

Search engine and location IDs

  • The full list of supported search engines and their IDs can be downloaded here.
  • The list of supported locations can be downloaded here.
Did this answer your question?