Skip to content

Latest commit

 

History

History
118 lines (95 loc) · 6.5 KB

raynRtdProvider.md

File metadata and controls

118 lines (95 loc) · 6.5 KB
layout title display_name description page_type module_type module_code enable_download vendor_specific sidebarType
page_v2
Rayn RTD Provider
Rayn Real Time Data Module
Rayn Real Time Data module appends privacy preserving enhanced contextual categories and audiences. Moments matter.
module
rtd
raynRtdProvider
true
true
1

Rayn Real-time Data Submodule

Rayn is a privacy preserving, data platform. We turn content into context, into audiences. For Personalisation, Monetisation and Insights. This module reads contextual categories and audience cohorts from RaynJS (via localStorage) and passes them to the bid-stream.

Integration

To install the module, follow these instructions:

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. Example is provided in the Configuration section. See the Parameter Description for more detailed information of the configuration parameters.

Configuration

This module is configured as part of the realTimeData.dataProviders object.

Example format:

pbjs.setConfig(
    // ...
    realTimeData: {
        auctionDelay: 1000,
        dataProviders: [
            {
                name: "rayn",
                waitForIt: true,
                params: {
                    bidders: ["appnexus", "pubmatic"],
                    integration: {
                        iabAudienceCategories: {
                            v1_1: {
                                tier: 6,
                                enabled: true,
                            },
                        },
                        iabContentCategories: {
                            v3_0: {
                                tier: 4,
                                enabled: true,
                            },
                            v2_2: {
                                tier: 4,
                                enabled: true,
                            },
                        },
                    }
                }
            }
        ]
    }
    // ...
}

Parameter Description

The parameters below provide configurability for general behaviours of the RTD submodule, as well as enabling settings for specific use cases mentioned above (e.g. tiers and bidders).

Parameters

{: .table .table-bordered .table-striped }

Name Type Description Notes
name String RTD sub module name Always "rayn"
waitForIt Boolean Required to ensure that the auction is delayed for the module to respond Optional. Defaults to false but recommended to true
params Object
params.bidders Array Bidders with which to share context and segment information Optional. In case no bidder is specified Rayn will append data for all bidders
params.integration Object Controls which IAB taxonomy should be used and up to which category tier Optional. In case it's not defined, all supported IAB taxonomies and all category tiers will be used
params.integration.iabAudienceCategories Object
params.integration.iabAudienceCategories.v1_1 Object
params.integration.iabAudienceCategories.v1_1.enabled Boolean Controls if IAB Audience Taxonomy v1.1 will be used Optional. Enabled by default
params.integration.iabAudienceCategories.v1_1.tier Number Controls up to which IAB Audience Taxonomy v1.1 Category tier will be used Optional. Tier 6 by default
params.integration.iabContentCategories Object
params.integration.iabContentCategories.v3_0 Object
params.integration.iabContentCategories.v3_0.enabled Boolean Controls if IAB Content Taxonomy v3.0 will be used Optional. Enabled by default
params.integration.iabContentCategories.v3_0.tier Number Controls up to which IAB Content Taxonomy v3.0 Category tier will be used Optional. Tier 4 by default
params.integration.iabContentCategories.v2_2 Object
params.integration.iabContentCategories.v2_2.enabled Boolean Controls if IAB Content Taxonomy v2.2 will be used Optional. Enabled by default
params.integration.iabContentCategories.v2_2.tier Number Controls up to which IAB Content Taxonomy v2.2 Category tier will be used Optional. Tier 4 by default

Please note that raynRtdProvider should be integrated into the website along with RaynJS.

Testing

To view an example of the on page setup:

gulp serve-fast --modules=rtdModule,raynRtdProvider,appnexusBidAdapter

Then in your browser access: http://localhost:9999/integrationExamples/gpt/raynRtdProvider_example.html

Run the unit tests, just on the Rayn RTD module test file:

gulp test --file "test/spec/modules/raynRtdProvider_spec.js"

Support

If you require further assistance or are interested in discussing the module functionality please reach out to [email protected]. You are also able to find more examples and other integration routes on the Rayn documentation site.