enum CustomTargetingValue.MatchType (v202502)

  • CustomTargetingValue.MatchType defines how CustomTargetingValue.name strings are matched with ad requests.

  • There are several match types including EXACT, BROAD, PREFIX, BROAD_PREFIX, SUFFIX, and CONTAINS, each with distinct matching behaviors.

  • Some match types, like BROAD, BROAD_PREFIX, SUFFIX, and CONTAINS, have limitations on where they can be used.

  • The UNKNOWN match type is used when the actual value is not exposed by the requested API version.
Service
CustomTargetingService
Dependencies
CustomTargetingValue
▼
CustomTargetingValue.MatchType

Represents the ways in which CustomTargetingValue.name strings will be matched with ad requests.

Namespace
https://www.google.com/apis/ads/publisher/v202502
Enumeration Description
EXACT Used for exact matching. For example, the targeting value car=honda will only match to the ad request car=honda.
BROAD Used for lenient matching when at least one of the words in the ad request matches the targeted value. The targeting value car=honda will match to ad requests containing the word honda. So ad requests car=honda or car=honda civic or car=buy honda or car=how much does a honda cost will all have the line item delivered.

This match type can not be used within an audience segment rule.
PREFIX Used for 'starts with' matching when the first few characters in the ad request match all of the characters in the targeted value. The targeting value car=honda will match to ad requests car=honda or car=hondas for sale but not to car=I want a honda.
BROAD_PREFIX This is a combination of MatchType#BROAD and MatchType#PREFIX matching. The targeting value car=honda will match to ad requests that contain words that start with the characters in the targeted value, for example with car=civic hondas.

This match type can not be used within an audience segment rule.
SUFFIX Used for 'ends with' matching when the last characters in the ad request match all of the characters in the targeted value. The targeting value car=honda will match with ad requests car=honda or car=I want a honda but not to car=hondas for sale.

This match type can not be used within line item targeting.
CONTAINS Used for 'within' matching when the string in the ad request contains the string in the targeted value. The targeting value car=honda will match with ad requests car=honda, car=I want a honda, and also with car=hondas for sale, but not with car=misspelled hond a.

This match type can not be used within line item targeting.
UNKNOWN The value returned if the actual value is not exposed by the requested API version.