Convizit-Amplitude Integration Guide

A. Introduction

For current or prospective Amplitude customers who prefer to avoid the often lengthy and complex process of manually instrumenting events, Convizit offers an appealing alternative. With no need for a tagging plan or manual event coding, Convizit’s AI-driven solution automatically collects user behavior data in websites and web applications. Convizit sends this event data – already named and property-enriched – into Amplitude for reporting and analysis.

After adding Convizit’s JavaScript tag to a website/application, no further development resources or technical knowledge are required (e.g., there is no need to touch JavaScript or CSS selectors). A friendly visual interface makes it is easy for you to control which events are sent to Amplitude, how they are named and which properties they contain.

On-demand historical data backfill allows additional behavioral analysis at any time, by sending additional historical data into Amplitude, even if you initially decided not to receive those events and/or properties. And Convizit handles ongoing website changes automatically so that funnels and reports don’t break; no event tracking maintenance is required.

Convizit’s direct integration with Amplitude allows you to quickly and easily realize the full potential of the platform within days of deployment, with little or no manual effort required. This document describes how this integration works.

B. Getting Started

This is the process to begin receiving event data from your website/application into Amplitude via Convizit:

1. Add the Convizit tag to your website or application

Place the JavaScript snippet you received from Convizit at the beginning of the <head> … </head> section of every page of your website. Details about doing this can be found here: Deploying the Convizit Tag

As soon as the Convizit tag is operational in your website/application, Convizit will begin collecting, naming and structuring the user behavior data.

2. Provide Convizit with some information

Send your Convizit contact person your Amplitude Application ID, Application name and API key (to find these details, see Find your API Credentials).

3. Customize the data that Convizit collects (OPTIONAL)

4. Convizit will deliver your user behavior data into Amplitude

  • Convizit will typically begin sending data into Amplitude within about one week from the time the Convizit tag is added to your website. Low-traffic sites might take longer (Convizit’s AI needs a certain amount of actual user traffic in order to accurately model a website or application).
  • Convizit sends data into Amplitude every 30 minutes. 
  • If, at any time, you wish to pause data delivery into Amplitude, inform your Convizit contact person.

5. Validate that you are receiving data from Convizit

You can see the events arriving from Convizit in Amplitude in the User Look-Up page. Note that it can take a few additional minutes for the data to appear on this page after it was received from Convizit.

If you also have other sources of event data in Amplitude, follow these steps to confirm that events from Convizit’s are arriving in Amplitude:

  • Navigate to the User Look-Up page and click a recent User ID.
  • Scroll down into the Event Stream area and click the Raw button.
  • You will know that you are looking at an event delivered to Amplitude from Convizit with you see “source”: “Convizit” in the JSON code:

C. Customizing the Data Delivered by Convizit into Amplitude

Using Convizit’s visual interface, you can easily understand the data that Convizit is capturing, and adjust how events and properties are delivered into Amplitude:

  • Review all the events and properties that Convizit is capturing.
  • Select which events to receive in Amplitude.
  • Change the names of events and event properties.
  • Exclude specific event properties from some/all events.

D. The Amplitude Fields Populated by Convizit

For more technical users familiar with Amplitude, these are the specific fields that Convizit populates in Amplitude for each delivered event:

insert_id Convizit’s unique identifier of the event
user_id Convizit’s unique identifier of the website visitor
time Timestamp of the event
event_type The name of the event (e.g., “Add to cart”, “Size chart click”)
event_properties An array of customizable event-specific properties as key:value pairs (e.g., “Add to cart” event properties might include “Product name”, “Product price”, “Selected color” and “Quantity”)
user_properties An array of key:value pairs when available: customerId, GoogleId, FacebookId
utm_source UTM Source parameter provided for the session, if available
utm_medium UTM Medium parameter provided for the session, if available
utm_campaign UTM Campaign parameter provided for the session, if available
utm_term UTM Term parameter provided for the session, if available
utm_content UTM Content parameter provided for the session, if available
deviceType Visitor’s device type (e.g., desktop, tablet, mobile)
plan.source Equal to “Convizit” (allows identifying and segmenting Convizit-delivered data in Amplitude reports and analyses)
Additional data included as properties with each event:
platform Platform of the user’s device
os_name The name of the mobile operating system or browser
os_version The version of the mobile operating system or browser
device_brand The brand of the user’s device
ip The user’s IP address
     country
     region
     city
Automatically populated by Amplitude if IP address is supplied
This website uses cookies. Cookies remember you so we can give you a better online experience. Learn more.