Curation lets buyers create deals that target data segments that curation
partners create, or target curated inventory in packages that curation partners
or media planners create. These deal IDs appear in bid requests
sent to bidders in Real-time Bidding. As a curation partner, you are
compensated with a set fee when the winning bidder uses these IDs to fill an
impression.

> [!WARNING]
> **Beta:** Access to curation is only available by invitation.

## Concepts

### Data segments

Data segments are a group of impressions that audience signals or contextual
signals describe, and that you assign an ID and curation fee. The curation fees
for data segments targeted in deals or packages are included in their deal price
in Real-time Bidding bid requests, and the fees are collected if the deal or
package is used in the winning Real-time Bidding bid response.

After creating a data segment, you must participate in [Real-time
Curation](https://developers.google.com/authorized-buyers/curation/get-started/start#real-time_curation) to
identify the data segments relevant for a given impression.

Data segments are targeted by media planners in Auction Packages,
Private Auctions or Preferred Deals. Curators can create curated Auction
Packages and let media planners subscribe to them. Curators can
also share their data segments with media planners to let them to
create deals or packages targeting the data segment.

After initial configuration of your curation account, you can access portions of
the Authorized Buyers Marketplace [API](https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest)
and [UI](https://realtimebidding.google.com/#marketplace/auction_package/list)
used to facilitate curation--for example, learn how to [manage data segments
programmatically](https://developers.google.com/authorized-buyers/curation/apis/marketplace/overview).

#### Workflow for curator-owned Auction Packages

You can create an Auction Package targeting one or more of your data segments.
The deal IDs of these packages appear in Real-time Bidding bid requests for
buyers that subscribe to them.

![Data segment and curator-owned Auction Package setup.](https://developers.google.com/static/authorized-buyers/curation/images/curator-ap-datasegment-config.png)

#### Workflow for media planner-owned Auction Packages

You can share your data segment with media planners, who can then
create Auction Packages targeting data segments from one or more curators. Their
deal IDs will appear in Real-time Bidding bid requests for buyers that subscribe
to them.

![Data segment and media planner-owned Auction Package setup.](https://developers.google.com/static/authorized-buyers/curation/images/mediaplanner-ap-datasegment-config.png)

#### Workflow for media planner-owned deals

You can share your data segment with media planners, who can then
target data segments from one or more curators in the negotiation phase of
[Private Auction](https://support.google.com/authorizedbuyers/answer/2839853?sjid=4019390851748150426-NA)
or [Preferred Deals](https://support.google.com/authorizedbuyers/answer/2604595?sjid=4019390851748150426-NA).
When these deals are finalized, the deal IDs appear in bid requests for the
media planner.

![Data segment and media planner-owned deal setup.](https://developers.google.com/static/authorized-buyers/curation/images/mediaplanner-deal-datasegment-config.png)

### Real-time curation

Real-time curation is a server-to-server API enabling curators to specify to
Google which of their data segments are applicable for a given ad opportunity.
Before a bid request is sent to bidders, Google sends your curation endpoint a
segment request describing the impression, which you can respond to with one or
more data segments. Deals or packages media planners previously
created that target your specified data segments have their deal IDs included in
Real-time Bidding bid requests sent to bidders. If a deal or package targeting
your data segment is used in the winning bid, you are compensated by the fee
amount you configured for that data segment.

![Real-time Curation interaction with Real-time Bidding workflow.](https://developers.google.com/static/authorized-buyers/curation/images/realtime-curation.png)

#### Protocol

Real-time curation uses a JSON protocol that describes the ad opportunity with a
[SegmentRequest](https://developers.google.com/authorized-buyers/curation/realtime-curation/reference#segreq)
object. You can identify applicable data segments by responding with the
[SegmentResponse](https://developers.google.com/authorized-buyers/curation/realtime-curation/reference#segresp)
object.

#### Configure Real-time Curation endpoints

To participate in Real-time Curation, you must create an endpoint that can
receive segment requests sent by Google, and Google must receive your segment
response within 50ms. Segment responses received after 50 ms don't
contribute to serving the impression.

To configure your Real-time Curation endpoint, provide the following to your
Technical Account Manager:

- The endpoint URL.
- Maximum global QPS that the endpoint receives.
- Optionally identify the following targeting information describing inventory you want sent to this endpoint:
  - A list of user countries.
  - Domain / App IDs.
- Identify whether the endpoint receives contextual signals or audience signals.
  - If you select audience signals, you must specify the set of audience signals you are interested in. Segment requests are only sent for impressions where these are available to you.

## Next Steps

- [Manage data segments](https://developers.google.com/authorized-buyers/curation/apis/marketplace/datasegments/create-modify): Learn how to create and manage your data segments.
- [Real-time Curation protocol reference](https://developers.google.com/authorized-buyers/curation/realtime-curation/reference): Learn how the requests and responses used in Real-time Curation are structured.
- [Reduce latency for your Real-time Curation endpoint](https://developers.google.com/authorized-buyers/curation/realtime-curation/latency-server-location): Learn about latency and recommended server locations for your endpoint.
- [Parse Real-time Curation requests](https://developers.google.com/authorized-buyers/curation/realtime-curation/parse-request): Learn how to parse Real-time Curation requests.
- [Build Real-time Curation responses](https://developers.google.com/authorized-buyers/curation/realtime-curation/build-response): Learn how to build Real-time Curation responses.