Skip to content
  • There are no suggestions because the search field is empty.

Convert Experiences with LogRocket Integration

Understand how you could integrate LogRocket with Convert

IN THIS ARTICLE YOU WILL:

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.

  1. Access your Convert Project Settings:
    • Log in to your Convert account.
    • Navigate to your project settings.
    • Go to the "Integrations" or "Custom Code" section.
  2. 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.

  1. Run a Convert Experiment:
    1. Ensure a Convert experiment is active and running on your website.
    2. Visit your website to trigger the experiment.
  2. Check LogRocket Sessions:
    1. Log in to your LogRocket account. 
    2. Navigate to your "Sessions" or "Replays" section. 
    3. Look for sessions where you participated in the Convert experiment. 
  3. Inspect Session Details: 
    1. Within a session, you should see the "Convert Experience" event under the "Events" tab or in the console. 
    2. 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.

        1. Open LogRocket Filters: 
          1. In the LogRocket session list, click on "Add Filter."
          1. Select Custom Event Property: 
            1. Choose "Event Name" and enter "Convert Experience". 
            2. Then, add another filter for "Event Property" and select experienceName or variationName. 
            3. 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.