Understanding Lytics / Integrations

Sailthru

This article covers:

Before You Begin

In order to allow Lytics to access your Sailthru account, you'll need the following two keys

  • API Key
  • API Secret

These are unique for your company’s Sailthru account, and can be found on the API & Postbacks Settings page in My Sailthru.

Authentication

  1. Navigate to the Sailthru integration in the Integrations section in Lytics. sailthru app
  2. If this is your first time using Sailthru you will be prompted to choose one of integrations explained below. Choose one.
  3. Connect Sailthru to Lytics by selecting Add new authorization. You will be prompted for the Sailthru keys (see above). NOTE: You will only do this once. sailthru authorize

    After adding the client keys, add a description for your auth so it can be identified from other Sailthru auths. Then hit Authorize. Your credentials are now stored securely available for quick use when starting new integrations works.

Import users from a Sailthru list

Initiating this workflow will pull into Lytics all users from a selected Sailthru list.

Summary
FrequencyDaily
Streamssailthru_users
User fieldshashed_email, city, state, country, postal_code
Provider fieldsst_ids (sailthru ID), status, engagement
User activitynone, just counts as user fields
Campaign contentNo
Click URL paramNone
  1. Navigate to the Sailthru integration in the Integrations section in Lytics.
  2. Click Import List to begin import configuring workflow.
  3. Select auth created above.
  4. Complete import configuration

    Required:

    • Sailthru List: choose the Sailthru list to import. All users active in the selected list will be imported. sailthru import list
    • Hash Algorithm: select between SHA-256 and MD5 encoding of email addresses. Sailthru will only send hashed emails to Lytics. sailthru import hash

    Optional:

    • Keep Updated, Time of day, Timezone: check and set the time to continually pull list updates from Sailthru on a daily basis. sailthru import update
  5. Once the workflow is configured click Start Import.

User data from the import should be ready in Lytics within an hour.

Export a Lytics audience to a Sailthru list

Initiating this workflow will add all email addresses (and other selected fields) from a Lytics audience to a Sailthru list

Summary
FrequencyReal-time, as user enter/leave a Lytics audience, user will be added/removed from Sailthru list
WhereA new Sailthru list
Name"Lytics " followed by the audience name that is being exported e.g. Lytics All
IdentifiersEmail
Mapped FieldsYes
Segment MembershipNo
Typeadd/removal
  1. Navigate to the Sailthru integration in the Integrations section in Lytics.
  2. Click Export List to begin import configuring workflow.
  3. Select auth created above.
  4. Complete export configuration options

    Required: - Audience: Select the Lytics audience to export to Sailthru sailthru export audience - Email Field: Select the field in Lytics that contains the email address to send to Sailthru sailthru export email

    Optional: - Fields to Export: Select the additional fields to export as custom variables in Sailthru. User fields from Lytics will be written to Sailthru prefixing the Lytics field slug name with lytics_. For example, Last Name will be written to the field lytics_last_name in the Sailthru. sailthru export fields

  5. Once the workflow is configured click Start Export.

User data from the export should be ready in Sailthru within an hour depending on the size of the audience exported. This export will run continually until it is stopped. As new users enter or exit the Lytics audience, the corresponding user will be added or removed from the Sailthru list.

Export users using Lifecycle Optimizer

Initiating this workflow will integrate a Lytics audience with a Sailthru List and initiate an action created using the Sailthru Lifecycle Optimizer feature.

Summary
FrequencyReal-time, as user enters Lytics audience, user will be added/updated to a Sailthru list with some Lifecycle Optimizer action taken (i.e. if list joined, send email)
WhereA new Sailthru list managed by Lifecycle Optimizer
Name"Lytics " followed by the audience name that is being exported e.g. Lytics All
IdentifiersEmail
Mapped FieldsYes
Typeadd/update

Set up Lifecycle Optimizer

  1. Login to your Sailthru account and Navigate to the Lifecycle Optimizer option underneath the Communications tab.
  2. Setup a Lifecycle Optimizer flow schedule by declaring what Action should happen when a user joins a specified list (only List Joined option will work in the Entry part of the Lifecycle Optimizer flow).Sailthru Lifecycle Optimizer
  3. The list name should be "Lytics" followed by the audience name you wish export from Lytics. Either create a new list corresponding to the audience from the Lists option under the Users tab or use an existing list.
  4. More info on how to use Lifecycle Optimizer can be found here: Lifecycle Optimizer.

Start export

  1. Navigate to the Sailthru integration in the Integrations section in Lytics.
  2. Click Export User - Lifecycle Optimizer to begin configuring workflow.
  3. Select the auth you created in the authentication step.
  4. Complete export configuration options and match the audience you wish to export to an existing list in Sailthru (remember to add "Lytics" to the beginning of your list name in Sailthru).

Passing an Identifier from Sailthru for Identity Resolution

You may want to pass a unique Sailthru identifier from links within your email to help enable cross-channel identity resolution. This will help Lytics identify users across data streams and merge their email with web activity.

The easiest way to pass a unique identifier from Sailthru click-through links into Lytics is to modify your email template to include a hashed email in each URL in the email being sent.

Requirements

The Lytics Javascript tag must be installed on your site, and the Lytics Import users from a Sailthru list will need to be active with userId set for import (default state). In addition, a line of LQL will need to be added to the Sailthru query in order to map the hashed email field to the user's profile. For assistance contact your Lytics representative or Lytics support.

For example:

qs(url, "email_hash") as hashed_email SHORTDESC "Hashed Email"

Add encrypted email to Sailthru links

  1. Ensure the Lytics Sailthru import Hash Algorithm option is set to 'SHA-256' (default).

  2. Log in to Sailthru and navigate to Communications > Templates then select your email template.

  3. Select the Advanced tab.

  4. Copy email_hash={sha256(email)} into the Auto-Append Link Parameters field. Screenshot 2018-11-28 Template Editor

Now all email clicks will pass the encrypted SHA256 email to your website when users click the links, and Lytics will map the encrypted email to the user's profile.

www.yourcompanyURL.com/email-campaign-page?email_hash=hashed-email-here-for-each-user