AdWords API v2009 New Keyword Targeting Service

With the release of the latest version of the AdWords API, Google advertisers have a hugely expanded array of keyword research tools at their fingertips. In the past, API users were able to get a list of keyword synonyms or a list of keywords Google associated with a specific url, along with the average monthly searches for the keyword. The problem was that only “broad match” counts were possible (through the API). And broad match counts differ significantly from exact match counts, which estimates of the actual number of searches that occurred on the keyword. While it was possible to get counts associated with the three types (broad, exact, and phrase) through the AdWords interface, keywords or urls had to be checked manually, one at a time. With the API, its possible to cycle through hundreds of urls, get keyword recommendations back from Googlebot which can be used as part of a deep linking AdWords campaign.

That issue is solved with the new release. Counts can be requested for broad, exact, or phrase match types. But that’s just a beginning.

The new keyword targeting service allows API users to request a much expanded list of search parameters, speficially:

* KeywordCategoryIdSearchParameter
* RelatedToKeywordSearchParameter
* RelatedToUrlSearchParameter
* SeedAdGroupIdSearchParameter
* AverageTargetedMonthlySearchesSearchParameter
* CompetitionSearchParameter
* CountryTargetSearchParameter
* ExcludedKeywordSearchParameter
* GlobalMonthlySearchesSearchParameter
* IncludeAdultContentSearchParameter
* KeywordCategoryIdSearchParameter
* KeywordMatchTypeSearchParameter
* LanguageTargetSearchParameter
* MobileSearchParameter
* NgramGroupsSearchParameter
* RelatedToKeywordSearchParameter
* RelatedToUrlSearchParameter
* SeedAdGroupIdSearchParameter

And, the new service supports a research into keywords associated with Google content network. User can create queries of the content network with selections include:

* AdTypeSearchParameter
* CountryTargetSearchParameter
* LanguageTargetSearchParameter
* PlacementTypeSearchParameter
* RelatedToKeywordSearchParameter
* RelatedToUrlSearchParameter

The list of outputs from the service is vastly expanded as well. It includes:

Expand AD_SHARE AD_SHARE
Represents the percentage of the time that the advertiser’s ad (if applicable) was shown for queries associated with the given keyword idea.

Expand APPROX_CONTENT_IMPRESSIONS_PER_DAY APPROX_CONTENT_IMPRESSIONS_PER_DAY
Represents the (approximate) number of impressions per day for this placement idea on the content network.

Expand AVERAGE_TARGETED_MONTHLY_SEARCHES AVERAGE_TARGETED_MONTHLY_SEARCHES
Represents the average number of searches (approximated) on this keyword idea, targeted to the specified geographies.

Expand COMPETITION COMPETITION
Represents the relative amount of competition associated with the given keyword idea, relative to other keywords. This value will be between 0 and 1 (inclusive).

Expand EXTRACTED_FROM_WEBPAGE EXTRACTED_FROM_WEBPAGE
Represents the webpage from which this keyword idea was extracted (if applicable.)

Expand FORMATS FORMATS
Represents the various types of ads & sizes of ads that may render within the given placement idea.

Expand GLOBAL_MONTHLY_SEARCHES GLOBAL_MONTHLY_SEARCHES
Represents the (approximate) number of searches for the given keyword idea, independant of any geo settings.

Expand IDEA_TYPE IDEA_TYPE
Represents the type of the given idea.

Expand IN_STREAM_AD_INFO IN_STREAM_AD_INFO
Represents the duration(s)/other instream information, for the given placement idea. (if applicable)

Expand KEYWORD KEYWORD
Represents the Keyword corresponding to the given keyword idea.

Expand KEYWORD_CATEGORY KEYWORD_CATEGORY
Represents a category id for a category within the category hierarchy for keyword ideas.

Expand NGRAM_GROUP NGRAM_GROUP
Represents the ngram group for the given keyword idea.

Expand PLACEMENT PLACEMENT
Represents the Placement corresponding to the given placement idea.

Expand PLACEMENT_NAME PLACEMENT_NAME
Represents the publisher given name of the given placement idea (if applicable).

Expand SAMPLE_URL SAMPLE_URL
Represents a sample page upon which the given placement idea shows from the content network.

Expand SEARCH_SHARE SEARCH_SHARE
Represents the percentage of the time that the advertiser’s webpage (if applicable) was shown for queries associated with the given keyword idea.

Expand PLACEMENT_CATEGORY PLACEMENT_CATEGORY
Represents a category id for a category within the category hierarchy for placement ideas. Resulting attribute is IntegerAttribute.

Expand PLACEMENT_TYPE PLACEMENT_TYPE
Represents the type of media of the given placement idea. Some examples of this could include: videos on the web, web sites, flash games on the content network, website feeds, etc.

Expand PUBLISHER_DESCRIPTION PUBLISHER_DESCRIPTION
Represents the publisher-supplied description of the given placement idea.

Expand TARGETED_MONTHLY_SEARCHES TARGETED_MONTHLY_SEARCHES

The capabilities of the new keyword service vastly expands what has been possible in the past. This should be enough for AdWords professional that haven’t used the API in the past to rush out and get their API tokens.