enum CustomTargetingValue.MatchType (v202411)
Stay organized with collections
Save and categorize content based on your preferences.
Service
CustomTargetingService
Represents the ways in which CustomTargetingValue.name strings will be matched with ad
requests.
- Namespace
-
https://www.google.com/apis/ads/publisher/v202411
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.
|
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-06 UTC.
[null,null,["Last updated 2025-08-06 UTC."],[[["\u003cp\u003eCustomTargetingValue.MatchType defines how targeting values are matched with ad requests.\u003c/p\u003e\n"],["\u003cp\u003eMatch types include \u003ccode\u003eEXACT\u003c/code\u003e, \u003ccode\u003eBROAD\u003c/code\u003e, \u003ccode\u003ePREFIX\u003c/code\u003e, \u003ccode\u003eBROAD_PREFIX\u003c/code\u003e, \u003ccode\u003eSUFFIX\u003c/code\u003e, and \u003ccode\u003eCONTAINS\u003c/code\u003e, each with specific matching criteria.\u003c/p\u003e\n"],["\u003cp\u003eSome match types like \u003ccode\u003eBROAD\u003c/code\u003e, \u003ccode\u003eBROAD_PREFIX\u003c/code\u003e, \u003ccode\u003eSUFFIX\u003c/code\u003e, and \u003ccode\u003eCONTAINS\u003c/code\u003e have restrictions on usage within audience segment rules or line item targeting.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eEXACT\u003c/code\u003e match type requires an exact match between the targeting value and the ad request.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eUNKNOWN\u003c/code\u003e match type is returned if the actual value is not supported by the API version.\u003c/p\u003e\n"]]],["CustomTargetingValue.MatchType defines how ad request strings match CustomTargetingValue.name strings. It uses several matching types: `EXACT` for exact matches, `BROAD` for matching at least one word, `PREFIX` for starts-with matching, `BROAD_PREFIX` combining `BROAD` and `PREFIX`. `SUFFIX` matches the end of a string and `CONTAINS` for any instance of the string within an ad request. Some types, like `BROAD`, `BROAD_PREFIX`, `SUFFIX` and `CONTAINS`, have limitations in certain targeting rules. `UNKNOWN` is for values not in the API version.\n"],null,["# enum CustomTargetingValue.MatchType (v202411)\n\n**Service** \n**CustomTargetingService** **Dependencies** \n[CustomTargetingValue](/ad-manager/api/reference/v202411/CustomTargetingService.CustomTargetingValue) \n▼\n**CustomTargetingValue.MatchType**\n\nRepresents the ways in which [CustomTargetingValue.name](/ad-manager/api/reference/v202411/CustomTargetingService.CustomTargetingValue#name) strings will be matched with ad\nrequests.\n\n*** ** * ** ***\n\nNamespace\n:\n `https://www.google.com/apis/ads/publisher/v202411`\n\n| Enumeration | Description |\n|----------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `EXACT` | Used for exact matching. For example, the targeting value `car=honda` will only match to the ad request `car=honda`. |\n| `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. |\n| `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`. |\n| `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. |\n| `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. |\n| `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. |\n| `UNKNOWN` | The value returned if the actual value is not exposed by the requested API version. |"]]