Підключення Mixpanel до Elido

Elido надсилає подію link_click до API приймання Mixpanel щоразу, коли хтось натискає одне з ваших коротких посилань. Якщо ваша команда вже працює в Mixpanel, взаємодія з посиланнями відображається поруч із подіями вашого продукту без додавання скрипту відстеження будь-де.

Пересилаються лише кліки. Пересилання подій конверсій до Mixpanel заплановано.

Що вам потрібно

• Проєкт Mixpanel.
• Project Token проєкту. У моделі Mixpanel це не секрет, але Elido все одно зберігає його в зашифрованому вигляді.
• Знати регіон зберігання даних вашого проєкту: US, EU або India.
• Роль Admin або Owner у вашому робочому просторі Elido (дозвіл conversions.manage).

Крок 1: Знайдіть токен проєкту та регіон зберігання

1. Увійдіть до Mixpanel і відкрийте Settings → Project Settings.
2. У розділі Access Keys скопіюйте Project Token. Не використовуйте API Secret або обліковий запис сервісу: Elido їх не потребує.
3. Перевірте значення Data Residency проєкту. У Elido ви виберете те саме.

Крок 2: Підключіть Mixpanel в Elido

1. Перейдіть до Dashboard → Integrations → Mixpanel.
2. Натисніть Connect Mixpanel.
3. Вставте токен у поле Project Token.
4. Установіть Data residency відповідно до вашого проєкту:
   • United States надсилає дані до api.mixpanel.com (за замовчуванням).
   • EU надсилає дані до api-eu.mixpanel.com.
   • India надсилає дані до api-in.mixpanel.com.
5. Натисніть Save. Тепер на панелі відображається Connected, а токен замасковано, крім перших і останніх чотирьох символів.

Пересилання охоплює кожне посилання в робочому просторі: окремого перемикача для посилань немає. Воно починається приблизно протягом 5 хвилин після збереження, а зміна токена або регіону зберігання чи відключення набирає чинності протягом цього самого періоду.

Крок 3: Перевірте підключення

Натисніть Test connection. Elido надсилає одну подію link_click з elido_test: true і слагом _test, а під кнопкою показує відповідь Mixpanel: статус HTTP, хост, на який було надіслано запит, і тіло відповіді.

Успішний результат не є доказом. Кінцева точка Mixpanel /track не перевіряє, чи дійсний токен і чи розміщено проєкт у цьому регіоні зберігання, тому неправильний токен або неправильний регіон усе одно можуть пройти перевірку. Натомість помилка є справжньою: Mixpanel відхилив подію, і повідомлення пояснює причину.

Що надсилає Elido

Кожен клік стає однією подією:

{
  "event": "link_click",
  "properties": {
    "token": "your-project-token",
    "distinct_id": "elido-link-4711",
    "time": 1789000000,
    "workspace_id": 42,
    "link_id": 4711,
    "slug": "spring-26",
    "destination": "https://example.com/spring",
    "country": "DE",
    "device": "mobile",
    "ip": "203.0.113.7"
  }
}

• distinct_id складається з elido-link- та ID посилання, тому це одне значення для кожного посилання, а не для кожного відвідувача.
• time - час кліку в секундах Unix.
• destination - URL, на який було перенаправлено відвідувача.
• country - дволітерний код країни, а device - тип пристрою.
• ip - IP-адреса відвідувача; Mixpanel використовує її для власної геолокації.
• Тестова подія додає elido_test: true.

Пересилається кожен зафіксований клік, зокрема кліки, які аналітика Elido позначає як підозрілий трафік або трафік ботів. Якщо Mixpanel недоступний, Elido повторює доставку один раз через секунду, а потім видаляє цю подію: черги або повторного відтворення немає. Покроковий опис полів та ідеї для звітів наведено в матеріалі Події Mixpanel link_click.

Як працює distinct_id і які тут обмеження

Оскільки distinct_id визначається для посилання, кожен клік за тим самим посиланням рахується в Mixpanel як виконаний тим самим «користувачем». Це означає:

• Uniques для link_click рахують посилання, а не людей. Натомість використовуйте загальну кількість подій.
• Воронки від link_click до події реєстрації або покупки не об'єднаються, оскільки ці події належать іншому distinct_id.
• Обмеження Mixpanel на гарячий шард застосовується для кожного distinct_id, тому саме на одному дуже активному посиланні воно проявиться найперше.

Щоб сьогодні відстежувати шлях людини від кліку до реєстрації, додайте UTM-теги до URL призначення та дозвольте Mixpanel SDK на цільовій сторінці їх захопити, а потім ідентифікуйте користувача там у звичайний спосіб.

Усунення несправностей

Test connection проходить, але в Mixpanel нічого не відображається. Спочатку перевірте токен: знову скопіюйте його з Settings → Project Settings → Access Keys. Потім перевірте Data residency за налаштуванням проєкту. Обидві помилки проходять перевірку, як пояснено вище.

Test connection завершується помилкою. Прочитайте помилку та тіло відповіді під кнопкою: вони надходять безпосередньо від Mixpanel. Виправте токен або регіон зберігання, натисніть Update key, збережіть зміни та перевірте ще раз.

Події надходять не в той проєкт. Токени належать окремим проєктам. Якщо у вас їх кілька, переконайтеся, що скопіювали токен із потрібного проєкту.

Справжні кліки не відображаються одразу після підключення. Пересилання може початися лише приблизно через 5 хвилин. Після цього натисніть коротке посилання та перевірте перегляд Events.

Користувачі Mixpanel не збігаються з ідентифікованими вами користувачами. Це очікувано: distinct_id Elido визначається для посилання. Докладніше про обхідний шлях із UTM дивіться в розділі вище.