Rayn JS is the easiest way to integrate Rayn on a website. The module is designed for the efficient ingestion of website content, measurement of user behavior, and collecting data interactions on your webpage. For detailed information on Rayn JS functionalities, please refer to the Rayn JS documentation.
Setting Up Rayn for Web Connections Using Rayn JS
This article guides you through the process of setting up Rayn for Web connections utilizing Rayn JS. You can set up Rayn for Web in 2 steps:
❕Consent is Needed to work with Rayn
To work with Rayn JS, you need TCF consent for Vendor 1220.
Create a connection
How to get there
Click on Air in the left-hand menu. You will be presented with the Connections Overview.
Each Rayn JS configuration is represented as a connection in the connections overview. Click on New to create a new connection and select Rayn JS.
Step 1: Content ingestion
Rayn JS handles content ingestion to enable the processing of website content to contextual categories. This section allows you to instruct Rayn on what content to ingest and where.
Enter your domain
Enter the domain one which you want to run Rayn JS.
Select content
Select which elements on the page Rayn JS should ingest. By specifying the relevant content blocks and excluding elements like the menu you will get cleaner and more concise context categories per page. Learn more about how to use CSS Selectors for content ingestion.
Upon loading Rayn JS will perform a check whether selectors are present on the page. If the selectors are not found then Rayn JS will only respond with default categories.
Need more options regarding the content ingestion? After the initial set up you can edit your Rayn JS configuration and have more options.
Preview
To test whether you have added the right selectors you can enter a sample url and click Preview for Rayn to take a screenshot of that URL encircling the targeted content blocks.
Preview errors
Preview errors
If the preview function for content ingestion encounters any issue then it will return any of the following error messages:
Message: No selectors are configured. Getting content from default elements.
Case: Only top-level domains are entered (no additional content targeting is configured) and the website URL matches any of the entered domains Rayn will attempt to get page content from the default elements. The default elements are: 'main' and if 'main' doesn't exist then 'body'.
Result: Content from either the main or the body will be ingested. Note: These selectors may result in degradation in contextualization. It is advisable to be more selective in content ingestion.
Message: The URL does not match any of the configured top-level domains.
Case:Only top-level domains are entered (no additional content targeting is configured) and the website URL doesn’t match any of the entered domains.
Result:No content will be ingested.
Message: This URL doesn't match any of the configured selectors.
Case:Content selectors are configured and the website URL doesn’t match the URL regex.
Result:No content will be ingested.
Message: The URL does not match any of the configured top-level domains.
Case: Content selectors are configured, the website URL matches regex and it does not have a selected domain (one inside selector configuration), but the website URL does not match any of the entered domains.
Result: No content will be ingested.
Message: The URL does not match the chosen domain for the matched selector.
Case: Content selectors are configured and the website URL matches the regex and has a selected domain (one inside selector configuration), but the website URL does not match the selected domain.
Result: No content will be ingested.
Message: No HTML elements were found for the given selectors.
Case: If both URL regex and domains match, but the CSS selectors entered are not found on the page.
Result: No content will be ingested.
Message: No CSS selectors are defined. Not extracting content.
Case: If both URL regex and domains match, but no CSS selectors are entered.
Result: No content will be ingested.
Step 2: Air Intelligence
Select one or more audience models that reflect your audience. The audience models can be assigned to your domain or to a section of your site. Read more about Air Intelligence here.
Step 3: Integrations
Rayn JS provides integrations with common ad platforms allowing for instant data activation:
Google Ad Manager
Contextual categories and cohorts are injected into the Google Publisher Tag as Key Value pairs. More information on the GAM integration can be found here.
Configure the Google Ad Manager integrations by clicking Edit.
Rayn will synchronize the content and audience taxonomy with GAM for easy targeting. Follow the instructions here to learn how to set up the sync.
Prebid
Contextual categories and cohorts are pushed to Prebid. Read more on the Prebid integration here.
About Data Categories
About Data Categories
Control which taxonomy categories Rayn should push.
IAB Content Taxonomy V3 - This latest version includes updates to better support a variety of areas – News, Video/CTV content, Podcasts, Radio, Games and App stores. The changes include updates to “Aboutness categories” as well as to the additional “vectors”. This update includes some deletions which make this version of the taxonomy non-backward compatible with the 2.2 version. Although this taxonomy is superior to previous versions it is not yet supported by all platforms.
IAB Content Taxonomy V2.2 - This is still the most widely supported content taxonomy. If you wish to use Google Publisher Provided signals you will need to use V.2.2
When pushing categories Rayn can also push the parent categories of any category found. For example: When we detect the category "13 Minivan", we will also push its parent categories being "1 Automotive" and "2 Auto Body Styles". By also passing the parent categories for a given category you can ensure that the page is not excluded by buyers that are only targeting the tier above.
Tier 1 Automotive
Tier 2 Auto Body Styles
Tier 3 Minivan
The controls for data categories provide a means of limiting the depth of categories passed downstream.
Click Create after reviewing all your settings. You have now successfully created a Rayn JS connection. You will now be redirected to the overview screen of your new Rayn JS connection.
Installation of Rayn JS
Under Connections, click the Rayn JS connection you just created and head over to the Install tab to obtain the Rayn JS Tag.
Copy The Rayn JS wrapper and place it in the <head> on all pages where you wish to work with Rayn. Learn more on Rayn JS installation here.
Now you are ready to go!