Convert Experiences with LogRocket Integration
Understand how you could integrate LogRocket with Convert
IN THIS ARTICLE YOU WILL:
- Get an Overview of LogRocket Integration
- Understand its Pre-requisites
- Know the Steps
- Perform Analysis
- Understand Troubleshooting
This document outlines the steps to integrate Convert experiences with LogRocket, allowing you to gain deeper insights into user behavior and experiment performance.
Overview
Integrating Convert with LogRocket enables you to:
- View Convert experiment details within LogRocket sessions.
- Filter LogRocket sessions by Convert experiment variations.
- Analyze user behavior on different variations to understand why certain variations perform better or worse.
Prerequisites
Before you begin, ensure you have:
- An active Convert account.
- An active LogRocket account.
- The Convert tracking code implemented on your website.
- The LogRocket script installed on your website.
Integration Steps
The integration process involves two main steps:
Step 1: Send Convert Data to LogRocket
To send Convert experiment data to LogRocket, you need to add a custom script to your website that fires a LogRocket track event when a Convert experiment is active.
- Access your Convert Project Settings:
- Log in to your Convert account.
- Navigate to your project settings.
- Go to the "Integrations" or "Custom Code" section.
- Add Custom JavaScript:
Add the following JavaScript code to your Convert project's custom JavaScript section, or directly to your website's <head> section after the LogRocket script and before the Convert tracking code.
window._conv_q = window._conv_q || [];
|---|
if (window.convert && window.LogRocket) {
window.convert.currentData.forEach(function(experience) {
if (experience.status === 'running' && experience.variationId) {
LogRocket.track('Convert Experience', {
experienceId: experience.id,
experienceName: experience.name,
variationId: experience.variationId,
variationName: experience.variationName
});
}
});
}
}]);
- Explanation of the code:
- if (window.convert && window.LogRocket): Checks if both Convert and LogRocket are loaded on the page.
- window.convert.currentData.forEach(...): Iterates through all active Convert experiences on the page.
- LogRocket.track('Convert Experience', {...});: Sends a custom event to LogRocket with the experiment and variation details.
Step 2: Verify Data in LogRocket
After implementing the code, you can verify the integration by checking your LogRocket sessions.
- Run a Convert Experiment:
- Ensure a Convert experiment is active and running on your website.
- Visit your website to trigger the experiment.
- Check LogRocket Sessions:
- Log in to your LogRocket account.
- Navigate to your "Sessions" or "Replays" section.
- Look for sessions where you participated in the Convert experiment.
- Inspect Session Details:
- Within a session, you should see the "Convert Experience" event under the "Events" tab or in the console.
- The event details will include the experienceId, experienceName, variationId, and variationName.
Using LogRocket for Analysis
Once the integration is complete, you can leverage LogRocket's powerful features to analyze your Convert experiments:
Filtering Sessions by Experiment Data
You can filter your LogRocket sessions based on the custom properties sent from Convert.
- Open LogRocket Filters:
- In the LogRocket session list, click on "Add Filter."
- Select Custom Event Property:
- Choose "Event Name" and enter "Convert Experience".
- Then, add another filter for "Event Property" and select experienceName or variationName.
- Enter the specific name of your Convert experiment or variation.
Replaying Sessions
Replay sessions to visually see how users interacted with different variations of your Convert experiments.
Creating Dashboards and Metrics
Create custom dashboards and metrics in LogRocket to track key performance indicators (KPIs) for your Convert experiments. For example, you can track user clicks, form submissions, or error rates for each variation.
Troubleshooting
- No Convert data in LogRocket:
- Verify that both the LogRocket script and Convert tracking code are correctly installed on your website.
- Ensure the custom JavaScript code for integration is present and correctly implemented.
- Check your browser's developer console for any JavaScript errors.
- Incorrect experiment data:
- Double-check the experienceId, experienceName, variationId, and variationName values being sent to LogRocket in the custom script.
If you have any questions or issues while implementing this feel free to the contact Convert support team.