Rayn relies on the Seller Defined Audiences (SDA) standard to propagate data downstream. SDA uses a number of existing, widely adopted specifications that have been updated to work together in new ways. Notably, Prebid and OpenRTB 2.6 community extensions. Rayn can be configured to pass context categories and cohorts into the bid stream. This article takes you through the details.
Rayn Real Time Data (RTD) Prebid Sub Module
Install the Rayn RTD module in your prebid instance in order to ensure a smooth handoff. Documentation for the Rayn RTD Module can be found here.
Rayn RTD Prebid Module requires prebid version is >9.2.
Install the RTD Module
Step 1: Prepare the base Prebid file
Compile the Rayn RTD module (raynRtdProvider) into your Prebid build along with the parent RTD Module (rtdModule). From the command line, run gulp build gulp build --modules=rtdModule,raynRtdProvider
Step 2: Set configuration
Enable Rayn RTD Module using pbjs.setConfig. The RTD module enables configuration for which taxonomies should be pushed and up until what tier. By default the module will push the data globally to all bidders unless specified otherwise. Creating the config for prebid can be done easily from the Rayn Console.
Go to the Connection you wish to use, navigate to the Integrations tab. Enable Prebid and click edit.
See the prebid RTD module parameter description for more detailed information of the configuration parameters.
Segments and Taxonomy
As part of the Seller Defined Audiences standard the IAB offers standard content and audience taxonomies for categorizing sites and users. Prebid supports defining these values as first party data in site.content.data or user.data as shown in examples below. Rayn will automatically update the values in segtax to ensure buyers will always have the most up to date targeting data.
user: {
data: [{
name: "dataprovider.com", // who resolved the segments
ext: { segtax: 4 }, // taxonomy used to encode the segments
segment: [
{ id: "1" }
]
}],
}The segtax extension identifies the specific taxonomy used to determine the provided segments. This model supports multiple taxonomies. Rayn uses the following taxonomies and segtax values:
Segtax ID | Taxonomy Type | Version | Description |
4 | Audience | 1.1 | |
6 | Content | 2.2 | |
7 | Content | 3.0 |
Supplying OpenRTB with context categories
When enabled, the Rayn tag will automatically pass context data (as soon as its available) in OpenRTB as shown below. The OpenRTB content object describes specific content information, and is used for targeting by Demand Side Platforms (DSP). For website ads, the content object should be defined in ortb2.site.content, for non-browser ads, it should be defined in ortb2.app.content.
pbjs.setConfig({
ortb2: {
site: {
content: {
cat: ["IAB1-3", "IAB1-4", "IAB2-5"] }
}
}
});