ESP Event Configuration Instructions: Iterable

ESP Event Configuration Instructions: Iterable

These instructions will help email senders configure their ESPs to share data with LiveIntent. Configuring event data sharing with LiveIntent improves the accuracy and scale of several Monetization, Intelligence, and Addressability products. Different configuration options are available depending on the ESP you use. If you have any questions about how ESP event configurations help your specific use cases, please contact your account team.

This page is dedicated to instructions specifically through the Iterable ESP.

LiveConnect Email Extension

*Note: Placing a LiveConnect tag on your website is a prerequisite to configuring the LiveConnect Email Extension. If you need to add your LiveConnect tag please follow the website implementation instructions or reach out to your LiveIntent Account Team. 

What is the LiveConnect Email Extension?

The LiveConnect Email Extension is simply an additional URL parameter LiveIntent recommends that email senders add to all URLs within their newsletter to maximize newsletter monetization and improve the identity resolution of their site visitors. For more information, follow this link.

Full instructions: update tag parameters

Before starting, you will need a login to Iterable with permission to Manage Integrations.

1. From your Iterable account dashboard, in the Messaging menu, navigate to your email campaign.

2. Click on the campaign to edit it and then select Edit in the Content area.

3. Under the details section, scroll down to Link Parameters and check the box “Add in additional query parameters to each URL”.

4. An option to “+ Add link parameter” will appear. Click on it to show Key and Value text entries. Type lctg in the Key field and {{#md5}}li.{{email}}{{/md5}} in the Value field.

5. Once you have created the lctg field, the LiveConnect tag publisher script on your site will need to be updated (or placed if not already in use).

5. The SafeRTB tag should be updated to include: &lctg={{#md5}}li.{{email}}{{/md5}}

6. The LiveTag images should be updated to include: lctg={{#md5}}li.{{email}}{{/md5}}

  • The SafeRTB and LiveTag Image tags should look like this (with the bold text being the appended parameter):
    • https://sli.domain.com/imp?s={ad_slot}&e={email}&p={{now format=’MMddyyyy’}}&{{#md5}}li.{{email}}{{/md5}}

Validate configuration with LiveIntent team

1. Send a test email to [email protected]

2. Please notify your LiveIntent Account Manager to inform them of the successful configuration or of any issue you encountered.

Advanced ESP Integration

Full instructions: enable Webhook integration

This section describes the steps to follow to configure your iterable account to send email events to LiveIntent. More details on Iterable webhook setup can be found in iterable’s KB webhook article.

Before starting, you will need a Webhook URL from your LiveIntent account manager. It will look something like the below (exact path may vary and there may be extra parameters):

https://esp-webhooks.privacy-enclave.liveintent.com/webhook-event/iterable/{{integration_type}}/{{publisher_id}}/{{unique_alphanumerical}} with {{publisher_id}} and {{unique_alphanumerical}} prepopulated with the specific values for your publisher.

1. In the upper left corner you can see the account and project information. Click on it and select the project where the publisher is managed.

2. Hover over the Integrations Menu and select System Webhooks

3. In the System Webhooks page click on Create Webhook on the upper right side of the screen

4. The Create Webhook button will generate a pop-up in the middle of the window. Enter the URL that you obtained from your account management team. Then click Create.

5. Creating a webhook will take you to the Edit system Webhook page. To complete the setup, click on the following:

  • Status → Enabled 
  • Authentication → None 
  • Select “Select Email” (you can select more but make sure all email events are checked
  • Save Webhook

6. After saving, you will see a pop-up, “Successfully updated webhook.”

Validate configuration with LiveIntent team

1. Send a test email to [email protected]

2. Please notify your LiveIntent Account Manager to inform them of the successful configuration or of any issue you encountered.

Back to top