Troubleshooting Litmus Integrated Insights
Litmus Integrated Insights combines email performance data from your ESP with subscriber engagement data from Litmus in a single view. If you see an error or data doesn't match your expectations, these troubleshooting steps may help.
ESP connection
- If you connected your ESP in Litmus Settings or already have an ESP connection set up, select Generate report on the report page to start the process of creating the Integrated Insights report.
- You will get a notification email when your report is ready.
- If your report takes more than 1 hour to create, contact support for further assistance.
- The Integrated Insights Report is not compatible with Marketing Cloud Legacy Installed Packages.
Salesforce Marketing Cloud - Legacy Installed Packages
- ESP Sync connections in Litmus setup prior to July 2019 used a Legacy API that Salesforce no longer supports.
- Although these connections do still work when syncing HTML from Litmus Builder, we recommend you delete these connections and create a new Enhanced Package in Marketing Cloud to connect to Litmus.
- The Integrated Insights features do not work with Legacy Installed Packages. However, Integrated Insights features will become available once you upgrade your connection.
- If you have multiple business units connected to Litmus, integrated insights will default to the first connection.
- To upgrade your connection, create a new ESP connection in Litmus for Marketing Cloud.
Salesforce Marketing Cloud - Journey Builder
Currently, the Salesforce API we use to populate the Integrated Insights Report does not return data on emails sent via Journey Builder. If an email is sent via Journey Builder, it will not appear in the report.
Eloqua
When we pull the Campaign for the Integrated Insights Report we pull only the email and not the dynamic footer. If your Litmus tracking code is in your dynamic footer, we can not match up the tracking code to populate the Litmus Read Rate.
Email thumbnail rendering issues
The Integrated Insights report generates the email thumbnails and full images of the emails based on the HTML provided by the ESP. This is a standard browser rendering of the HTML.
- In some cases, the HTML will contain AMPscript and code conditionals that will display in the renderings.
- Sometimes the ESP doesn't provide access to the raw email HTML that we generate the thumbnail from. In this case, the thumbnail will be empty.
Missing read rates and audience breakdowns
The Integrated Insights report generates the Read Rates and Audience breakdown data only if a Litmus tracking code is used in the email.
No 'View detail' links
- If an email does not contain a Litmus tracking code, then we can’t provide audience details or read rate for that email.
- If an email tracking code was created on another account and is not accessible by the account that the report is in, then the report will not link to the tracking code report.
Data variations
- If multiple emails have the same tracking codes, then the Read Rate and Audience details will be the same for all the emails which contain that tracking code.
- Litmus tracking codes count total opens, not unique opens. The total opens in the Litmus tracking code report will usually exceed the unique opens that your ESP provides for the open rates.
- Open rates are calculated on unique opens which is the first open of an email. Litmus tracking codes report total opens.
Turn off the Integrated Insights report
- If you no longer wish to use the Integrated Insights features, you must delete the ESP connection in Litmus Settings. Once you delete the connection, the report will be removed, subscribers will no longer receive the Insights Digest, and Litmus will no longer sync any of the email performance metrics from your ESP.
- If you still want to use other features of Litmus ESP sync, you can reconnect your ESP from Settings. The Integrated Insights features will not get enabled unless you visit the report or Analyze page and select Generate report.
- If you connect your ESP from the Analyze section or the performance reports area, then Litmus will start syncing your email performance for the Integrated Insights report. Once you generate the new report, metrics for the last 30 days of sent emails will be synced.