Merge pull request #6172 from segmentio/thomas/mixpanel-cohorts

Add slug override and cleanup folders

Author: pwseg

src/_data/catalog/slugs.yml

@@ -10,6 +10,8 @@ sources:
     override: "shopify-fueled"
   - original: "alloy-flow"
     override: "alloyflow"
+  - original: "mixpanel-cohorts"
+    override: "mixpanel-cohorts-source"  
 destinations:
   - original: "vwo-cloud-mode-actions"
     override: "actions-vwo-cloud"

src/connections/sources/catalog/cloud-apps/mixpanel-cohorts/images/connect.png renamed to src/connections/sources/catalog/cloud-apps/mixpanel-cohorts-source/images/connect.png

@@ -1,6 +1,61 @@
 ---
 title: Mixpanel Cohorts Source
-hidden: true
+id: RxxzG3Dyva
 ---
-
 {% include content/source-region-unsupported.md %}
+
+[Mixpanel Cohorts](https://help.mixpanel.com/hc/en-us/articles/115005708186-Cohorts-Overview-){:target="_blank”} are groups of users defined by a set of criteria. The Mixpanel Cohorts Source allows you to export Cohorts of users from Mixpanel to Segment so that you can better target users across many downstream connections. You can sync Cohorts of users to your Segment-connected raw data warehouses and downstream destinations that accept Segment identify events.
+
+This source is maintained by Mixpanel. For any issues with the source, contact the [Mixpanel Support team](https://help.mixpanel.com/hc/en-us/requests/new){:target="_blank"}.
+
+## Getting Started
+
+1. From your workspace's [Sources catalog page](https://app.segment.com/goto-my-workspace/sources/catalog){:target="_blank"} click **Add Source**.
+2. Search for **Mixpanel Cohorts** in the Sources Catalog and click **Add Source**.
+3. On the next screen, give the Source a nickname and configure any other settings.
+4. From the new Source's Overview page, copy the Segment WriteKey
+5. To export users from Mixpanel to Segment, in Mixpanel first Connect Your segment workspace in  integrations page add add the copied WriteKey in the **API KEY** field and give the connection a desired name in **CONNECTOR NAME** field. ![Add the connector name](images/connect.png)
+6. Once connected you can go to mixpanel cohorts page and export any cohort to the connection.![Export cohorts](images/export.png)
+7. Once configured, Cohorts sync to Segment based on the sync schedule in Mixpanel. For more information go to [Mixpanel Segment Integration documentation.](https://help.mixpanel.com/hc/en-us/articles/4408988683156-Segment-Integration){:target="_blank"}
+
+
+
+## The Cohort sync process
+
+Mixpanel sets a property on the user's profile in Segment indicating whether they are currently part of the cohort.
+
+The following identify call to Segment when a user enters the cohort:
+```json
+{
+  "type": "identify",
+  "traits": {
+    "Mixpanel - <Cohort Name in Mixpanel>": true,
+  },
+  "userId": "[email protected]" // mixpanel uses the distinct_id property here
+}
+```
+
+
+Mixpanel sends the following identify call when a user exits the cohort:
+```json
+{
+  "type": "identify",
+  "traits": {
+    "Mixpanel - <Cohort Name in Mixpanel>": false,
+  },
+  "userId": "[email protected]" // mixpanel uses the distinct_id property here
+}
+```
+
+### Sync Mixpanel Cohorts with Engage
+
+To send your Cohorts data to Engage, connect a Mixpanel Cohorts source in the Unify settings.
+
+To connect Mixpanel Cohorts:
+
+1. Navigate to **Unify > Unify settings** and select the **Profile sources** tab.
+2. Click **Connect source** to open the Connect sources window.
+3. Select **Replay data** to replay the last month of data into Engage.
+4. Locate Mixpanel Cohorts and click **Connect source**.
+
+Mixpanel Cohorts data will begin to flow into Engage.