type LocationGroups (v201809)

Service

CampaignCriterionService

Inheritance

Criterion

▼

AdSchedule AgeRange Carrier ContentLabel CriterionUserInterest CriterionUserList Gender IncomeRange IpBlock Keyword Language Location LocationGroups MobileAppCategory MobileApplication MobileDevice OperatingSystemVersion Parent Placement Platform ProductScope Proximity Vertical Webpage YouTubeChannel YouTubeVideo

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/v201809

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. `CUSTOM_AFFINITY` Custom Affinity, a criterion used for custom audience targeting. `CUSTOM_INTENT` Custom Intent, a criterion used for custom audience targeting. `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".

type LocationGroups (v201809)

Field

`id`

`type`

`Criterion.Type`

`feedId`

`matchingFunction`