Подключение 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: подключите интеграцию в 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 описан в разделе выше.