type TargetingIdeaSelector (v201806)

A descriptor for finding TargetingIdeas that match the specified criteria.


Namespace
https://adwords.google.com/api/adwords/o/v201806

Field

searchParameters

  1. SearchParameter[]
    1. CategoryProductsAndServices...
    2. CompetitionSearchParameter
    3. IdeaTextFilterSearchParameter
    4. IncludeAdultContentSearchPa...
    5. LanguageSearchParameter
    6. LocationSearchParameter
    7. NetworkSearchParameter
    8. RelatedToQuerySearchParameter
    9. RelatedToUrlSearchParameter
    10. SearchVolumeSearchParameter
    11. SeedAdGroupIdSearchParameter

Search for targeting ideas based on these search rules.

An empty set indicates this selector is valid for selecting metadata with default parameters.

This field must not contain null elements.
Elements in this field must have distinct types.
This field is required and should not be null.

ideaType

IdeaType

Limits the request to responses of this IdeaType, e.g. KEYWORDS.


Enumerations
KEYWORD
Keyword idea.

This field is required and should not be null.

requestType

RequestType

Specifies the RequestType, e.g. IDEAS or STATS.


Enumerations
IDEAS
Request for new ideas based on other entries in selector. This RequestType can be used to request other ideas using keyword/placements that the user already has.
STATS
Request for stats for entries in selector. This RequestType can be used to request the stats for keywords/placements that the user already has.

Stats are generated once a month (typically on the last week of the month) from the historical data of previous months.

This field is required and should not be null.

requestedAttributeTypes

AttributeType[]

Request Attributes and associated data for this set of Types.

An empty set indicates a request for KeywordAttribute, PlacementAttribute, and IdeaType.


Enumerations
UNKNOWN
Value substituted in when the actual value is not available in the Web API version being used. (Please upgrade to the latest published WSDL.)

This element is not supported directly by any IdeaType.

CATEGORY_PRODUCTS_AND_SERVICES
Represents a category ID in the "Products and Services" taxonomy.

Resulting attribute is IntegerSetAttribute.

This element is supported by following IdeaTypes: KEYWORD.

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).

Resulting attribute is DoubleAttribute.

This element is supported by following IdeaTypes: KEYWORD.

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

Resulting attribute is WebpageDescriptorAttribute.

This element is supported by following IdeaTypes: KEYWORD.

IDEA_TYPE
Represents the type of the given idea.

Resulting attribute is IdeaTypeAttribute.

This element is supported by following IdeaTypes: KEYWORD.

KEYWORD_TEXT
Represents the keyword text for the given keyword idea.

Resulting attribute is StringAttribute.

This element is supported by following IdeaTypes: KEYWORD.

SEARCH_VOLUME
Represents either the (approximate) number of searches for the given keyword idea on google.com or google.com and partners, depending on the user's targeting.

Resulting attribute is LongAttribute.

This element is supported by following IdeaTypes: KEYWORD.

AVERAGE_CPC
Represents the average cost per click historically paid for the keyword.

Resulting attribute is MoneyAttribute.

This element is supported by following IdeaTypes: KEYWORD.

TARGETED_MONTHLY_SEARCHES
Represents the (approximated) number of searches on this keyword idea (as available for the past twelve months), targeted to the specified geographies.

Resulting attribute is MonthlySearchVolumeAttribute.

This element is supported by following IdeaTypes: KEYWORD.

This field must contain distinct elements.
This field must not contain null elements.

paging

cm:Paging

A Paging object that specifies the desired starting index and number of results to return.

This field is required and should not be null.

localeCode

xsd:string

The locale code (for example "en_US") used for localizing strings, controlling numeric formatting, and the like. See RFC 3066 for information on the format used.

currencyCode

xsd:string

The currency code to be used for all monetary values returned in results in ISO format (see https://developers.google.com/adwords/api/docs/appendix/currencycodes for supported currencies). The default is "USD" (US dollars).

Send feedback about...

AdWords API
AdWords API
Need help? Visit our support page.