type LocationGroups (v201802)

Represents a criterion containing a function that when evaluated specifies how to target based on the type of the location. These "location groups" are custom, dynamic bundles of locations (for instance "High income areas in California" or "Airports in France").

Examples:

For income demographic targeting, we need to specify the income tier and the geo which it targets. Areas in California that are in the top national income tier can be represented by:
            
            Function function = new Function();
            function.setLhsOperand(Arrays.asList(
            (Operand) new IncomeOperand(IncomeTier.TIER_1));
            function.setOperator(Operator.AND);
            function.setRhsOperand(Arrays.asList(
            (Operand) new GeoTargetOperand(Lists.newArrayList(new CriterionId(21137L))));
            
         
For place of interest targeting, we need to specify the place of interest category and the geo which it targets. Airports in France can be represented by:
            
            Function function = new Function();
            function.setLhsOperand(Arrays.asList(
            (Operand) new PlacesOfInterestOperand(PlacesOfInterestOperand.Category.AIRPORT));
            function.setOperator(Operator.AND);
            function.setRhsOperand(Arrays.asList(
            (Operand) new GeoTargetOperand(Lists.newArrayList(new CriterionId(2250L))));
            
         

NOTE: Places of interest and income targeting are read only.


Namespace
https://adwords.google.com/api/adwords/cm/v201802

Field

Criterion (inherited)

id

xsd:long

ID of this criterion.

This field can be selected using the value "Id".
This field can be filtered on.
This field is required and should not be null when it is contained within Operators : SET, REMOVE.

type

Criterion.Type

Indicates that this instance is a subtype of Criterion. Although this field is returned in the response, it is ignored on input and cannot be selected. Specify xsi:type instead.


Enumerations
CONTENT_LABEL
Content label for exclusion.
KEYWORD
Keyword. e.g. 'mars cruise'
PLACEMENT
Placement. aka Website. e.g. 'www.flowers4sale.com'
VERTICAL
Vertical, e.g. 'category::Animals>Pets' This is for vertical targeting on the content network.
USER_LIST
User lists, are links to sets of users defined by the advertiser.
USER_INTEREST
User interests, categories of interests the user is interested in.
MOBILE_APPLICATION
Mobile applications to target.
MOBILE_APP_CATEGORY
Mobile application categories to target.
PRODUCT_PARTITION
Product partition (product group) in a shopping campaign.
IP_BLOCK
IP addresses to exclude.
WEBPAGE
Webpages of an advertiser's website to target.
LANGUAGE
Languages to target.
LOCATION
Geographic regions to target.
AGE_RANGE
Age Range to exclude.
CARRIER
Mobile carriers to target.
OPERATING_SYSTEM_VERSION
Mobile operating system versions to target.
MOBILE_DEVICE
Mobile devices to target.
GENDER
Gender to exclude.
PARENT
Parent to target and exclude.
PROXIMITY
Proximity (area within a radius) to target.
PLATFORM
Platforms to target.
PREFERRED_CONTENT
Representing preferred content bid modifier.
AD_SCHEDULE
AdSchedule or specific days and time intervals to target.
LOCATION_GROUPS
Targeting based on location groups.
PRODUCT_SCOPE
Scope of products. Contains a list of product dimensions, all of which a product has to match to be included in the campaign.
YOUTUBE_VIDEO
YouTube video to target.
YOUTUBE_CHANNEL
YouTube channel to target.
APP_PAYMENT_MODEL
Enables advertisers to target paid apps.
INCOME_RANGE
Income range to target and exclude.
INTERACTION_TYPE
Interaction type to bid modify.
UNKNOWN

This field can be selected using the value "CriteriaType".
This field can be filtered on.
This field is read only and will be ignored when sent to the API.

Criterion.Type

xsd:string

Indicates that this instance is a subtype of Criterion. Although this field is returned in the response, it is ignored on input and cannot be selected. Specify xsi:type instead.

LocationGroups

feedId

xsd:long

Feed to be used for targeting around locations. This is required for distance targets.

This field can be selected using the value "FeedId".

matchingFunction

Function

Matching function to filter out locations targeted by the criteria. This allows advertisers to target based on the semantics of the location.

This field can be selected using the value "MatchingFunction".
This field is required and should not be null when it is contained within Operators : ADD.

Send feedback about...

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