Lytics + Iterable Integration

Lytics integrates with Iterable to power advanced personalization and recommendation strategies for both content and products across all messaging types supported by Iterable.

If you would like to set up Lytics, please contact your implementation manager, customer success manager. See Working with Iterable Support.

# In this article

# Before you begin

• You will need your Iterable username and password and have sufficient permissions to obtain an API key.

• You will need to obtain an Iterable API Key to authorize Lytics to use your Iterable account.

• If you are setting up Iterable webhooks, you will need a Lytics API token, found in your Lytics account settings.

# Authentication

1. Log into your Lytics account.

2. Open the Iterable integration or click Data > Integrations and select Iterable from the integrations list.

   

3. Click Export List or Import Users & Activity to authorize Lytics to use your Iterable account.

   

4. Click Add New Authorization.

   

5. In the API Key box, enter your Iterable API key.

6. In the Description box, enter a description.

7. Click Authorize. Your credentials are now stored securely and are available when starting new Iterable journeys.

   

# Export to Iterable

You can export a Lytics audience to an existing Iterable list or create a new Iterable list. All existing members of that audience are exported to the chosen list and new members are exported in real-time.

Summary:

• Frequency: Real-time
• Exports to: List
• Name: User-specified
• Identifiers: Email
• Mapped Fields: Yes
• Segment Exports: None
• Type: Add & remove

1. Log into your Lytics account.

2. Open the Iterable integration, or click Data > Integrations and select Iterable from the integrations list.

3. Select Export List.

   

4. In the Audience drop-down list, select the Lytics audience you would like to export to Iterable.

5. In the List box, select the Iterable list you want to export your Lytics audience to or enter a name to create a new list in Iterable.

6. In the Email Address drop-down list, select the Lytics user field that contains the email to export.

7. (Optional) In the ID Field, select the Lytics user field that contains the ID to export.

8. (Optional) Use the Map Fields input to map Lytics fields to existing Iterable fields. Select Lytics data fields from the left drop-down list and Iterable fields from the right drop-down list. If no fields are mapped only email will be exported.

9. (Optional) Use the Fields to Create input to add any Lytics fields you would like to create in Iterable. Fields in the right column will be added to Iterable.

   

10. Click Start Export.

Users should be available in the Iterable list within a few minutes of starting the export. Larger audiences may take a few hours to be completely added to the List. You can find the new list in Iterable under Audience > Lists.

# Import users and activity

You can import Iterable user data and activity into Lytics. You can use that data and activity to build targeted audiences.

Summary:

• Frequency — Hourly
• Streams — iterable_users, iterable_activity
• User fields — email, first_name, last_name, and custom fields
• Provider fields — Iterable user ID
• User activity — Sends, opens, clicks, bounces, subscribes
• Campaign content — No
• Click URL param — None

1. Log into your Lytics account.

2. Open the Iterable integration, or click Data > Integrations and select Iterable from the integrations list.

3. Select Import Users & Activity

   

4. Identify the authorization you would like to use and click Select.

   

5. Use the User Fields to Import input to select the Iterable fields you would like to import into Lytics. Fields available to be imported from Iterable are located in the left column. Fields added to the right column will be imported into Lytics.

6. If you would like users and their activity to be updated continually, check Keep Updated.

   

7. Click Start Import.

User data will begin to import into Lytics from Iterable and should be available within the hour. If Keep Updated was selected user data and activity will be updated hourly until the import is canceled.

# Set up webhooks

You can use webhooks for real time event capture of your Iterable events. For more information see Iterable's webhooks documentation.

1. Sign in to your Iterable project.

2. Click Integrations > System Webhooks.

3. Click Create Webhook.

4. In the Endpoint URL box, enter:

   https://api.lytics.io/collect/json/iterable?access_token=<YOUR_API_TOKEN>

   Replace <YOUR_API_TOKEN> with your Lytics API token, which can be generated in your account settings.

   

5. Set the Auth Type to NoAuth by clicking the NoAuth radio button.

6. Click Create Webhook.

7. Scroll to the right edge and click Edit.

   

8. Click the Enabled checkbox.

9. Select the events you'd like to send data to Lytics by clicking on their respective checkboxes. The available options for webhook events are:

   • Triggered Send
   • Blast Send
   • Push Send
   • SMS Send
   • Email Open
   • Push Open
   • Email Click
   • Hosted Unsubscribe Click
   • Email Complaint (spam)
   • Push Uninstall
   • SMS Received
   • Email Bounce
   • Push Bounce
   • SMS Bounce
   • Email Subscribe
   • Email Unsubscribe

10. Click Save.

    

After saving the changes to the webhook, the selected events will be sent to your Lytics account in real-time.

# Passing an identifier from Iterable for identity resolution

You may want to pass a unique Iterable identifier from links within your email to help do cross-channel identity resolution. This will help Lytics identify users across data streams and merge their email with web activity. For more information about dynamically passing this parameter, read Iterable's Link Parameters article.

The easiest and safest way to pass a unique identifier from Iterable click-through links to Lytics is to encode the user's email with Base64, in Iterable, with link parameters.

# Requirements

The Lytics Javascript tag must be installed on your site, and the Lytics import users and activity will need to be active with email set for import (default state). In addition, a line of LQL will need to be added to the Iterable data mapping file in order to decode and map the email field to the user's profile. For assistance contact your Lytics representative or support@lytics.com.

# Add encoded email to Iterable links

1. Ensure that the Iterable integration is importing users and email (default).

2. Sign in to Iterable.

3. Navigate to Content > Templates and open your email template.

4. Check Link parameters

5. Set up this link parameter:

   • Key — encoded_email
   • Value —  {{#base64}}{{email}}{{/base64}}

Now all email clicks will pass the encoded_email to your website when users click the links, and Lytics will automatically grab the encoded_email, decode it and stitch it to the user's web behavior via our JavaScript web tag.

For example:

www.example.com/email-campaign-page?encoded_email=dXNlckBleGFtcGxlLmNvbQ==