REST Resource: targetingTemplates
Stay organized with collections
Save and categorize content based on your preferences.
Resource: TargetingTemplate
Contains properties of a targeting template. A targeting template encapsulates targeting information which can be reused across multiple ads.
| JSON representation |
{
"id": string,
"accountId": string,
"subaccountId": string,
"advertiserId": string,
"advertiserIdDimensionValue": {
object (DimensionValue)
},
"name": string,
"geoTargeting": {
object (GeoTargeting)
},
"technologyTargeting": {
object (TechnologyTargeting)
},
"dayPartTargeting": {
object (DayPartTargeting)
},
"keyValueTargetingExpression": {
object (KeyValueTargetingExpression)
},
"languageTargeting": {
object (LanguageTargeting)
},
"listTargetingExpression": {
object (ListTargetingExpression)
},
"kind": string
} |
| Fields |
id |
string (int64 format)
ID of this targeting template. This is a read-only, auto-generated field.
|
accountId |
string (int64 format)
Account ID of this targeting template. This field, if left unset, will be auto-generated on insert and is read-only after insert.
|
subaccountId |
string (int64 format)
Subaccount ID of this targeting template. This field, if left unset, will be auto-generated on insert and is read-only after insert.
|
advertiserId |
string (int64 format)
Advertiser ID of this targeting template. This is a required field on insert and is read-only after insert.
|
advertiserIdDimensionValue |
object (DimensionValue)
Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
|
name |
string
Name of this targeting template. This field is required. It must be less than 256 characters long and unique within an advertiser.
|
geoTargeting |
object (GeoTargeting)
Geographical targeting criteria.
|
technologyTargeting |
object (TechnologyTargeting)
Technology platform targeting criteria.
|
dayPartTargeting |
object (DayPartTargeting)
Time and day targeting criteria.
|
keyValueTargetingExpression |
object (KeyValueTargetingExpression)
Key-value targeting criteria.
|
languageTargeting |
object (LanguageTargeting)
Language targeting criteria.
|
listTargetingExpression |
object (ListTargetingExpression)
Remarketing list targeting criteria.
|
kind |
string
Identifies what kind of resource this is. Value: the fixed string
"dfareporting#targetingTemplate"
.
|
Methods |
|
|
Gets one targeting template by ID. |
|
|
Inserts a new targeting template. |
|
|
Retrieves a list of targeting templates, optionally filtered. |
|
|
Updates an existing targeting template. |
|
|
Updates an existing targeting template. |
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 2024-10-16 UTC.
[null,null,["Last updated 2024-10-16 UTC."],[[["\u003cp\u003eTargetingTemplate objects store reusable targeting information for multiple ads, including geographic, technology, time, and language criteria.\u003c/p\u003e\n"],["\u003cp\u003eEach TargetingTemplate has a unique ID, name, and is associated with an advertiser and potentially a subaccount.\u003c/p\u003e\n"],["\u003cp\u003eYou can manage TargetingTemplates through methods like \u003ccode\u003eget\u003c/code\u003e, \u003ccode\u003einsert\u003c/code\u003e, \u003ccode\u003elist\u003c/code\u003e, \u003ccode\u003epatch\u003c/code\u003e, and \u003ccode\u003eupdate\u003c/code\u003e to retrieve, create, view, and modify them.\u003c/p\u003e\n"],["\u003cp\u003eThe JSON representation of a TargetingTemplate includes fields for various targeting options and system-generated identifiers.\u003c/p\u003e\n"],["\u003cp\u003eKey properties include \u003ccode\u003egeoTargeting\u003c/code\u003e, \u003ccode\u003etechnologyTargeting\u003c/code\u003e, \u003ccode\u003edayPartTargeting\u003c/code\u003e, \u003ccode\u003ekeyValueTargetingExpression\u003c/code\u003e, \u003ccode\u003elanguageTargeting\u003c/code\u003e, and \u003ccode\u003elistTargetingExpression\u003c/code\u003e for specifying targeting parameters.\u003c/p\u003e\n"]]],[],null,["# REST Resource: targetingTemplates\n\n- [Resource: TargetingTemplate](#TargetingTemplate)\n - [JSON representation](#TargetingTemplate.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: TargetingTemplate\n---------------------------\n\nContains properties of a targeting template. A targeting template encapsulates targeting information which can be reused across multiple ads.\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"id\": string, \"accountId\": string, \"subaccountId\": string, \"advertiserId\": string, \"advertiserIdDimensionValue\": { object (/doubleclick-advertisers/rest/v4/DimensionValue) }, \"name\": string, \"geoTargeting\": { object (/doubleclick-advertisers/rest/v4/GeoTargeting) }, \"technologyTargeting\": { object (/doubleclick-advertisers/rest/v4/TechnologyTargeting) }, \"dayPartTargeting\": { object (/doubleclick-advertisers/rest/v4/DayPartTargeting) }, \"keyValueTargetingExpression\": { object (/doubleclick-advertisers/rest/v4/KeyValueTargetingExpression) }, \"languageTargeting\": { object (/doubleclick-advertisers/rest/v4/LanguageTargeting) }, \"listTargetingExpression\": { object (/doubleclick-advertisers/rest/v4/ListTargetingExpression) }, \"kind\": string } ``` |\n\n| Fields ||\n|-------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `id` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` ID of this targeting template. This is a read-only, auto-generated field. |\n| `account``Id` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Account ID of this targeting template. This field, if left unset, will be auto-generated on insert and is read-only after insert. |\n| `subaccount``Id` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Subaccount ID of this targeting template. This field, if left unset, will be auto-generated on insert and is read-only after insert. |\n| `advertiser``Id` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Advertiser ID of this targeting template. This is a required field on insert and is read-only after insert. |\n| `advertiser``Id``Dimension``Value` | `object (`[DimensionValue](/doubleclick-advertisers/rest/v4/DimensionValue)`)` Dimension value for the ID of the advertiser. This is a read-only, auto-generated field. |\n| `name` | `string` Name of this targeting template. This field is required. It must be less than 256 characters long and unique within an advertiser. |\n| `geo``Targeting` | `object (`[GeoTargeting](/doubleclick-advertisers/rest/v4/GeoTargeting)`)` Geographical targeting criteria. |\n| `technology``Targeting` | `object (`[TechnologyTargeting](/doubleclick-advertisers/rest/v4/TechnologyTargeting)`)` Technology platform targeting criteria. |\n| `day``Part``Targeting` | `object (`[DayPartTargeting](/doubleclick-advertisers/rest/v4/DayPartTargeting)`)` Time and day targeting criteria. |\n| `key``Value``Targeting``Expression` | `object (`[KeyValueTargetingExpression](/doubleclick-advertisers/rest/v4/KeyValueTargetingExpression)`)` Key-value targeting criteria. |\n| `language``Targeting` | `object (`[LanguageTargeting](/doubleclick-advertisers/rest/v4/LanguageTargeting)`)` Language targeting criteria. |\n| `list``Targeting``Expression` | `object (`[ListTargetingExpression](/doubleclick-advertisers/rest/v4/ListTargetingExpression)`)` Remarketing list targeting criteria. |\n| `kind` | `string` Identifies what kind of resource this is. Value: the fixed string `\"dfareporting#targetingTemplate\"` . |\n\n| Methods ------- ||\n|--------------------------------------------------------------------------|---------------------------------------------------------------|\n| ### [get](/doubleclick-advertisers/rest/v4/targetingTemplates/get) | Gets one targeting template by ID. |\n| ### [insert](/doubleclick-advertisers/rest/v4/targetingTemplates/insert) | Inserts a new targeting template. |\n| ### [list](/doubleclick-advertisers/rest/v4/targetingTemplates/list) | Retrieves a list of targeting templates, optionally filtered. |\n| ### [patch](/doubleclick-advertisers/rest/v4/targetingTemplates/patch) | Updates an existing targeting template. |\n| ### [update](/doubleclick-advertisers/rest/v4/targetingTemplates/update) | Updates an existing targeting template. |"]]
