TVSquared

TVSquared is a television attribution platform that specializes in enterprise-scale cross-screen and multi-touch TV attribution and measurement.

RudderStack supports TVSquared as a destination where you can seamlessly send your event data.

Getting started

RudderStack supports sending event data to TVSquared via the following connection modes:

In a web device mode integration, that is, using JavaScript SDK as a source, RudderStack loads the TVSquared native SDK from the http://tvsquared.com domain. Based on your website’s content security policy, you might need to allowlist this domain to load the TVSquared SDK successfully.

Once you have confirmed that the platform supports sending events to TVSquared, follow these steps:

1. From your RudderStack dashboard, add a source. Then, from the list of destinations, select TVSquared.
2. Assign a name to the destination and click Continue.

Connection settings

To successfully set up TVSquared as a destination, configure the following settings:

• Brand Id (Site ID): Enter the unique identifier indicating the TVSquared client to which the traffic belongs. It is of the format TV-XXXXXXX-1 with a variable-length numeric value replacing X.
• Client Id (Collector Id): Enter the Client ID used to distribute the traffic and manage the load on the TVSquared servers effectively. It is numeric and can contain one or more values.
• Event Allowlist: Add the events you want to send to TVSquared in this field. Only the events mentioned in this allowlist are sent to TVSquared and all the other events are dropped. If the field is empty, RudderStack sends all events.
• Custom Metrics: The Property Name values added in this field are sent to TVSquared for the events containing those event properties, along with the other defined TVSquared properties. For example, if the property added in the dashboard is shipping , then the shipping value is sent to TVSquared. A sample snippet for this is shown:

rudderanalytics.track('Order Completed', {
  order_id: '5d4c7cb5',
  revenue: 99.9,
  shipping: 13.99,
  tax: 20.99,
  products: [
  ]
});

Page

When you make a page call, RudderStack makes a call to TVSquared to record a page view.

rudderanalytics.page('new category',
'page name',
{
  url: 'url',
  path: '/path'
});

Track

Calling the track method triggers TVSquared’s Action Tracker method.

By default, TVSquared accepts the following properties in your track events:

• revenue
• product type (category)
• action id (order_id)
• promo (promotion_id)

All the above parameters are optional. There is no requirement to add these to measure the uplift from TV. However, you can use this data for more detailed analysis as required. If there is no value to pass, RudderStack sets an empty string instead.

A sample track call is as shown:

rudderanalytics.track('Order Completed', {
  order_id: '5d4c7cb5',
  category: 'category',
  revenue: 99.9,
  shipping: 13.99,
  tax: 20.99,
  products: [

  ],
  promotion_id: 'PROMO_1234'
});

Questions? Contact us by email or on Slack