| | Sign in

Skip to page content Skip to main navigation

AdWords API v2009

v2009 Docs | v13 Docs

type TargetingIdeaSelector

Service

TargetingIdeaService

Dependencies

get() getBulkKeywordIdeas()
uses

uses

TargetingIdeaSelector
uses

uses

AttributeType IdeaType RequestType SearchParameter

A descriptor for finding TargetingIdeas that match the specified criteria.

Namespace

https://adwords.google.com/api/adwords/o/v200909

Fields

searchParameters
ideaType
requestType
requestedAttributeTypes
paging
localeCode
currencyCode

Field	Type	Description
searchParameters	`SearchParameter[]` `AdTypeSearchParameter` `CompetitionSearchParameter` `IncludeAdultContentSearchPa...` `KeywordCategoryIdSearchPara...` `KeywordMatchTypeSearchParam...` `MobileSearchParameter` `NgramGroupsSearchParameter` `PlacementTypeSearchParameter` `RelatedToUrlSearchParameter` `SeedAdGroupIdSearchParameter` `AverageTargetedMonthlySearc...` `ExcludedKeywordSearchParameter` `GlobalMonthlySearchesSearch...` `RelatedToKeywordSearchParam...` `CountryTargetSearchParameter` `LanguageTargetSearchParameter`	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. This field is required and should not be `null`.
ideaType	`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.
requestType	`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	`AttributeType[]`	Request Attributes and `AttributeMetadata`s for this set of `Type`s. An empty set indicates a request for KeywordAttribute, PlacementAttribute, and IdeaType. This field must not contain `null` elements. Enumerations `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. Resulting attribute is DoubleAttribute. This element is supported by following IdeaTypes: KEYWORD. `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. `AVERAGE_TARGETED_MONTHLY_SEARCHES` Represents the average number of searches (approximated) on this keyword idea, targeted to the specified geographies. Resulting attribute is LongAttribute. 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. `FORMATS` Represents the various types of ads & sizes of ads that may render within the given placement idea. Resulting attribute is AdFormatSpecListAttribute. This element is supported by following IdeaTypes: PLACEMENT. `GLOBAL_MONTHLY_SEARCHES` Represents the (approximate) number of searches for the given keyword idea, independant of any geo settings. Resulting attribute is LongAttribute. 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` Represents the Keyword corresponding to the given keyword idea. Resulting attribute is KeywordAttribute. This element is supported by following IdeaTypes: KEYWORD. `KEYWORD_CATEGORY` Represents a category id for a category within the category hierarchy for keyword ideas. Resulting attribute is IntegerSetAttribute. This element is supported by following IdeaTypes: KEYWORD. `NGRAM_GROUP` Represents the ngram group for the given keyword idea. Resulting attribute is StringAttribute. This element is supported by following IdeaTypes: KEYWORD. `PLACEMENT` Represents the Placement corresponding to the given placement idea. Resulting attribute is PlacementAttribute. This element is supported by following IdeaTypes: PLACEMENT. `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. `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. Resulting attribute is DoubleAttribute. This element is supported by following IdeaTypes: KEYWORD. `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. `PUBLISHER_DESCRIPTION` Represents the publisher-supplied description of the given placement idea. Resulting attribute is StringAttribute. This element is supported by following IdeaTypes: PLACEMENT. `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	`cm:Paging`	A Paging object that specifies the desired starting index and number of results to return. A `null` value indicates all available results should be returned.
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://www.unicode.org/cldr/data/diff/supplemental/supplemental.html). The default is "USD" (US dollars).