Knowledge Center

Knowledge Center > Insights > Zuora Connect Apps for Insights > Using the Mixpanel to Insights Connector

Using the Mixpanel to Insights Connector

The Mixpanel to Insights Connector enables you to track your Mixpanel user events in Insights.

Before you can use the Mixpanel to Insights Connector, your organization must purchase the Mixpanel to Insights Connector in the Zuora Connect app marketplace. To find out whether your organization's purchase of Insights includes Zuora Connect apps at no additional cost, contact your Zuora representative.

See Connect for more information about the Zuora Connect app marketplace.

How the Mixpanel to Insights Connector Works

The Mixpanel to Insights Connector synchronizes data from your Mixpanel project to your Insights stream. Every time the Mixpanel to Insights Connector performs a synchronization, an Insights account or user event is created for each Mixpanel user event that occurred during the past day.

The Mixpanel to Insights Connector runs inside an Insights Connector task. The Insights Connector is a generic Zuora Connect app that can run several different apps as separate tasks. You do not need to purchase the Insights Connector separately.

When you create an instance of the Insights Connector, you specify the following aspects of how the Mixpanel to Insights Connector runs:

  • Which Mixpanel project to retrieve data from
  • Which Insights stream to update
  • The schedule to synchronize data from Mixpanel to Insights

Preliminary Configuration

Zuora must configure a Batch API data source to receive the data that the Mixpanel to Insights Connector will send to your Insights stream. To have a Batch API data source configured to receive Mixpanel data, submit a request at Zuora Global Support. Zuora Global Support will process your request then provide the Batch API token for the new data source. You will need the Batch API token when you set up the Mixpanel to Insights Connector.

If you want the Mixpanel to Insights Connector to create account events in your Insights stream, you must use the mixpanel.alias() call to assign a Zuora account ID to each user in your Mixpanel project. This enables the Mixpanel to Insights Connector to identify the Insights account corresponding to each Mixpanel user.

If you want the Mixpanel to Insights Connector to create user events in your Insights stream, you must use the mixpanel.alias() call to assign an Insights user ID to each user in your Mixpanel project. This enables the Mixpanel to Insights Connector to identify the Insights user corresponding to each Mixpanel user. If Insights receives an event for an unrecognized user, Insights will create a new user.

See the Mixpanel documentation for how to use the mixpanel.alias() call.

Set up the Mixpanel to Insights Connector

Use the following steps to set up the Mixpanel to Insights Connector:

  1. Create a Zuora Connect login for Insights.

    The Zuora Connect login enables the Mixpanel to Insights Connector to authenticate to Insights via the Batch API. It is recommended to name the Zuora Connect login "Insights Batch API target for Mixpanel connector."

    You need to create a Zuora Connect login even if you have previously created a Zuora Connect login that specifies Batch API credentials for your Insights stream. This is because each Batch API token is generated specifically for a particular external system, and cannot be used to send data to Insights from a different external system.

  2. Create a Zuora Connect login for Mixpanel.

    The Zuora Connect login enables the Mixpanel to Insights Connector to authenticate to Mixpanel.

    To complete this step, you will need the API secret for your Mixpanel project. The API secret is listed in your Mixpanel project's settings area.

  3. Create an Insights Connector task.

After you have set up the Mixpanel to Insights Connector, you can monitor the synchronizations that the Mixpanel to Insights Connector performs.

Create an Insights Connector Task

The Mixpanel to Insights Connector runs inside an Insights Connector task.

To create and start an Insights Connector task:

  1. In Zuora Connect, navigate to My Connect > Tenants.

    The Tenant Logins page opens.

  2. Locate the Zuora Connect login that you created for the Insights Batch API, then click Apps.

    For example:

    The Insights Connector page opens.

  3. Click New.

    The "Insights Connector - New Configuration" dialog box opens.

  4. Enter the following information in the "Insights Connector - New Configuration" dialog box:

    • Name - The name that you will use to identify the task in Zuora Connect

    • Run Mode - Mixpanel

    • Execution - Scheduled

      If you select External instead of Scheduled, the Mixpanel to Insights Connector will only synchronize data when you initiate a synchronization. You can initiate a synchronization by clicking Sync on Demand in the Mixpanel to Insights Connector, or via the API that the Insights Connector provides.

    • Source - The Zuora Connect login that you created for Mixpanel

    • Target - The Zuora Connect login that you created for the Insights Batch API

    For example:

  5. Select the Schedule tab.

  6. Use the Timezone field and the schedule builder to set how frequently to synchronize data.

    It is recommended to set a daily schedule. To ensure that Insights displays the latest Mixpanel data as soon as possible, it is recommended to set synchronization to take place shortly before all Insights batch uploads start processing. See Insights Batch API for more information about batch uploads.

    The Interval field displays the specified schedule as a CRON expression.

  7. Click Create.

Zuora Connect creates and starts an Insights Connector task. The Mixpanel to Insights Connector is running inside the task.

You can use the  task menu to manage the Insights Connector task. If you stop the task, the Mixpanel to Insights Connector will stop running and no data will be synchronized. You cannot restart a stopped task, but you can start a new task with the same configuration by cloning the task.

Monitor the Mixpanel to Insights Connector

The Mixpanel to Insights Connector lists the synchronizations that have been performed.

To open the Mixpanel to Insights Connector, locate the task that you created in Create an Insights Connector Task, then select Launch from the  task menu. To immediately initiate a synchronization click Sync on Demand.

For completed synchronizations, you can download a JSON description of the data that was synchronized from Mixpanel to Insights. These JSON descriptions are currently retained indefinitely.

If a synchronization starts but does not complete, the Mixpanel to Insights Connector will retry the synchronization up to 25 times.

If the status of a synchronization is Error, submit a request at Zuora Global Support.

Last modified
20:33, 28 Jun 2017

Tags

This page has no custom tags.

Classifications

(not set)