Q: What is my Exchange Id?
A: Exchange Id is assigned by DV3 during Auth Set up.
Q: What’s up with the Order and Product hierarchy?
A: This is mainly for publishers and advertisers to negotiate multiple deals and have them pushed as one negotiation object. It does has restrictions that all products under the order need to be of the same transaction type and pricing type.** It is perfectly OK to always do 1 order 1 product set up. **
Q: Is there a deal that is for ALL advertisers?
A: The deal sync api is for private deals. Please refer to Auction Package for Public deals.
Q: What happens if the deal has no end date? Should we just include a really far away date like 12/31/9999?
A: We require an end date so yes some date in the future should work fine. Max allowed right now is 12/31/2030. End dates can be updated in the future.
Q: Does dimensionCreativeConfig field allow for multiple sizes?
A: Yes. But only a single creative type is allowed.
Q: Do you accept auctionPricing for reserved transactions?
A: No. Reservation deals support fixed price.
Q: Is duration required for video PG deals?
A: No, if left unset, it will be populated as “ANY‘ duration.
Q: Do any of “Order” statuses cause a deal to automatically stop transacting? E.g. Orders for Guaranteed Deals set to Pending, or any other order set to pending, archived, canceled or paused?
A: No, the Order is purely a negotiation object. It does not get propagated until Advertiser “Accept” the Order.
Q: What happens to an already accepted Deal if Exchange sends an update call?
A: The deal continues serving as old terms. When the user accepts, the deal gets updated to the updated term.
Q: If the seller changes the deal term, such as increasing the fixed CPM, and we push an update to you. Will the deal continue to serve before it gets accepted?
A: Assuming the CPM is already changed on the Exchange side, and reflected on the bid request.
- For reservation deals, the deal will not be spent until re-acceptance. Because line items are generated based on Deal terms, and the deal term updates at this point are still in the Negotiation stage and has not been accepted by advertisers.
- For non reservation deals, this all depends on the line item that is targeting the deal. If the bid request can be matched by line items targeting this deal, it will continue to serve.
Q: Can we re-use deal id across multiple deals?
A: No. ExternalDealId must be unique across all Products.
Q: Can a deal have multiple partners?
A: If you want to have a deal associated with multiple partners send your deal to a Central Partner.
Q: Can the partner id associated to a deal id change after a deal has been created?
A: No, the partner cannot change once an Order has been created.
Q: Do you support multi publisher names in Order?
A: The name field is a string and it is uses for FYI purpose for advertiser. You can multi-publisher name with comma separation, or can simply say “Multi publishers from Exchange X”.
Q: What is the difference between “Cancelled” and “Archived” Order status?
A: Users can Archive and Unarchive. Once cancelled, the user cannot “uncancel”.
Q: What are "Instant Deals"? Since there are many attributes only required for Instant Deals
A: Instant Deals are a separate integration effort using the Seller API endpoint, please ignore the instant deal scenario specific attributes. It is not related to the Deal Sync workflow.
Q: I am getting a Bad Request error when Creating Order/Product.
A: There could be many causes, but below are a few common ones.
- Follow the reference guide and see if you have missed some required field.
- External_deal_id must be unique across all Products.
- Reservation deal does not support auction price
If none of the above, try using a http client, such as Postman to see if the response contains useful information.
Contact DV3 Seller API support team if none of the above helps.