HTTP Endpoint
The Broadcast Ad-Request Service is available over a public HTTP/HTTPS endpoint:
//<broadcast-ad-server-host>/broadcast/ars?<query parameters>
Please contact Triton Digital Customer Support to obtain the correct host name to use for pre-production and production uses.
A complete example, using many of the available parameters, would look like this:
https://broadcast.live.streamtheworld.com/broadcast/ars?stid=12345&qty=35800&qtysourceid=1&qtysource=Nielsen
Parameters
This section describes the available query string parameters when using the Broadcast Ad-Request Service.
There are two types of request, as described below.
Auction request:
This is done when an auction should be executed on the exchange. Triton automatically selects PMP (Private Marketplace) deals that apply. Specific ad categories that can’t be played should be provided on the call to avoid Triton from returning an ad that will be dropped due to industry separation. This request is triggered when no deal ID is provided.
PG request:
This is done when a Programmatic Guaranteed (PG) deal is about to air. Triton reaches out to the proper demand partner (and only that partner) for the deal. This request is triggered when a deal ID is provided.
You should only send a query parameter if you specifically want to pass a value for that parameter. If you do not want to pass a value, do not send the query parameter.
Parameters should be provided in the query string of the endpoint URI.
Name | Description | Format |
|---|---|---|
stid | Triton ID of the placement station. This parameter is required. | Integer |
ext2_stid | External ID of the station. This parameter is required if | String |
qty | Number of users listening to the content where ad will be played, based on audience measurement. This parameter is required. | Float |
qty-type | The source type of the quantity measurement. This parameter is required. | Integer (enum) 1: Measurement Vendor Provided 2: Publisher Provided |
qty-vendor | The business domain name of the measurement vendor providing the quantity measurement (the business domain is the next level label after the effective top level domain) (e.g. “nielsen.com”) This parameter is required. | String |
deal-id | ID of an existing PG deal for which the ad is requested. If provided, the request will be limited to the DSP and buyer specified in the deal. If not provided, the request triggers an auction. | String |
excluded-iab-categories | List of ad categories NOT allowed for the requested ad. The current taxonomy used is the IAB Content Taxonomy v1. | Comma-separated list of codes (strings). |