# Mixpanel

## Pipeline Concepts

Before setting up the Pipeline, learn about datasource concepts [here](https://docs.sprinkledata.com/product/ingesting-your-data/pipelines)

## Step by Step Guide

### STEP-1: Configure Connection

To learn about Connection, refer [here](https://docs.sprinkledata.com/product/ingesting-your-data/pipelines)

* Log into Sprinkle application
* Navigate to Ingest -> Connections Tab -> New Connection ->&#x20;
* Select Mixpanel&#x20;
* Provide all the mandatory details

  * *Name*: Name to identify this connection
  * *API Secret*&#x20;

  Select the **Project** in the top right --> **Settings** --> **Project Settings** --> **Access Key** --> **API Secret**

  * *Start Date*
  * *Advance Settings : Refer* [*here*](#advanced-connection-settings)
* Test Connection&#x20;
* Create

### STEP-2: Configure Pipeline

To learn about Pipeline, refer [here](https://docs.sprinkledata.com/product/ingesting-your-data/pipelines)

* Navigate to Ingest -> Pipeline Tab -> Add ->&#x20;
* Select Mixpanel
* Provide the name -> Create
* **Connection Tab**:&#x20;
  * From the drop-down, select the name of connection created in STEP-2
  * Update

### STEP-3: Create Dataset

**Datasets Tab**: To learn about Dataset, refer [here](https://docs.sprinkledata.com/product/ingesting-your-data/pipelines). Add Dataset for each report/dataset that you want to integrate, providing following details

* *Table Type (Required)*
  * *Preset*
    * *Preset Name*: Select People from the dropdown
  * *Custom Events*
    * *Set of Events (Optional)*: Comma separated names of events. If not provided it will fetch records for all events.
  * *Query*
    * *JQL*
* *Destination Schema* (Required) : Data warehouse schema where the table will be ingested into
* *Destination Table name* (Required) : It is the table name to be created on the warehouse. If not given, sprinkle will create like ds\_\<datasourcename>\_\<tablename>
* *Destination Create Table Clause*: Provide additional clauses to warehouse-create table queries such as clustering, partitioning, and more, useful for optimizing DML statements. [Learn more](https://docs.sprinkledata.com/product/ingesting-your-data/pipelines/databases/features/destination-create-table-clause) on how to use this field.
* Create

### STEP-4: Run and schedule Ingestion

In the **Ingestion Jobs** ta&#x62;**:**

* Trigger the Job, using Run button
* To schedule, enable Auto-Run. Change the frequency if needed

### Advanced Connection Settings

* **API Read Timeout (In seconds) :** Maximum time of inactivity between two data packets when waiting for the server's response. The default value is 30 seconds.
* **API Connection Timeout (In seconds) :**  Time period within which a connection between a client and a server must be established.
* **Retry Limit :**  Number of retries allowed when an API call fails. For example if an API call fails and retry limit is 5 then it will check 5 times for that API call and if it succeeded then it will stop checkin&#x67;**.**
* **Retry Sleep Time (In milliseconds) :** Given time, after which retry should happen in case an API call fails.
* **Version :**  It gives information about the version of MixPanel API being used.
* **Incremental Batch Size (In days) :**  No. of days in one batch for which data is being downloaded during incremental ingestion.
