AdWords API
Feedback on this document

type TargetingIdeaSelector (v201302)

A descriptor for finding TargetingIdeas that match the specified criteria.


Namespace
https://adwords.google.com/api/adwords/o/v201302
Fields
Field Type Description
searchParameters
ContentsNotNull
DistinctTypes
Required
  1. SearchParameter[]
    1. AdSpecListSearchParameter
    2. CategoryProductsAndServices...
    3. CompetitionSearchParameter
    4. ExcludedKeywordSearchParameter
    5. IdeaTextFilterSearchParameter
    6. IncludeAdultContentSearchPa...
    7. LanguageSearchParameter
    8. LocationSearchParameter
    9. NetworkSearchParameter
    10. PlacementTypeSearchParameter
    11. RelatedToQuerySearchParameter
    12. RelatedToUrlSearchParameter
    13. SearchVolumeSearchParameter
    14. 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 or PLACEMENTS. This field is required and should not be null.
Enumerations
KEYWORD
Keyword idea.
PLACEMENT
Placement idea. This is enabled for AdX.
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.
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.

AD_TYPE_SPEC
Represents the various types of ads, sizes of ads, and ad configurations that may be specified within the given placement idea.

Resulting attribute is AdTypeSpecAttribute.

This element is supported by following IdeaTypes: PLACEMENT.

APPROX_CONTENT_IMPRESSIONS_PER_DAY
Represents the (approximate) number of impressions per day for this placement idea on the content network. Resulting attribute is LongRangeAttribute.

This element is supported by following IdeaTypes: PLACEMENT.

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 keyword or placement, depending on request type. Starting at version v201206, only placement requests can retrieve this attribute.

This element is supported by following IdeaTypes: KEYWORD, 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.

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

Resulting attribute is InStreamAdInfoAttribute.

This element is supported by following IdeaTypes: PLACEMENT.

KEYWORD_TEXT
Represents the keyword text for the given keyword idea.

Resulting attribute is StringAttribute.

This element is supported by following IdeaTypes: KEYWORD.

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

Resulting attribute is StringAttribute.

This element is supported by following IdeaTypes: PLACEMENT.

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

Resulting attribute is StringAttribute.

This element is supported by following IdeaTypes: PLACEMENT.

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

This element is supported by following IdeaTypes: PLACEMENT.

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.

Resulting attribute is PlacementTypeAttribute.

This element is supported by following IdeaTypes: PLACEMENT.

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 http://code.google.com/apis/adwords/docs/developer/adwords_api_currency.html for supported currencies). The default is "USD" (US dollars).

Authentication required

You need to be signed in with Google+ to do that.

Signing you in...

Google Developers needs your permission to do that.