Mixpanel

Mixpanel — мощный сервис продуктовой аналитики. Его система отслеживания на основе событий помогает продуктовым командам получать ценные данные о лучших стратегиях привлечения, конверсии и удержания пользователей на разных платформах. Эта интеграция позволяет передавать все события Adapty в Mixpanel. В результате вы получите более полное представление о вашем подписочном бизнесе и действиях пользователей. Adapty предоставляет полный набор данных, позволяющий отслеживать события подписки из сторов в одном месте. С Adapty вы легко увидите, как ведут себя ваши подписчики, поймёте их предпочтения и сможете использовать эту информацию для целевых и эффективных коммуникаций с ними.

Как настроить интеграцию с Mixpanel

1. Откройте страницу Integrations -> Mixpanel в дашборде Adapty.
2. Включите переключатель и введите Mixpanel Token. Вы можете указать токен для всех платформ или ограничить его конкретными платформами, если хотите получать данные только от определённых.
3. Задайте Mixpanel Data Residency в соответствии с вашим проектом Mixpanel. Это поле обязательно и по умолчанию установлено в US. Выберите US для эндпоинта api.mixpanel.com или Europe для api-eu.mixpanel.com.

Получение токена Mixpanel

Чтобы получить Mixpanel Token:

1. Войдите в ваш Mixpanel Dashboard.
2. Откройте Settings и выберите Organization Settings.

3. На левой боковой панели перейдите в Projects и выберите ваш проект.

Как работает интеграция

Adapty автоматически сопоставляет нужные свойства событий — например, ID пользователя и выручку — с нативными свойствами Mixpanel. Это обеспечивает точное отслеживание и отчётность по событиям, связанным с подписками.

Кроме того, Adapty накапливает данные о выручке по каждому пользователю и обновляет их свойства профиля, включая subscription state и subscription product ID. После получения события Mixpanel обновляет соответствующие поля в реальном времени.

События и теги

Ниже учётных данных находятся три группы событий, которые можно отправлять в Mixpanel из Adapty. Просто включите нужные. Полный список событий, доступных в Adapty, смотрите здесь.

Мы рекомендуем использовать названия событий по умолчанию, которые предоставляет Adapty. Однако вы можете изменить их по своему усмотрению.

Настройка SDK

Используйте метод .setIntegrationIdentifier(), чтобы задать mixpanelUserId. Если значение не задано, Adapty использует ваш пользовательский ID (customerUserId) или, если он равен null, — Adapty ID. Убедитесь, что ID пользователя, который вы используете для отправки данных в Mixpanel из приложения, совпадает с тем, что вы отправляете в Adapty.

do {
    try await Adapty.setIntegrationIdentifier(
        key: "mixpanel_user_id",
        value: Mixpanel.mainInstance().distinctId
    )
} catch {
    // handle the error
}

let builder = AdaptyProfileParameters.Builder()
            .with(mixpanelUserId: Mixpanel.mainInstance().distinctId)

Adapty.updateProfile(params: builder.build())

Adapty.setIntegrationIdentifier("mixpanel_user_id", mixpanelAPI.distinctId) { error ->
    if (error != null) {
        // handle the error
    }
}

final mixpanel = await Mixpanel.init("Your Token", trackAutomaticEvents: true);
final distinctId = await mixpanel.getDistinctId();

try {
    await Adapty().setIntegrationIdentifier(
        key: "mixpanel_user_id",
        value: distinctId,
    );
} on AdaptyError catch (adaptyError) {
    // handle the error
} catch (e) {
    // handle the error
}

using AdaptySDK;

var distinctId = Mixpanel.DistinctId;

if (distinctId != null) {
  Adapty.SetIntegrationIdentifier(
    "mixpanel_user_id",
    distinctId,
    (error) => {
    // handle the error
  });
}

// Если в вашем приложении уже есть общий экземпляр Mixpanel, используйте его.
const trackAutomaticEvents = true;
const mixpanel = new Mixpanel('YOUR_PROJECT_TOKEN', trackAutomaticEvents);
await mixpanel.init();

// Это текущий distinct_id Mixpanel (генерируется автоматически или задаётся через mixpanel.identify(...))
const mixpanelUserId = await mixpanel.getDistinctId();

try {
    await adapty.setIntegrationIdentifier("mixpanel_user_id", mixpanelUserId);
} catch (error) {
    // обработайте `AdaptyError`
}

Структура события Mixpanel

Adapty отправляет события в Mixpanel с помощью метода track. Свойства события имеют следующую структуру:

{
  "event": "subscription_renewed",
  "properties": {
    "ip": 0,
    "time": 1709294400,
    "$insert_id": "123e4567-e89b-12d3-a456-426614174000",
    "vendor_product_id": "yearly.premium.6999",
    "original_transaction_id": "GPA.3383...",
    "currency": "USD",
    "environment": "Production",
    "store": "app_store",
    "purchase_date": "2024-03-01T12:00:00.000000+0000"
  }
}

Где:

Обновления профиля пользователя

Adapty также обновляет профиль пользователя в Mixpanel с помощью people_set, используя следующие свойства: