Method: buyers.finalizedDeals.addCreative
Add creative to be used in the bidding process for a finalized deal. For programmatic guaranteed deals, it's recommended that you associate at least one approved creative with the deal before calling finalizedDeals.setReadyToServe, to help reduce the number of bid responses filtered because they don't contain approved creatives. Creatives successfully added to a deal can be found in the Realtime-bidding Creatives API [creative.deal_ids][google.ads.realtimebidding.v1.Creative.deal_ids]. This method only applies to programmatic guaranteed deals. Maximum number of 1000 creatives can be added to a finalized deal.
HTTP request
POST https://authorizedbuyersmarketplace.googleapis.com/v1alpha/{deal=buyers/*/finalizedDeals/*}:addCreative
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters |
deal |
string
Required. Name of the finalized deal in the format of: buyers/{accountId}/finalizedDeals/{dealId}
|
Request body
The request body contains data with the following structure:
| JSON representation |
{
"creative": string
} |
| Fields |
creative |
string
Name of the creative to add to the finalized deal, in the format buyers/{buyerAccountId}/creatives/{creativeId}. See [creative.name][google.ads.realtimebidding.v1.Creative.name].
|
Response body
If successful, the response body contains an instance of FinalizedDeal.
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/authorized-buyers-marketplace
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-09-18 UTC.
[null,null,["Last updated 2024-09-18 UTC."],[[["Add creatives to finalized deals to reduce filtered bid responses and enhance programmatic guaranteed deal performance."],["Creatives must be associated with the deal before finalization to ensure seamless integration."],["A maximum of 1000 creatives can be added to a finalized deal, providing flexibility for campaign customization."],["Utilize the Realtime-bidding Creatives API to manage and track creatives associated with specific deals for efficient campaign management."],["Secure authorization is necessary, requiring the 'https://www.googleapis.com/auth/authorized-buyers-marketplace' scope for access and control."]]],["Key actions include adding a creative to a finalized programmatic guaranteed deal using a POST request to the specified URL. The request requires the deal's name as a path parameter (`buyers/*/finalizedDeals/*`) and the creative's name in the request body (`buyers/{buyerAccountId}/creatives/{creativeId}`). Successful requests return an instance of `FinalizedDeal`. Up to 1000 creatives can be added. This requires the authorization scope to access marketplace to add the creative.\n"]]
