Auction packages
Stay organized with collections
Save and categorize content based on your preferences.
You can use the
auctionPackages
resource to do the following:
You can’t use the Marketplace API to create new auction packages, or view their
targeting details. You can create auction packages and configure targeting
in the Authorized Buyers Marketplace
UI.
When you subscribe a buyer or client to an auction package, you receive
Real-time Bidding bid requests based on a combination of your pretargeting
configurations,
and the targeting details in the auction package.
Unlike pretargeting configurations, auction packages don't impact the
number of bid requests you receive. Bid requests for auction packages are a
subset of the total requests you receive based on your pretargeting
configuration.
In bid requests, auction packages are identified similarly to deals with either
of the following fields:
- Google:
BidRequest.adslot[].matching_ad_data[].direct_deal[].direct_deal_id
- OpenRTB:
BidRequest.imp[].pmp.deals[].id
The preceding fields are populated with the auction package resource ID found
in the auction package's name.
Auction packages are different from
deals in the following ways:
- Auction packages are targeting that can be shared between buyers and clients.
- Auction packages don’t involve negotiation between a buyer and publisher,
and are in effect after a buyer or client subscribes to them.
- Bids for auction packages directly compete on the open auction.
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."],[[["\u003cp\u003eThe \u003ccode\u003eauctionPackages\u003c/code\u003e resource allows you to view subscribed auction packages, subscribe buyers and clients, and unsubscribe buyers and clients.\u003c/p\u003e\n"],["\u003cp\u003eYou cannot create new auction packages or view their targeting details using the Marketplace API; this must be done in the Authorized Buyers Marketplace UI.\u003c/p\u003e\n"],["\u003cp\u003eSubscribing to an auction package delivers Real-time Bidding bid requests based on your pretargeting configurations and the package's targeting, without impacting the total number of bid requests.\u003c/p\u003e\n"],["\u003cp\u003eAuction packages, identified in bid requests by specific fields containing their resource ID, act as shared targeting between buyers and clients, take effect upon subscription, and involve open auction bidding, unlike deals.\u003c/p\u003e\n"],["\u003cp\u003eAuction packages differ from deals as they are shareable targeting, have no negotiation involved and take effect immediately upon subscription, with bids directly competing in the open auction.\u003c/p\u003e\n"]]],[],null,["# Auction packages\n\nYou can use the\n[`auctionPackages`](/authorized-buyers/apis/marketplace/reference/rest/v1/buyers.auctionPackages)\nresource to do the following:\n\n- [View subscribed auction packages](/authorized-buyers/apis/guides/marketplace/view-auction-packages).\n- [Subscribe buyers and clients](/authorized-buyers/apis/guides/marketplace/subscribe-auction-packages).\n- [Unsubscribe buyers and clients](/authorized-buyers/apis/guides/marketplace/unsubscribe-auction-packages).\n\nYou can't use the Marketplace API to create new auction packages, or view their\ntargeting details. You can create auction packages and configure targeting\nin the [Authorized Buyers Marketplace\nUI](//realtimebidding.google.com/#MARKETPLACE/MarketplaceDiscoveryPlace:marketplaceDiscovery).\n\nWhen you subscribe a buyer or client to an auction package, you receive\nReal-time Bidding bid requests based on a combination of your [pretargeting\nconfigurations](/authorized-buyers/apis/guides/rtb-api/pretargeting-configs),\nand the targeting details in the auction package.\n\nUnlike pretargeting configurations, auction packages don't impact the\nnumber of bid requests you receive. Bid requests for auction packages are a\nsubset of the total requests you receive based on your pretargeting\nconfiguration.\n\nIn bid requests, auction packages are identified similarly to deals with either\nof the following fields:\n\n- **Google** : `BidRequest.adslot[].matching_ad_data[].direct_deal[].direct_deal_id`\n- **OpenRTB** : `BidRequest.imp[].pmp.deals[].id`\n\nThe preceding fields are populated with the auction package resource ID found\nin the auction package's `name`.\n\nAuction packages are different from\n[deals](/authorized-buyers/apis/guides/marketplace/deals) in the following ways:\n\n- Auction packages are targeting that can be shared between buyers and clients.\n- Auction packages don't involve negotiation between a buyer and publisher, and are in effect after a buyer or client subscribes to them.\n- Bids for auction packages directly compete on the open auction."]]
