AdWords API
Hide

type TargetingIdeaSelector (v201506)

Service
TargetingIdeaService
Dependencies
get()
▼
TargetingIdeaSelector
▼
cm:Paging

A descriptor for finding TargetingIdeas that match the specified criteria.

Namespace
https://adwords.google.com/api/adwords/o/v201506
Fields
Field Type Description
searchParameters
ContentsNotNull
DistinctTypes
Required
  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
Required
 IdeaType Limits the request to responses of this IdeaType, e.g. KEYWORDS. This field is required and should not be null.
Enumerations
KEYWORD
Keyword idea.
requestType
Required
 RequestType Specifies the RequestType, e.g. IDEAS or STATS. This field is required and should not be null.
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.
requestedAttributeTypes
ContentsDistinct
ContentsNotNull
 AttributeType[] Request Attributes and associated data for this set of Types.

An empty set indicates a request for KeywordAttribute, PlacementAttribute, and IdeaType. This field must contain distinct elements. This field must not contain null elements.

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.

CRITERION
Represents a placement, depending on request type.

This element is supported by following IdeaTypes: PLACEMENT.

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, PLACEMENT.

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

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 3.0 License, and code samples are licensed under the Apache 2.0 License. For details, see our Site Policies.

Send feedback about...

This page
Documentation feedback
AdWords API
Product feedback