📘

This integration is currently in beta. Contact your MetaRouter support team to get started.

What Is Convert?

Convert is a versatile software tool designed for businesses to optimize their digital marketing efforts. It offers a suite of features including A/B testing, split URL testing, and multivariate testing to improve website performance and conversion rates. Convert provides intuitive, user-friendly interfaces for setting up experiments, tracking results, and making data-driven decisions, helping businesses to refine their online strategies and maximize conversions effectively.

What are the benefits of integrating MetaRouter with Convert?

• All customer data events and attributes unlocked for custom event mapping and transformation
• No effect on website load latency

---

Getting Started - From Your Convert Account

Gather the following IDs from your Convert account:

• Account ID - You can grab this from the URL of your Convert account URL, i.e. https://app.convert.com/accounts/XXXXXXXX/
• Project ID - You can grab this from the project list section of the homepage or once you click into a project, grab it from the URL, i.e. https://app.convert.com/accounts/XXXXXXXX/projects/XXXXXXXX

---

Getting Started - From Your MetaRouter Account

Adding a Convert integration.

From the integration library, add a Convert integration. Then, fill out the Connection Parameters:

Adding a Convert Sync

To gather the conv_v , you must add a Convert sync.

1. From the Pipelines page, find the pipeline associated with the web property you’d like to add a sync to. Hover over the three dot dropdown and select “Build AJS File.”
2. In the Identity Syncs section, select the Convert sync.
3. Fill out the following fields:
   1. Consent Type - We recommend that you consult with your legal team when determining your consent requirements.
   2. Cookie Lifetime (in days) - 365 recommended
4. Scroll down and click the Save and Build File button.
5. Deploy your AJS file to propagate changes to your web property.

---

Event Mappings

MetaRouter provides all of the event mappings that Convert integrations typically require. You may add custom events, parameters or mappings in accordance with Convert’s API documentation.

Global

Global mappings will be applied to all events. If your parameter names do not match the Expected Inputs provided, you will need to overwrite the Inputs provided with your own.

Event Specific

The following events are included in the default starter-kit:

• cart_viewed
• checkout_started
• identify
• order_completed
• page
• payment_info_entered
• product_added
• product_list_viewed
• product_viewed
• products_searched
• promotion_clicked

All events follow the the expression format below:

For every event, you must modify eventTypes to specifcy the event type sent to Convert. For example {"hitGoal"} to send just hitGoal, {"hitGoal", "tr"} to send both hitGoal and tr.

---

Required & Recommended Identifiers

These identifiers must be mapped to Convert in order for successful user matching to occur. Without these IDs, any events sent to Convert will be rejected. For your convenience, required and recommended IDs are mapped as Global parameters to ensure they are added to every event.

---

Additional Convert Documentation

Convert - New Tracking Structure - Advanced Integrations