LiveConnect Email Extension Configuration – Instructions by ESP
Below are email service provider (ESP) specific instructions for configuring the LiveConnect Email Extension.
Configuring the LiveConnect Email Extension helps increase the number of newsletter subscribers that DSPs can target and enable programmatic and first-party data opportunities.
If you do not see instructions for your ESP please reference our general configuration instructions. If have any questions during this setup process, please contact your LiveIntent Account Manager.
*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.
Use the below links to jump to instructions for specific ESPs:
- Active Campaign
- Braze
- Bronto
- Campaign Monitor
- Campaigner
- Constant Contact
- ConvertKit
- Iterable
- Klaviyo
- Listrak
- Mailchimp
- Marketo
- PostUp
- Sailthru
- Zeta Global
INSTRUCTIONS
Active Campaign
- The SafeRTB tag should be updated to include the same &lctg=%SUBSCRIBERID% on all pixels
- The LiveTags should be updated to include the same &lctg=%SUBSCRIBERID% on all main image URLs.
- Append &lctg=%SUBSCRIBERID% to all content links in your templates.
- Verify the setup by deploying a test email to your LiveIntent account team.
- After configuring, send a test email to [email protected].
- Please notify your LiveIntent Account Manager to confirm the successful configuration of the LiveConnect Email Extension.
Braze
- From the Braze Dashboard, navigate to Manage App Group.
- Select Custom Attributes from the 2nd level Top Menu.
- Click +Add Custom Attributes in the upper right hand of the window.
- Under Attribute Name enter lctg
- Under Data Type, select String and click SAVE.
- From the Braze Dashboard, navigate to Templates & Media on the left-hand menu.
- Select Link Templates from the 2nd level Top Menu.
- Click +Create Link Template in the upper right hand of the window.
- Enter lctg as the Template Name
- Optional, click +Add Template Description and enter LiveConnect Email Extension to differentiate this link template from others that may already be present.
- Under Template Position make sure After URL is selected.
- Under Query Parameters, click the + in the Key field.
- Under Personalization Type select Custom Attributes.
- Under Attributes select lctg, leaving the Default Value.
- Click Insert Personalization.
- Under Query Parameters, click the + in the Value.
- Make sure Personalization Type is set to Default Attributes.
- Under Attribute select braze_id leaving the Default Value blank.
- Click Insert Personalization.
- Under Template Preview you should see:
http://YOUR-DOMAIN.com?{{custom_attribute.${lctg}}}={{${braze_id}}}
- Click Save Template.
- Update any existing Campaigns by clicking Edit Email Body from inside the selected Campaign.
- Select Content Library from the upper right-hand menu.
- Select Link Templating.
- Under Select a Template select lctg and click +Add.
- Make sure # is checked under Link URLs.
- Click Done.
- Click Save as Draft or, if you are attempting a scheduled send, continue your workflow by clicking Forward.
- The LiveConnect tag publisher script on your site will then need to be updated (or placed if not already in use).
- The SafeRTB tag should updated to include the same parameter {{custom_attribute.${lctg}}}={{${braze_id}}} with a leading & symbol.
- The LiveTag image links should also be updated to include the same {{custom_attribute.${lctg}}}={{${braze_id}}} on all tag images, with a leading & symbol.
- After configuring, send a live send email to [email protected].
- Please notify your LiveIntent Account Manager to confirm the successful configuration of the LiveConnect Email Extension.
The SafeRTB and LiveTag Image tags would look like this (with the bold text being the appended parameter):
https://sli.domain.com/imp?s=125481701&li={LIST_ID}&e={email}&p={placement_id}&{{custom_attribute.${lctg}}}={{${braze_id}}}
Bronto
- Go to Home > Settings > Data Exchange.
- Scroll down to the Click Through Link Tracking section and click the “Track which contacts follow links off of your messages” checkbox.
- Append ?lctg=%%!contact_eid%% to links in template.
- The LiveConnect tag publisher script on your site will then need to be updated (or placed if not already in use).
- The SafeRTB tag should be updated to include the same lctg=%%!contact_eid%% on all pixels, with a leading & symbol.
The LiveTag image links should also be updated to include the same lctg=%%!contact_eid%% on all tag images, with a leading & symbol.
After configuring, send a live send email to [email protected].- Please notify your LiveIntent Account Manager to confirm that the LiveConnect Email Extension was successfully configured.
The SafeRTB and LiveTag Image tags would look like this (with the bold text being the appended parameter):
https://sli.domain.com/imp?s=125481701&li={LIST_ID}&e={email}&p={placement_id}& lctg=%%!contact_eid%%
Campaign Monitor
- For all mailing lists add a new Custom Field named “lctg”.
- In Campaign Monitor, navigate to Lists and Subscribers.
- And select each list one at a time.
- Click on “Custom fields” and “Add custom field”.
- The field name should be “lctg” and the type is “Text”
- Authorize the LiveIntent “LCEE Updates” API integration
- Your LiveIntent Account Manager will provide you with an authorization link to connect LiveIntent with your Campaign Monitor instance.
- When you visit the link, you will be redirected to login to your Campaign Monitor account.
- Click “Allow” on the screen to grant the LiveIntent API authorization permission to push LCEE values to your custom field.
- Append lctg=[lctg] to all content links in your templates.
- If your content was a link that looked like this https://www.domain.com/blog/article1.html
-
You would append ?lctg=[lctg] to the end of all content or landing page links within your template, resulting in your link being the following: https://www.domain.com/blog/
article1.html?lctg=[lctg] -
If there were existing parameters in the URL, you would append &lctg=[lctg] to the end of them.
- The SafeRTB tag should be updated to include the same &lctg=[lctg] on all pixels
- The LiveTags should be updated to include the same &lctg=[lctg] on all main image urls.
- Verify the setup by deploying a live send email to your LiveIntent account team.
- NOTE: The “send test message” feature does not apply personalization. It must be an actual send.
- After configuring, send a live send email to [email protected]
- Please notify your LiveIntent Account Manager to confirm the successful configuration of the LiveConnect Email Extension.
Campaigner
- In the Campaign Builder Email Details section, look for the “Analytics” section.
- Check the box to “Add custom URL parameters to tracked links”.
- Add a new entry with key = lctg and value = [Contact.Id]
- The SafeRTB tag should be updated to include the same &lctg=[Contact.Id] on all pixels
- The LiveTags should be updated to include the same &lctg=[Contact.Id] on all main image urls.
- Verify the setup by deploying a live send email to your LiveIntent account team.
- NOTE: The “send test message” feature does not apply personalization. It must be an actual send.
- After configuring, send a live send email to [email protected]
- Please notify your LiveIntent Account Manager to confirm the successful configuration of the LiveConnect Email Extension.
The SafeRTB and LiveTag Image tags would look like this (with the bold text being the appended parameter):
https://sli.domain.com/imp?s={ad_slot}&li={LIST_ID}&e={email}&p={placement_id}&lctg=[Contact.Id]
Constant Contact
- Add a new Custom Field for Contacts named “lctg”.
- In Constant Contact, navigate to Contacts.
- Click the 3-dot button “…” next to “Add Contact” and select “Manage Custom Fields”
- Click “Create custom field”.
- The field name should be “lctg” and the type is “Text”
- Authorize the LiveIntent “LCEE Updates” API integration
- Your LiveIntent Account Manager will provide you with an authorization link to connect LiveIntent with your Constant Contact instance.
- When you visit the link, you will be redirected to login to your Constant Contact account.
- Click “Allow” on the screen to grant the LiveIntent API authorization permission to push LCEE values to your custom field.
- Append &lctg=[[custom.lctg]] to all content links in your templates.
- The SafeRTB tag should be updated to include the same &lctg=[[custom.lctg]] on all pixels
- The LiveTags should be updated to include the same &lctg=[[custom.lctg]] on all main image urls.
- Verify the setup by deploying a live send email to your LiveIntent account team.
- NOTE: The “send test message” feature does not apply personalization. It must be an actual send.
- After configuring, send a live send email to [email protected]
Please notify your LiveIntent Account Manager to confirm the successful configuration of the LiveConnect Email Extension.
ConvertKit
- Turn on Add subscriber_id parameter in email links by navigating to the Account Settings and Email Settings page.
- Scroll to the bottom of the page and under Advanced, check the box beside Add subscriber_id parameter in email links.
- When tracking is turned on, one tag will be added to each URL in your campaign.
?ck_subscriber_id=123
Above is the URL parameter added to all the links sent via Broadcasts and Sequences.
- The LiveConnect tag publisher script on your site will then need to be updated (or placed if not already in use).
- The SafeRTB tag should be updated to include the same parameter lctg={{ ck_subscriber_id | url_encode }} with a leading & symbol.
The LiveTag images should be updated to include the same parameter lctg={{ ck_subscriber_id | url_encode }} with a leading & symbol.- After configuring, send a live send email to [email protected].
- Please notify your LiveIntent Account Manager to confirm the successful configuration of the LiveConnect Email Extension.
The SafeRTB and LiveTag Image tags would look like this (with the bold text being the appended parameter):
https://sli.domain.com/imp?s=125481701&li={LIST_ID}&e={email}&p={placement_id}&lctg={{{ ck_subscriber_id | url_encode }}
Drip
- Request a oAuth registration URL from your account manager. The URL will be of the form: https://espresso-auth.liveintent.net/drip/register?state=li.yourdomain.com&expires=2024-12-09T01:38:43Z&hmac=0ba5aab03480pesm0498b7d9483ac9fc (with all the parameter values modified).
- Paste the URL in a browser. If you are not already logged into Drip, you will be redirected to Drip’s login page. After you login you will see the page “Grant access to LiveIntent.” Click “Authorize.”
- Authorizing will show you a success page. If you see something different, contact your account manager to obtain a new link.
- In the Drip application, click on the “Settings” icon and select User Settings.
- In the left menu, click on the “People” icon and select “custom fields” from the menu.
- Click Add a custom field.
- In the “Enter a custom field” pop-up, enter the value lctg and click on the “Create Field.”
- Once the field is created, the LiveConnect tag publisher script will need to be placed on your site (or updated as per your account manager’s instructions).
- The SafeRTB tag should be updated to include the parameter &lctg={{ subscriber.lctg }}.
- The LiveTag images should be updated to include the parameter &lctg={{ subscriber.lctg }}.
- After configuring, send a test email to [email protected].
- Please notify your LiveIntent Account Manager to confirm the successful configuration of the LiveConnect Email Extension.
Iterable
- From your Iterable account dashboard, navigate to your email campaign.
- Click on the campaign to edit it and then select “Edit Campaign” -> “Edit”.
- Under the details section, scroll down to “Link Parameters” and check the box “Add in additional query parameters to each URL”.
- Add a parameter with the name lctg and the value {{itblUserId}}
- The LiveConnect tag publisher script on your site will then need to be updated (or placed if not already in use).
- The SafeRTB tag should be updated to include the same parameter lctg={{itblUserId}} with a leading & symbol.
- The LiveTag images should be updated to include the same parameter lctg={{itblUserId}} with a leading & symbol.
- After configuring, send a live send email to [email protected].
- Please notify your LiveIntent Account Manager to confirm the successful configuration of the LiveConnect Email Extension.
The SafeRTB and LiveTag Image tags would look like this (with the bold text being the appended parameter):
https://sli.domain.com/imp?s={ad_slot}&li={LIST_ID}&e={email}&p={placement_id}&lctg={{itblUserId}}
Klaviyo
- From your Klaviyo account dashboard, navigate to “Settings” -> “Other” -> “UTM Tracking”.
- Select the checkbox to “Automatically add UTM parameters to links”.
- Click the button to “Add a custom UTM parameter”. For the name of the parameter, enter “lctg” and for the value, select “Klaviyo profile id” for the campaign value.
- Click “Update UTM Tracking Settings” to save your changes.
- The LiveConnect tag publisher script on your site will then need to be updated (or placed if not already in use).
- The SafeRTB tag should be updated to include the parameter &lctg={{person.KlaviyoID}} with a leading & symbol.
- The LiveTag images should be updated to include the same parameter &lctg={{person.KlaviyoID}} with a leading & symbol.
- After configuring, send a live send email to [email protected].
- Please notify your LiveIntent Account Manager to confirm the successful configuration of the LiveConnect Email Extension.
The SafeRTB and LiveTag Image tags would look like this (with the bold text being the appended parameter):
https://sli.domain.com/imp?s={ad_slot}&li={LIST_ID}&e={email}&p={placement_id}&lctg={{person.KlaviyoID}}
Listrak
In order to complete the setup for Listrak you will need:
- An Admin user in order to set up a Listrak “Integration”
- A link provided by your account administrator to securely register API access with LiveIntent
- Login to listrak.com and click on the menu “Integrations” -> “Integration Management.”
- From the “Integration” screen, click on “New Integration” in the upper right-hand corner.
- From the “Integration < New Integration” screen, click on “Integrate” in the “Email API” section.
- On the “Email Integration” page click on the “Setup” button.
- Once on the “Setup” page select:
Access Levels: “List,” “Contact,” “Segmentation,” “Message,” “Event,” and “Report”- Click on “Disable IP Address Whitelist”
- Click “Save” in order to create a new API client ID/secret
- After clicking “Save” the “Integration Settings” details will collapse. Click the “Save” button again to reopen the settings details.
- When “Integration Settings” details reopens, you will see the values you previously saved. Scroll to the bottom of the page to see two values for “Client ID” and “Client Secret.”
- Copy the “Client ID” and save it in your password manager.
- Copy the “Client Secret” ID as well.
- If you cannot see the “Client Secret” ID, you can click the “Reset Secret” button in order to see a new one.
- Go to the URL provided to you by your LiveIntent account manager. The URL will look something like this:
- Enter the “Client ID” and the “Client Secret”
- If you’ve forgotten or haven’t saved these values, you can go back to step 7 and go from there.
- You will then see a screen that says “API Token Success.”
Mailchimp
- Turn on E-Commerce Link Tracking by navigating to the bottom of the Campaign Builder page, under Settings & Tracking.
- Select Edit, and check the E-Commerce link tracking box.
- When tracking is turned on, two tags will be added to each URL in your campaign.
- mc_cid is the internal Mailchimp generated ID for the campaign.
mc_eid is the unique MailChimp generated ID for each subscriber.
- When tracking is turned on, two tags will be added to each URL in your campaign.
- The LiveConnect tag publisher script on your site will then need to be updated (or placed if not already in use).
- The SafeRTB tag should be updated to include the same parameter mc_eid=*|EMAIL_UID|* with a leading & symbol.
- The LiveTag images should be updated to include the same parameter mc_eid=*|EMAIL_UID|* with a leading & symbol.
After configuring, send a live send email to [email protected].- Please notify your LiveIntent Account Manager to confirm the successful configuration of the LiveConnect Email Extension.
The SafeRTB and LiveTag Image tags would look like this (with the bold text being the appended parameter):
https://sli.domain.com/imp?s=125481701&li={LIST_ID}&e={email}&p={placement_id}&mc_eid=*|EMAIL_UID|*
Marketo
- Append &lctg={{Lead.Marketo Unique Code}} to all content links in the template.
- The SafeRTB tag should be updated to include the same &lctg={{Lead.Marketo Unique Code}} on all pixels
- The LiveTags should be updated to include the same &lctg={{Lead.Marketo Unique Code}} on all main image urls.
- Verify the setup by deploying a live send email to your LiveIntent account team.
- After configuring, send a live send email to [email protected]
- Please notify your LiveIntent Account Manager to confirm the successful configuration of the LiveConnect Email Extension.
- NOTE: The Marketo Email Link Performance report will show separate rows for each user. These rows can be re-aggregated for reporting by using an Excel or Google Sheets macro and a Pivot Table.
- An example formula to extract only the lctg parameter value is:
=REGEXEXTRACT(B2,“[&?]?lctg=([^&]*)”) - An example formula to strip the lctg parameter from the URL is:
=REGEXREPLACE(B2,”[&?]?lctg=([^&]*)”,””)
- An example formula to extract only the lctg parameter value is:
PostUp
- Login to PostUp.
- Click on Settings.
- Click on App Exchange under Site Settings.
- Click on Google Analytics.
- If Google Analytics is enabled click on View Details then Manage. If it is not enabled, click on Get Started.
- Select Use Custom Parameters. If you were using Custom Parameters already, simply append &lctg=[-RECIPID-] to your existing Custom Parameters.
- If you were using the utm_source= Default Parameters, insert: utm_source=[-MAILING_REFERENCE_NUMBER-]&utm_medium=email&utm_campaign=[-MAILINGID-]&lctg=[-RECIPID-].
- Check Append Google Analytics parameters to mailings by default.
- Click on Save.
- The LiveConnect tag publisher script on your site will then need to be updated (or placed if not already in use).
- The SafeRTB tag should be updated to include the same &lctg=[-RECIPID-] on all pixels.
The LiveTag should be updated to include the same &lctg=[-RECIPID-] on all images.- Verify the setup by deploying a live send email to your LiveIntent account team.
- After configuring, send a live send email to [email protected].
- Please notify your LiveIntent Account Manager to confirm the successful configuration of the LiveConnect Email Extension.
The SafeRTB and LiveTag Image tags would look like this (with the bold text being the appended parameter):
https://sli.domain.com/imp?s=125481701&li={LIST_ID}&e={email}&p={placement_id}&lctg=[-RECIPID-]
Sailthru
Select Messaging and navigate to the Campaigns page.
Create a New Campaign or Clone an existing campaign.
In the new campaign, navigate to the Design tab on the left side.
Select Advanced.
Select Link Setup.
Make sure Use Link Tracking is toggled to Yes.- In the text box at the bottom add lctg={profile.id}.
- This will append lctg= and a value to all the links in your email, when sent, but will not be present in your HTML view.
- The SafeRTB tag should be updated to include the same parameter lctg={profile.id} with a leading & symbol.
- The LiveTag images should be updated to include the same parameter lctg={profile.id} with a leading & symbol on all images.
- The LiveConnect tag publisher script on your site will then need to be updated (or placed if not already in use).
After configuring, send a live send email to [email protected].
Please notify your LiveIntent Account Manager to confirm that the LiveConnect Email Extension was successfully configured.
The SafeRTB and LiveTag Image tags would look like this (with the bold text being the appended parameter):
https://sli.domain.com/imp?s=125481701&li={LIST_ID}&e={email}&p={placement_id} &lctg={profile.id}
Zeta Global
- From your dashboard, click on the Settings icon by navigating to the top right of the page.
- Select Link Tracking.
- Click Add Parameter.
- Under Name enter: lctg
- Under Value enter the field name of the Unique User ID you have set for your account using the format {{unique_id}} (replacing ‘unique_id’ with your field name).
Unique User ID must not be an email, it should be either a Unique Number or Hash value. If your existing USER ID field meets these constraints, you may use that.- If you don’t have a Unique User ID that fits the constraints, contact your LiveIntent Account Manager to assist you in setting one up in your account.
- Click Save.
Lctg={{unique_id}} will be appended to the links in your newsletter going forward.- The LiveConnect tag publisher script on your site will then need to be updated (or placed if not already in use).
- The SafeRTB tag should be updated to include the same parameter lctg={{unique_id}} with a leading & symbol.
The LiveTag images should be updated to include the same parameter lctg={{unique_id}} with a leading & symbol on all images.- After configuring, send a live send email to [email protected].
- Please notify your LiveIntent Account Manager to confirm the successful configuration of the LiveConnect Email Extension.
The SafeRTB and LiveTag Image tags would look like this (with the bold text being the appended parameter):
https://sli.domain.com/imp?s=125481701&li={LIST_ID}&e={email}&p={placement_id}&lctg={{unique_id}}