Sailthru Personalization Engine Tag Setup Guide

[#1]

This article describes how to set up the Sailthru Personalization Engine tag in your Tealium iQ Tag Management (TiQ) account.

In this article:

Table of Contents Placeholder

Tag Tips

• Use mapping to:
  • Dynamically override standard configuration values
  • Set optional Personalization Engine configuration parameters. (Learn More)
  • Dynamically add Sailthru meta tags to your site
  • Configure event triggers (including custom events)
  • Send required and optional event parameters
• Supports these E-Commerce extension parameters:
  • Order ID
  • Customer ID
  • List of Product IDs
  • List of Product Names
  • List of Product Quantities
  • List of Product Prices
• For a list of required and optional event parameters, see Sailthru's JavaScript API Library documentation here: Sailthru JavaScript API Library

Tag Configuration

First, go to Tealium's tag marketplace and add the Sailthru Personalization Engine tag (Learn more about how to add a tag).

After adding the tag, configure the following settings:

• Customer ID
  • Your Sailthru Customer ID.
• Pageview Tracking
  • Manual page view tracking requires a mapping to Pageview URL (pageview.url) for the page being tracked.
  • Use data mapping to set additional optional parameters.

Data Mappings

Mapping is the process of sending data from a data layer variable to the corresponding destination variable of the vendor tag. For instructions on how to map a variable to a tag destination, see Data Mappings.

• The available categories are:

Standard

Variable	Description
init.customerId	Sailthru Customer ID
pageviewTracking	Pageview Tracking Options are automatic or manual.
init.isCustom	Options are true or false.
init.useStoredTags	Options are true or false.
init.excludeContent	Options are true or false.
pageview.url	Pageview URL
pageview.tags	Pageview Tags
pageview.onSuccess	Callback Function Name Pageview onSuccess
pageview.onError	Callback Function Name Pageview onError
meta.custom	Custom Meta Tag

E-Commerce

Variable	Description
order_id	Order ID Overrides _corder.
customer_id	Customer ID Overrides _ccustid.
product_id	Array List of Product IDs Overrides _cprod.
product_name	Array List of Product Names Overrides _cprodname.
product_quantity	Array List of Product Quantities Overrides _cquan.
product_unit_price	Array List of Product Prices Overrides _cprice.

Event Trigger

Variable	Description
userSignUp	User Sign Up
userSignUpConfirmedOptIn	User Sign Up Opt In Confirmed
addToCart	Add to Cart
purchase	Purchase
customEvent	Custom Event

Event Data: userSignUp

Variable	Description
userSignUp.email	String User Email Overrides E-Commerce Customer ID
userSignUp.id	String User ID
userSignUp.key	String User ID Type
userSignUp.lists	Object Lists
userSignUp.vars	Object Vars
userSignUp.source	String Acquisition Source
userSignUp.onSuccess	String On Success Callback Function Name
userSignUp.onError	String On Error Callback Function Name

Event Data: userSignUpConfirmedOptIn

Variable	Description
userSignUpConfirmedOptIn.email	String User Email Overrides E-Commerce Customer ID.
userSignUpConfirmedOptIn.id	String User ID
userSignUpConfirmedOptIn.key	String User ID Type
userSignUpConfirmedOptIn.template_name	String Opt-In Template Name
userSignUpConfirmedOptIn.template_vars	Object Opt-In Template Vars
userSignUpConfirmedOptIn.vars	Object Vars
userSignUpConfirmedOptIn.source	String Acquisition Source
userSignUpConfirmedOptIn.onSuccess	String On Success Callback Function Name
userSignUpConfirmedOptIn.onError	String On Error Callback Function Name

Event Data: addToCart

Variable	Description
addToCart.email	String User Email Overrides E-Commerce Customer ID
addToCart.reminder_time	String Reminder Time
addToCart.reminder_template	String Reminder Template
product_url	Array List of Product URLs
product_images	Array of Objects List of Product Images
product_vars	Array of Objects List of Product Vars
addToCart.vars	Object Vars
addToCart.onSuccess	String On Success Callback Function Name
addToCart.onError	String On Error Callback Function Name

Event Data: purchase

Variable	Description
purchase.email	String User Email Overrides E-Commerce Customer ID.
product_url	Array List of Product URLs
product_images	Array of Objects List of Product Images
product_vars	Array of Objects List of Product Vars
purchase.vars	Object Vars
purchase.onSuccess	String On Success Callback Function Name
purchase.onError	String On Error Callback Function Name

Event Data: customEvent

Variable	Description
customEvent.name	String Event Name
customEvent.email	String User Email Overrides E-Commerce Customer ID.
customEvent.id	String User ID
customEvent.key	String User ID Type
customEvent.vars	Object Vars
customEvent.onSuccess	String On Success Callback Function Name
customEvent.onError	String On Error Callback Function Name