[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2025-07-25 (世界標準時間)。"],[[["\u003cp\u003eA Deal is a segment of inventory, terms, and targeting details for serving ads, used within Proposals to negotiate with publishers.\u003c/p\u003e\n"],["\u003cp\u003eThere are three Deal types: Private Auction (publisher-initiated), Preferred Deals, and Programmatic Guaranteed Deals.\u003c/p\u003e\n"],["\u003cp\u003eThe Deal lifecycle includes creating proposals, negotiating, finalizing, serving, renegotiating (for Preferred and Programmatic Guaranteed Deals only), and ending serving.\u003c/p\u003e\n"],["\u003cp\u003eBuyers can manage finalized deals, pause/resume serving for Preferred and Programmatic Guaranteed Deals, and renegotiate terms for these deal types.\u003c/p\u003e\n"],["\u003cp\u003ePrivate Auction Deals require manual review and acceptance by the buyer, while Preferred and Programmatic Guaranteed Deals involve a negotiation process.\u003c/p\u003e\n"]]],[],null,["# Deals\n\nA [`Deal`](/authorized-buyers/apis/marketplace/reference/rest/v1/buyers.proposals.deals#resource:-deal)\nrepresents a segment of inventory, terms, targeting details, and other\ninformation for serving ads. You can include one or more deals in a\n[`Proposal`](/authorized-buyers/apis/guides/marketplace/proposals) to\nnegotiate with publishers.\n\nDeal types\n----------\n\nThere are three types of deals you can use in negotiations:\n\n- [Private Auction Deals](//support.google.com/authorizedbuyers/answer/2839853) (publisher-initiated)\n- [Preferred Deals](//support.google.com/authorizedbuyers/answer/2604595)\n- [Programmatic Guaranteed Deals](//support.google.com/authorizedbuyers/answer/7174589)\n\nLife cycle\n----------\n\nThis section explains the different stages in the life cycle of a deal.\n\n### Create proposals\n\nBuyers can start negotiations by [sending a request for proposal\n(RFP)](/authorized-buyers/apis/guides/marketplace/send-proposals), where the\ndeal type is specified by `preferredDealTerms` or `programmaticGuaranteedTerms`\nin the request body. These deal types require the `flightStartTime`\nand `flightEndTime` fields.\n\nTo send a proposal, you must refer to a publisher by their\n[`PublisherProfile`](/authorized-buyers/apis/marketplace/reference/rest/v1/buyers.publisherProfiles#resource:-publisherprofile).\n\n### Negotiate with publishers\n\nDuring this stage, you do the following:\n\n- Update the proposal and its corresponding deals.\n- Poll for updates from the publisher.\n- Decide when to accept the terms of the proposal.\n\nYou can [patch a proposal](/authorized-buyers/apis/guides/marketplace/edit-proposals#patch)\nor [deal](/authorized-buyers/apis/guides/marketplace/update-deals#patch)\nto make changes. Updating a proposal increments `proposalRevision`.\n| **Note:** Buyers can't update the `Proposal` or `Deal` resources for private auction deals. You must review the publisher's proposal and decide whether you want to accept it as is.\n\n### Cancel negotiation\n\nWhat happens when you [cancel\nnegotiation](/authorized-buyers/apis/guides/marketplace/manage-proposals#cancel_negotiation)\nfor a proposal and its corresponding deals depends on whether the proposal has\na finalized `proposalRevision`.\n\nIf no finalized `proposalRevision` exists, the proposal's state is `TERMINATED`,\nand the proposal is no longer available to negotiate. In that case, you must\n[send a new proposal](/authorized-buyers/apis/guides/marketplace/send-proposals)\nto resume negotiating with the publisher.\n\nOtherwise, the proposal and its deals revert to the last finalized\n`proposalRevision`.\n\nYou can't cancel proposals for private auction deals with the Marketplace API.\nYou can archive private auction deals in the Authorized Buyers Marketplace UI.\n\n### Finalize deals\n\nAfter both parties\n[accept](/authorized-buyers/apis/guides/marketplace/manage-proposals#accept_proposal)\na proposal, the deals in the proposal are considered finalized. You can use the\n[`buyers.finalizedDeals`](/authorized-buyers/apis/marketplace/reference/rest/v1/buyers.finalizedDeals)\nresource to manage your finalized deals.\n\nIf a proposal is modified before both parties accept, both parties have to\naccept the new revision before the deals in the proposal are considered\nfinalized.\n\n### Serve finalized deals\n\nAfter a deal is finalized, it appears in bid requests based on the time range\nspecified by `flightStartTime` and `flightEndTime`. If no flight times are\nspecified (only possible for private auction deals), the deal serves\nindefinitely.\n\nDeals begin serving as soon as possible after they're finalized. Serving\nusually begins at the specified `flightStartTime`.\n\nIf you want to opt out of the default serving behavior and manually indicate\nwhen you're ready to start receiving bid requests, ask your Technical Account\nManager to enable you to manually [set deals as ready to\nserve](/authorized-buyers/apis/marketplace/reference/rest/v1/buyers.finalizedDeals/setReadyToServe).\n\nGoogle recommends that you manually begin serving for programmatic guaranteed\ndeals if you need to prepare creatives for these deals so you can ensure that\nthe [creatives are\nreviewed](/authorized-buyers/apis/guides/rtb-api/buyer-creatives#submit_creatives_for_review)\nand ready to be submitted in bids for Real-time bidding before the deals begin\nto serve. After you [add the\ncreatives](/authorized-buyers/apis/guides/marketplace/add-creatives-to-deals)\nyou want to place with a programmatic guaranteed deal, we recommend that you\nverify the creatives associated with the deal before you begin serving.\n\nIn bid requests, deals can be represented by either of the following fields,\ndepending on the protocol:\n\n- **Google** : `BidRequest.adslot[].matching_ad_data[].direct_deal[].direct_deal_id`\n- **OpenRTB** : `BidRequest.imp[].pmp.deals[].id`\n\nYou can [pause](/authorized-buyers/apis/guides/marketplace/serve-deals#pause)\nand [resume](/authorized-buyers/apis/guides/marketplace/serve-deals#resume)\npreferred deals and programmatic guaranteed deals after\nthey start serving. Pausing a deal causes you to stop receiving bid requests for\nthat deal until you resume the deal.\n\nOnly the publisher can pause private auction deals.\n| **Warning:** Even if a deal is paused, you're still required to fulfill terms of the deal that you accepted, such as a programmatic guaranteed deal's `guaranteedLooks` and `minimumDailyLooks`.\n\n### Start renegotiation\n\nBuyers and publishers can start renegotiation for finalized preferred deals\nand programmatic guaranteed deals. You can begin renegotiation by [modifying\na proposal](/authorized-buyers/apis/guides/marketplace/edit-proposals#patch) or\nits [deals](/authorized-buyers/apis/guides/marketplace/update-deals#patch_a_deal).\nYou can then renegotiate until both parties [accept](/authorized-buyers/apis/guides/marketplace/manage-proposals#accept_proposal)\nthe changes, or the renegotiation is\n[canceled](/authorized-buyers/apis/guides/marketplace/manage-proposals#cancel_negotiation).\n\nIf accepted, the proposal's revised deals replace the existing finalized deals\nand serve based on the updated terms.\n\nIf canceled, the proposal and its deals revert to the last finalized\n`proposalRevision`.\n\nDuring renegotiation, previously finalized deals continue to serve. You can\ncontinue to view your [finalized\ndeals](/authorized-buyers/apis/guides/marketplace/view-finalized-deals) and\ntheir [latest proposal\nrevision](/authorized-buyers/apis/marketplace/reference/rest/v1/buyers.proposals.deals#resource:-deal).\n\nRenegotiation isn't supported for private auction deals.\n\n### End serving\n\nFinalized deals for all supported deal types have their `dealServingStatus`\nset to `ENDED` after the deal stops serving. Here are some sample conditions\nthat might end a deal's serving period:\n\n- The time period set in `flightStartTime` and `flightEndTime` passes. This is common for preferred deals or programmatic guaranteed deals, because these fields are required.\n- The programmatic guaranteed deal's `impressionCap` has been reached.\n\nPrivate auction deals that don't define a `flightStartTime` and `flightEndTime`\ncan serve indefinitely."]]