Stay organized with collections
Save and categorize content based on your preferences.
Overview
Deal sync API is leveraging DV3 Negotiation pipeline. What the API really did is manage an one way negotiation, in which advertisers can only accept/archive, but cannot propose changes.
Order
Order is the top level negotiation object, it can contain single or multiple products. The order contains the partner id, which permissions the DV3 Partner to the Order in DV3 UI.
Product
Product is meant to represent a deal in its ‘proposed’ stage. Each product has one to one mapping with a deal by deal id. An order can have one or more products, and is meant to represent the set of products being proposed together. Sellers cannot directly create deals which are the executable objects in DV360, and instead must create Order, Product in DV360.
Inventory Source
Inventory source is the actual “Deal”. The deal gets identified by external_deal_id during transaction time between buy-side and sell-side platforms. Inventory source contains agreed terms between advertisers and publishers, such as price, time and committed impressions(for reservation deals). Inventory source is automatically generated based on corresponding Product when advertiser “Accept” the Negotiation pushed from Exchange.
Line Item
Line items are the actual bidding object. Line items control which ads are served, when they are served, and to whom they are served. This is dictated by numerous settings configured at the line item level and prescribed by parent resources. Biddings on an Inventory Source are executed by the line items that target it. Line items are managed by Advertisers, and are not part of the Seller API offering.
References
Guaranteed Deals
Non-Guaranteed Deals
Line Items
Negotiations
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.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-09-18 UTC."],[[["Deal Sync API leverages DV3 Negotiation pipeline for a one-way negotiation where advertisers can only accept or archive proposed deals."],["An Order can contain one or more Products, representing a deal in its 'proposed' stage before becoming an executable 'Inventory Source' (Deal) in DV360."],["Inventory Sources, generated from Products upon advertiser acceptance, reflect agreed-upon terms between advertisers and publishers including price, time, and committed impressions."],["Line Items are managed by advertisers and dictate ad serving parameters, targeting Inventory Sources for bidding and execution within DV360."]]],["The Deal Sync API utilizes the DV3 Negotiation pipeline for one-way negotiations where advertisers can only accept or archive. Orders, containing one or more Products, represent proposed deals. Products map one-to-one with a deal, identified by a deal ID. Inventory Sources, representing the actual deal with agreed terms, are automatically generated upon advertiser acceptance of a Product. Line items, controlled by advertisers, bid on Inventory Sources. Sellers create Orders and Products in DV360, but not deals.\n"]]