TVSquared
Step-by-step guide to send event data from RudderStack to TVSquared.
Last updated
Was this helpful?
Step-by-step guide to send event data from RudderStack to TVSquared.
Last updated
Was this helpful?
TVSquared is a television attribution platform that specializes in enterprise-scale cross-screen and multi-touch TV attribution and measurement. They empower the advertising companies to quantify and attribute responses generated across televisions everywhere, and deliver meaningful business insights from the linear and digital TV content.
RudderStack supports TVSquared as a destination to which you can send your event data in real-time.
To enable sending data to TVSquared, you will first need to add it as a destination to the source from which you are sending your event data. Once the destination is enabled, events from the RudderStack SDK will automatically start flowing to TVSquared.
Before configuring your source and destination on the RudderStack, verify if the source platform is supported by TVSquared, by referring to the table below:
Connection Mode
Web
Mobile
Server
Device mode
Supported
-
-
Cloud mode
-
-
-
To know more about the difference between Cloud mode and Device mode in RudderStack, read the RudderStack connection modes guide.
Once you have confirmed that the platform supports sending events to TVSquared, perform the steps below:
From your RudderStack dashboard, add the source. From the list of destinations, select TVSquared.
Give a name to the destination and click on Next. You should then see the following screen:
TVSquared Connection Settings in the RudderStack Dashboard
The above connection settings are explained in more detail below:
Brand Id (Site ID): This is a unique identifier that indicates the TVSquared client to which the traffic belongs. This parameter will always carry the form of TV-XXXXXXX-1
with a variable-length numeric value replacing the X
.
Client Id (Collector Id): The Client ID allows us to distribute the traffic and manage the load on our servers effectively. It is numeric and can contain one or more values.
Event Whitelist: You can add the events you want to send to TVSquared in this field. If the list is empty, all the events will be sent. Otherwise, only the events mentioned in this whitelist will be sent.
Custom Metrics: The Property Name values added in this field will be sent to TVSquared for the events containing those event properties, along with the other defined properties of TVSquared. For example, if the property added in the dashboard is shipping
, then the shipping value will be sent to TVSquared. A sample code snippet for this is as shown:
Configure the above settings according to your requirements, and click on Next to complete the setup. TVSquared should now be added and enabled as a destination in RudderStack.
When a page
call occurs, RudderStack makes a call to TVSquared to record a page view.
For more information on the page
call, please refer to our RudderStack API Specification guide.
Calling the track
method causes TVSquared's Action Tracker
method to be triggered.
For more information on how the track
call works, please refer to our RudderStack API Specification guide.
By default, TVSquared can take the following parameters:
revenue
product type (category)
action id (order_id)
promo (promotion_id)
All the mentioned parameters are optional. There is no requirement to add these to measure the uplift from TV. However, this data can be used for more detailed analysis as required. If there is no value to pass an empty string will be set by RudderStack.
A sample track
call is as shown:
If you come across any issues while configuring TVSquared with RudderStack, please feel free to contact us. You can also start a conversation in our Slack community; we will be happy to talk to you!