diff --git a/scripts/catalog_papi.js b/scripts/catalog_papi.js index 2664749a51..c03edb4e85 100644 --- a/scripts/catalog_papi.js +++ b/scripts/catalog_papi.js @@ -166,8 +166,7 @@ const updateSources = async () => { const hiddenSources = [ 'amp', 'factual-engine', - 'twilio-event-streams-beta', - 'mixpanel-cohorts' + 'twilio-event-streams-beta' ] sources.forEach(source => { diff --git a/src/_data/catalog/destination_categories.yml b/src/_data/catalog/destination_categories.yml index 5fba4baa42..ea6b02074d 100644 --- a/src/_data/catalog/destination_categories.yml +++ b/src/_data/catalog/destination_categories.yml @@ -1,5 +1,5 @@ # AUTOGENERATED FROM PUBLIC API. DO NOT EDIT -# destination categories last updated 2022-01-13 +# destination categories last updated 2022-01-14 items: - display_name: A/B Testing slug: a-b-testing diff --git a/src/_data/catalog/destinations.yml b/src/_data/catalog/destinations.yml index a297c0c44b..7279fa2f63 100644 --- a/src/_data/catalog/destinations.yml +++ b/src/_data/catalog/destinations.yml @@ -1,5 +1,5 @@ # AUTOGENERATED FROM PUBLIC API. DO NOT EDIT -# destination data last updated 2022-01-13 +# destination data last updated 2022-01-14 items: - destination_id: 60b5d0a01f3726b85dc05aab display_name: 2mee diff --git a/src/_data/catalog/source_categories.yml b/src/_data/catalog/source_categories.yml index 444126ff7e..8d75538f33 100644 --- a/src/_data/catalog/source_categories.yml +++ b/src/_data/catalog/source_categories.yml @@ -1,5 +1,5 @@ # AUTOGENERATED FROM PUBLIC API. DO NOT EDIT -# source cateogries last updated 2022-01-13 +# source cateogries last updated 2022-01-14 items: - display_name: A/B Testing slug: a-b-testing diff --git a/src/_data/catalog/sources.yml b/src/_data/catalog/sources.yml index ad0d4d8a65..9f89446c50 100644 --- a/src/_data/catalog/sources.yml +++ b/src/_data/catalog/sources.yml @@ -1,5 +1,5 @@ # AUTOGENERATED FROM PUBLIC API. DO NOT EDIT -# sources last updated 2022-01-13 +# sources last updated 2022-01-14 items: - id: 8HWbgPTt3k display_name: .NET @@ -607,7 +607,7 @@ items: display_name: Mixpanel Cohorts slug: mixpanel-cohorts url: connections/sources/catalog/cloud-apps/mixpanel-cohorts - hidden: true + hidden: false source_type: cloud-app description: >- Mixpanel helps teams get answers to product questions by providing fast, diff --git a/src/connections/sources/catalog/cloud-apps/mixpanel-cohorts/images/connect.png b/src/connections/sources/catalog/cloud-apps/mixpanel-cohorts/images/connect.png new file mode 100644 index 0000000000..69632dd9b2 Binary files /dev/null and b/src/connections/sources/catalog/cloud-apps/mixpanel-cohorts/images/connect.png differ diff --git a/src/connections/sources/catalog/cloud-apps/mixpanel-cohorts/images/export.png b/src/connections/sources/catalog/cloud-apps/mixpanel-cohorts/images/export.png new file mode 100644 index 0000000000..43bb0a6155 Binary files /dev/null and b/src/connections/sources/catalog/cloud-apps/mixpanel-cohorts/images/export.png differ diff --git a/src/connections/sources/catalog/cloud-apps/mixpanel-cohorts/index.md b/src/connections/sources/catalog/cloud-apps/mixpanel-cohorts/index.md index f68cee9afe..25a44d1f72 100644 --- a/src/connections/sources/catalog/cloud-apps/mixpanel-cohorts/index.md +++ b/src/connections/sources/catalog/cloud-apps/mixpanel-cohorts/index.md @@ -1,4 +1,47 @@ --- title: 'Mixpanel Cohorts Source' -hidden: true ---- \ No newline at end of file +--- + + +[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) 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 - ": true, + }, + "userId": "user@email.com" // mixpanel uses the distinct_id property here +} +``` + + +Mixpanel sends the following identify call when a user exits the cohort: +```json +{ + "type": "identify", + "traits": { + "Mixpanel - ": false, + }, + "userId": "user@email.com" // mixpanel uses the distinct_id property here +} +```