REST Resource: dynamicTargetingKeys

  • Dynamic Targeting Keys are user-friendly labels used for targeting with Studio dynamic creatives, saving time and reducing errors by replacing numeric Campaign Manager IDs.

  • These keys are created at the advertiser level in DCM and can be assigned to ads, creatives, and placements.

  • They have properties like name, object type (e.g., ad, creative, placement), object ID, and a fixed kind value.

  • Dynamic Targeting Keys can be managed through methods to delete, insert, and retrieve a list of them.

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

delete

 Deletes an existing dynamic targeting key.

insert

 Inserts a new dynamic targeting key.

list

 Retrieves a list of dynamic targeting keys.