Method: dynamicTargetingKeys.insert

AI-generated Key Takeaways

• Inserts a new dynamic targeting key, which needs to be created at the advertiser level before assigning it to ads, creatives, or placements.

• There's a limit of 1000 keys per advertiser and a maximum of 20 keys assignable per ad, creative, or placement.

• The API request uses the POST method and requires the dfatrafficking OAuth scope.

• The request body should contain an instance of DynamicTargetingKey for creating the new key.

• A successful response will return the newly created DynamicTargetingKey instance.

• HTTP request
• Path parameters
• Request body
• Response body
• Authorization scopes
• Try it!

Inserts a new dynamic targeting key. Keys must be created at the advertiser level before being assigned to the advertiser's ads, creatives, or placements. There is a maximum of 1000 keys per advertiser, out of which a maximum of 20 keys can be assigned per ad, creative, or placement.

HTTP request

POST https://dfareporting.googleapis.com/dfareporting/v4/userprofiles/{profileId}/dynamicTargetingKeys

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
profileId	string (int64 format) User profile ID associated with this request.

Request body

The request body contains an instance of DynamicTargetingKey.

Response body

If successful, the response body contains a newly created instance of DynamicTargetingKey.

Authorization scopes

Requires the following OAuth scope:

• https://www.googleapis.com/auth/dfatrafficking