RTB House
In this section you will learn:
- How to connect or disable RTB House on your site.
- How to check the correctness of the integration settings.
- How to configure the sending of custom segments.
RTB House is a dynamic retargeting system. SegmentStream allows you to send data about the behavior of your users to RTB House.
Page contents
Introduction
With the help of SegmentStream, you can fully integrate RTB House on your website: events, deduplication etc.
To setup the RTB House integration:
- Log in on the segmentstream.com website and go to the integration management panel
- Click on the “Integration” tab and click on the block with the RTB House logo.
- In the panel that opens, configure the integration.
You can read more details about the settings below.
Required events and variables
For the correct operation of the integration of your site with RTB House - you must configure the filling of certain events in the digitalData.events
array. The list of events is as follows:
Required events
- Viewed Page
- Viewed Product Detail
- Viewed Product Listing
- Searched Products
- Started Order
- Updated Cart
- Viewed Cart
- Completed Transaction
It is also necessary to configure the filling of certain variables of the digitalData
object. A list of the variables is given below:
page.type
product
- the product object occurs in several places of thedigitalData
object: directly indigitalData.product
, in theitems
andlineItems
arrays of thelisting
,cart
andtransaction
objects.listing
,cart
,transaction
objects- and others.
Account key
The ID of your account can be checked with your RTB House account manager
Cross-Device tracking
If the digitalData.user.email
variable is filled, then we will automaticaly send a uid
matching the sha256 hash of that email.
Custom tags
RTB House allows you to send several custom tags with each event, which can contain the users segments or any other variables. To configure the transfer of a custom tag, you have to fill in 3 fields:
- Left - Enter the name of the custom tag that you want to pass data to.
- Center - Specify the data source:
- DigitalData. Any variable that is present in the digitalData object
- Event. Any variable of any event that is pushed to the
digitalData.events
array
- Right - Specify the name or the value of the variable in the right field.
For example:
- If you want to completely disable retargeting for a specific segment of users - you need to create a numeric variable in the
digitalData
object and insert its address into the integration configuration field. For example, for all users on which you want to disable retargeting, you pass the value 1 to the variabledigitalData.user.segment
, and for the rest, 0. For more information about creating variables, see variables. In the left field of the setting inputuser
as a tag name, in the center drop-down selectDigitalData
and in the right field inputuser.segment
, as illustrated in the screenshot below. - If you want to pass the value of the
subscription
parameter of an event to a tag namedsubscription
, in the left field of the setting inputsubscription
as a tag name, in the center drop-down selectEvent
and in the right field inputsubscription
, as illustrated in the screenshot below.
Use custom deduplication
Deduplication is an attribution setting that can be sent to RTB House along with the order. By default, this feature is disabled. This means that RTB House uses its own attribution model to set up its own machine learning algorithms.
The attribution model is the rule by which the value of the conversion/(order value) is redistributed between all sources of traffic that led the user to the site before buying. There is a large number of attribution models, the most common of these is last non-direct click. When using this model of attribution - 100% of the conversion value will be assigned to the last indirect source of traffic. For example, if a user first came to the site from a search, then from RTB House, then typed the URL in the browser - the whole value of the order will be assigned to the source of “RTB House”.
If you use “own deduplication”, SegmentStream will remember the source (the value of the GET parameter utm_source). If this value is “rtb-house”, the transaction will be attributed to the RTB House source.
Checking the correctness of the integration setup
After configuring the integration in the SegmentStream interface, but before PUBLICATION - go to the site in test_mode, go through the conversion funnel and check for errors. If there are no errors - publish the current version.