Last updated Oct 24, 2023

Set up Tealium

There are two ways to connect with Tealium to track conversions: through the Rokt Web SDK or the Rokt Event API.

Rokt Web SDK setup

To properly match conversions to campaign events, Rokt requires a customer identifier; either raw email, hashed email (SHA-256) or Rokt Tracking ID.

Including contextual data in your conversion reporting helps Rokt optimize your campaigns.

Add the Rokt Web SDK

1. Log in to Tealium Customer Data Hub.
2. Click iQ Tag Management > Tags.
3. Click + Add Tag.
4. Search for Rokt.
5. Click +Add.

Configure the Rokt Web SDK

1. Configure the following settings:
   • Rokt Account ID: Enter the Rokt account ID provided by your account manager.
   • Two-step Email (Optional - Ecommerce only): Select True if you would like to send an email on positive engagement.
   • Use Sandbox (Optional - Ecommerce only): Select True if you wold like to send events to a sandbox account for testing.
   • PUBLISH LOCATIONS: Select Yes or No for publish locations and whether you want to use the Bundle Flag.
   • ADVANCED SETTINGS:
     • Tag Timing: Determines the timing of the tag firing.
     • Send Flag: Determines whether or not this library has event level data sent to it for tracking.
     • Synchronous Load Type: Set when the library needs to load synchronously.
     • Custom Script Source: Set when the library that supports this tag is served from an alternate location.
2. Click Next.

Create a Load Rule

Load Rules in Tealium determine when and where to load an instance of the Rokt Web SDK on your site.

1. Click + Create Rule.
2. Enter the following information:
   • Name: Give your rule a descriptive name.
   • Notes: Enter any notes about the rule.
   • Variable: Select Domain.
   • Operator: Select equals.
   • Value: Enter the URL provided by your Rokt account manager.
3. Click Done.
4. Click Next.

Data Mapping

Mapping is the process of integrating a data layer variable with the corresponding destination variable of the vendor tag.

note

The most common variable used is the JS emailAddress variable which the below process shows. Other variable categories are listed below.

1. Click the dropdown and search for JS.
2. Click the Use Custom Variable.
3. Select Email and click Done.
4. Add any further variables as needed.

note

The categories Standard and Ecommerce in Tealium corelate to Core and Suplemental in Rokt.

The available categories are:

Standard

VARIABLE	DESCRIPTION
Email	(email)
First Name	(firstname)
Last Name	(lastname)
Mobile Number	(mobile)
Zip or Postal Code	(zipcode)
Country	(country)
Language	(language)
Use Sandbox	(sandbox)

Ecommerce

VARIABLE	ATTRIBUTE	DESCRIPTION
Confirmation Number	(confirmationref)	This variable overrides the _corder variable.
Amount	(amount)	This variable overrides the _ctotal variable.
Currency	(currency)	This variable overrides the _ccurrency variable.
Payment Type	(paymenttype)
ccbin	(ccbin)
List of Item Prices	(price)	[Array] This array overrides the_cprice variable.
List of Item Quantites	(quantity)	[Array] This array overrides the_cquan variable.
List of Item Major Categories	(majorcat)	[Array] This array overrides the_ccat variable.
List of Item Major Category IDs	(majorcatid)	[Array]
List of Item Minor Categories	(minorcat)	[Array] This array overrides the _ccat2 variable.
List of Item Minor Category IDs	(minorcatid)	[Array]
List of Product Names	(productname)	[Array] This array overrides the_cprodname variable.
List of Item SKUs	(sku)	[Array] This array overrides the_csku variable.

5. Click Finish and you are returned to the Tags Dashboard.

Publish the Rokt Web SDK for Tealium

1. From the Tags Dashboard, click Save/Publish.
2. Enter a Title (mandatory).
3. Enter version Notes (mandatory).
4. Select where you would like to publish to Dev and/or QA and/or Prod.
5. Click Publish.

Rokt Event API set up

This connector uses the following API:

API information
API Name	Rokt API
API Version	2020-05-21
API Endpoint	https://api.rokt.com
Documentation	ROKT Event API

