REST Resource: dynamicTargetingKeys
Stay organized with collections
Save and categorize content based on your preferences.
Resource: DynamicTargetingKey
Contains properties of a dynamic targeting key. Dynamic targeting keys are unique, user-friendly labels, created at the advertiser level in DCM, that can be assigned to ads, creatives, and placements and used for targeting with Studio dynamic creatives. Use these labels instead of numeric Campaign Manager IDs (such as placement IDs) to save time and avoid errors in your dynamic feeds.
JSON representation |
{
"name": string,
"objectType": enum (ObjectType ),
"objectId": string,
"kind": string
} |
Fields |
name |
string
Name of this dynamic targeting key. This is a required field. Must be less than 256 characters long and cannot contain commas. All characters are converted to lowercase.
|
objectType |
enum (ObjectType )
Type of the object of this dynamic targeting key. This is a required field.
|
objectId |
string (int64 format)
ID of the object of this dynamic targeting key. This is a required field.
|
kind |
string
Identifies what kind of resource this is. Value: the fixed string
"dfareporting#dynamicTargetingKey"
.
|
ObjectType
Enums |
OBJECT_ADVERTISER |
|
OBJECT_AD |
|
OBJECT_CREATIVE |
|
OBJECT_PLACEMENT |
|
Methods |
|
Deletes an existing dynamic targeting key. |
|
Inserts a new dynamic targeting key. |
|
Retrieves a list of dynamic targeting keys. |
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\u003eDynamic Targeting Keys are user-friendly labels used for targeting with Studio dynamic creatives, saving time and reducing errors by replacing numeric Campaign Manager IDs.\u003c/p\u003e\n"],["\u003cp\u003eThese keys are created at the advertiser level in DCM and can be assigned to ads, creatives, and placements.\u003c/p\u003e\n"],["\u003cp\u003eThey have properties like name, object type (e.g., ad, creative, placement), object ID, and a fixed kind value.\u003c/p\u003e\n"],["\u003cp\u003eDynamic Targeting Keys can be managed through methods to delete, insert, and retrieve a list of them.\u003c/p\u003e\n"]]],[],null,["# REST Resource: dynamicTargetingKeys\n\n- [Resource: DynamicTargetingKey](#DynamicTargetingKey)\n - [JSON representation](#DynamicTargetingKey.SCHEMA_REPRESENTATION)\n- [ObjectType](#ObjectType)\n- [Methods](#METHODS_SUMMARY)\n\nResource: DynamicTargetingKey\n-----------------------------\n\nContains properties of a [dynamic targeting key](https://support.google.com/dcm/answer/6302035). Dynamic targeting keys are unique, user-friendly labels, created at the advertiser level in DCM, that can be assigned to ads, creatives, and placements and used for targeting with Studio dynamic creatives. Use these labels instead of numeric Campaign Manager IDs (such as placement IDs) to save time and avoid errors in your dynamic feeds.\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"objectType\": enum (/doubleclick-advertisers/rest/v4/dynamicTargetingKeys#ObjectType), \"objectId\": string, \"kind\": string } ``` |\n\n| Fields ||\n|----------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Name of this dynamic targeting key. This is a required field. Must be less than 256 characters long and cannot contain commas. All characters are converted to lowercase. |\n| `object``Type` | `enum (`[ObjectType](/doubleclick-advertisers/rest/v4/dynamicTargetingKeys#ObjectType)`)` Type of the object of this dynamic targeting key. This is a required field. |\n| `object``Id` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` ID of the object of this dynamic targeting key. This is a required field. |\n| `kind` | `string` Identifies what kind of resource this is. Value: the fixed string `\"dfareporting#dynamicTargetingKey\"` . |\n\nObjectType\n----------\n\n| Enums ||\n|---------------------|---|\n| `OBJECT_ADVERTISER` | |\n| `OBJECT_AD` | |\n| `OBJECT_CREATIVE` | |\n| `OBJECT_PLACEMENT` | |\n\n| Methods ------- ||\n|----------------------------------------------------------------------------|---------------------------------------------|\n| ### [delete](/doubleclick-advertisers/rest/v4/dynamicTargetingKeys/delete) | Deletes an existing dynamic targeting key. |\n| ### [insert](/doubleclick-advertisers/rest/v4/dynamicTargetingKeys/insert) | Inserts a new dynamic targeting key. |\n| ### [list](/doubleclick-advertisers/rest/v4/dynamicTargetingKeys/list) | Retrieves a list of dynamic targeting keys. |"]]