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