Batch Limits

This connector uses batched requests to support high-volume data transfers to the vendor. Requests are queued until one of the following three thresholds is met:

Request parameter	Threshold
Max number of requests	100
Max time since oldest request	10 minutes
Max size of requests	1 MB

Connector Actions

ACTION NAME	AUDIENCESTREAM	EVENTSTREAM
Send Conversion	✓	✓

Adding the connection to Rokt

1. Log in to Tealium Customer Data Hub and click Event Stream > Event Connectors.
2. Click Add Connector.
3. Search for and select the Rokt connector.
4. Click Continue.
5. The Data Source and Event Feed are automatically selected for you. Click Continue.
6. Click Add Connector.
7. Complete the following:
   • Name: Give the connector a name.
   • Notes: Make any notes as needed.
   • Client ID: Enter your App ID. Click for information on how to Generate your App ID and Secret.
   • Client Secret: Enter your App Secret.
   • Account ID - Enter the Rokt Account ID provided by your account manager.
8. Click Done.
9. Click Continue.
10. Enter a name for the action and then select the action type from the drop-down menu.

Action — Send Conversion

PARAMETER	DESCRIPTION
Event Type	(Required) Type of event.
Event ID	An identifier used to uniquely identify an event.
Event Time	Time of the event in UTC.
Email	Email passed as plain text, lowercase and without trailing spaces.
Email - emailsha256 (already SHA256 hashed)	SHA-256 hash of email address, already hashed.
Email - emailsha256 (apply SHA256 hash)	SHA-256 hash of email address. Tealium will hash.
Rokt Tracking ID	A Rokt-generated ID used to match conversion events to the originating click.
Conversion Amount	Transaction amount.
Currency Code	Currency code.
Quantity	The quantity (integer) of item within the specific conversion.
Conversion Type	Used to differentiate between different conversion events.
Product Names	The name of the product(s) purchased.
Product SKUs	The identifier of the product purchased (Note: Only accepts one SKU).
Payment Type	The payment method used during the transaction.
Credit Сard BIN	Credit card BIN of converting payment.
Margin	Profit margin of conversion.
Transaction ID	Transaction ID, used to identify a unique transaction.
Confirmation Reference ID	Confirmation reference ID.
Customer First Name	Customer's first name.
Customer First Name (already SHA256 hashed)	SHA-256 hash of first name, already hashed.
Customer First Name (apply SHA256 hash)	SHA-256 hash of first name. Tealium to hash.
Customer Last Name	Customer's last name.
Customer Last Name (already SHA256 hashed)	SHA-256 hash of last name, already hashed.
Customer Last Name (apply SHA256 hash)	SHA-256 hash of last name. Tealium to hash.
Mobile Phone Number	Mobile phone number of converting customer.
Mobile Phone Number (already SHA256 hashed)	SHA-256 hash of phone number, already hashed.
Mobile Phone Number (apply SHA256 hash)	SHA-256 hash of phone number. Tealium to hash.
Customer IP Address	Customer's IP address.
Customer IP Address (already SHA256 hashed)	SHA-256 hash of customer's IP address, already hashed.
Customer IP Address (apply SHA256 hash)	SHA-256 hash of customer's IP address. Tealium to hash.
User Agent	Browser user agent of converting customer.
Device Type	Type of device.
Device Operating System	Device operating system.
OS Version	Operating system version.
Browser	Browser.
Browser Version	Browser version.
Customer Title	Title of the customer.
Customer Gender	Gender of the customer.
Customer Date of Birth	In the format yyyymmdd.
Customer Age	Age of the customer.
Language	Language associated with the purchase.
Unit Number	Unit number associated with address.
Address 1	First line of street address.
Address 2	Second line of street address.
Customer Postal Code	Customer postal code.
Customer City	Customer city.
Customer State	Customer state.
Customer Country	Customer country.
Meta Data	Non-business critical information about the event.

6. Complete Conversion Data and Meta Data sections as required. See POST Events for further information.
7. Click Finish.
8. Click Save and Publish.
9. Give your Connector a Title and Description.
10. Click OK.