SiteSuggestionService
SiteSuggestionService provides operations for getting web site suggestions
by category, topics, URLs or demographics.
For more information about how to use the SiteSuggestionService, see the overview section.
Requests
Returns site suggestions based on the specified
category name. Each
suggestion contains useful information such as the URL, accepted ad
formats and page views.
Category names can alternatively be obtained by using the Site Tool in
the AdWords website. To access
Site Tool, navigate to an ad group within a
site-targeted campaign and click on the "Add sites" link. A list of
categories is displayed when the "Browse categories" radio button is
checked. You can then expand the categories of interest to reach your
target category. For example, if your target category is
"Recruitment & Staffing", which is a sub-category of "Human Resources",
which in turn is a sub-category of "Business", then the category name will
simply be "Recruitment & Staffing". There is no need to specify its
ancestor category names.
Parameters
| Parameter name | Parameter type | Parameter description |
|---|
| categoryName |
string |
|
| targeting |
LanguageGeoTargeting |
language and geo targeting information. |
Response
| Response type | Response description |
|---|
SiteSuggestion[] |
a list of site suggestions. |
Returns site suggestions based on the specified demographics criteria,
including gender, age, income, ethnicity and whether there are children
in the household. Each suggestion contains useful information such as the
URL, accepted ad formats and page views.
Parameters
Response
| Response type | Response description |
|---|
SiteSuggestion[] |
a list of site suggestions. |
Returns site suggestions based on the specified topics. Each suggestion
contains useful information such as the URL, accepted ad formats and page
views.
Parameters
| Parameter name | Parameter type | Parameter description |
|---|
| topics |
string[] |
a list of keywords, each of which can be a word or phrase. |
| targeting |
LanguageGeoTargeting |
language and geo targeting information. |
Response
| Response type | Response description |
|---|
SiteSuggestion[] |
a list of site suggestions. |
Returns site suggestions based on the specified URLs. Each suggestion
contains useful information such as the URL, accepted ad formats and page
views.
Parameters
| Parameter name | Parameter type | Parameter description |
|---|
| urls |
string[] |
a list of seed URLs. |
| targeting |
LanguageGeoTargeting |
language and geo targeting information. |
Response
| Response type | Response description |
|---|
SiteSuggestion[] |
a list of site suggestions. |
API Reference
