Пересилання конверсій

Відстеження конверсій повідомляє нам, що клік перетворився на дохід. Пересилання конверсій передає цей факт назад рекламним сервісам - Meta Conversions API, GA4 Measurement Protocol та Mixpanel server-track - щоб алгоритми оптимізації бачили його, навіть якщо піксель браузера не спрацював.

Навіщо це потрібно? Атрибуція лише за допомогою пікселя втрачає 20-40% конверсій через Safari ITP, блокувальники реклами та банери згоди. Пересилання на стороні сервера закриває більшу частину цього розриву, оскільки воно запускається з вашого бекенду вже після того, як покупка відбулася.

Процес виглядає так:

Захопіть click_id, який Elido повернув під час оригінального перенаправлення.
Збережіть його у вашому записі замовлення або підписки.
Коли відбувається конверсія, надішліть POST-запит на /v1/conversions з id кліку.
Elido дублює подію через server-to-server до всіх підключених сервісів.

1. Захопіть id кліку

Кожна відповідь на перенаправлення містить заголовок X-Elido-Click-Id. SDK виводять його в тому самому об’єкті відповіді; прямі HTTP-запити також працюють:


curl -sI https://elido.me/launch | grep -i click-id
# X-Elido-Click-Id: clk_01HYZ7T8WV6KQX3M

Збережіть цей id на сторінці призначення, в ідеалі у first-party cookie (elido_click_id, TTL 90 днів), щоб ви могли прочитати його під час оформлення замовлення.

2. Налаштуйте вашу кінцеву точку конверсій


curl -X PUT \
  https://api.elido.app/v1/workspaces/1/conversion-forwarding \
  -H "Authorization: Bearer $ELIDO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "meta_capi": {
      "pixel_id": "1234567890",
      "access_token": "EAA…",
      "test_event_code": null
    },
    "ga4_mp": {
      "measurement_id": "G-ABC123",
      "api_secret": "abc_def_ghi"
    },
    "mixpanel": {
      "project_token": "pm_…",
      "service_account": "sa@team.mixpanel.com"
    }
  }'

Ви можете налаштувати будь-яку підмножину; пропущені сервіси будуть ігноруватися автоматично.

3. POST конверсій


curl -X POST \
  https://api.elido.app/v1/conversions \
  -H "Authorization: Bearer $ELIDO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "click_id":   "clk_01HYZ7T8WV6KQX3M",
    "event_name": "purchase",
    "event_id":   "ord_98231",
    "value":      89.00,
    "currency":   "EUR",
    "user": {
      "email":  "shopper@example.com",
      "phone":  "+4915123456789",
      "external_id": "cust_5128"
    }
  }'

event_id - це ваш ключ ідемпотентності: один і той самий id, надісланий двічі, дедуплікується як в Elido, так і на стороні Meta/GA4/Mixpanel. Використовуйте id замовлення, id підписки або будь-який стабільний ідентифікатор.

Поля ідентифікації користувача хешуються (SHA-256) перед пересиланням до Meta та GA4. Mixpanel отримує лише сирий external_id.

4. Що пересилається

Призначення	Кінцева точка	Хешовано	Включає UTM
Meta CAPI	`graph.facebook.com/v19.0/{pixel}/events`	email, phone	так (як `custom_data`)
GA4 MP	`google-analytics.com/mp/collect`	client_id (хешовано)	так (як параметри події)
Mixpanel	`api.mixpanel.com/track`	ні	так (як властивості події)

UTM-мітки беруться з рядка кліку, що відповідає click_id, тому переслана подія завжди містить оригінальний контекст кампанії - навіть якщо користувач годину ходив по сайту перед оформленням замовлення.

5. Перевірте повний цикл

Вкладка Конверсії → Пересилання на панелі керування показує по одному рядку для кожної пересланої події з призначенням, кодом відповіді, затримкою та сирим корисним навантаженням апстріму. Невдалі спроби пересилання повторюються з експоненційною затримкою протягом 24 годин.

Зокрема для Meta, встановіть test_event_code і підтвердьте, що події надходять в Events Manager → Test Events, перш ніж запускати робочий трафік.

6. Граничні випадки

Помилка пошуку кліку - якщо click_id не відповідає відомому кліку (друкарська помилка, термін зберігання закінчився, неправильний робочий простір), конверсія все одно записується для робочого простору, але пересилається з порожнім UTM-контекстом. Корисно для атрибуції “для всього”.
Повернення коштів - надішліть POST-запит з тим самим event_id та event_name: "refund". Meta та GA4 розглядають це як негативну конверсію; Mixpanel записує окрему подію, яку ви можете відняти у своїх воронках.
Multi-touch - Elido зберігає кліки кожного користувача протягом 30 днів. Стандартна атрибуція - last-touch у межах цього вікна; встановіть attribution_model робочого простору на first_touch або position_based для альтернативних варіантів.

Дивіться також

Відстеження конверсій - вхідна сторона (Stripe / Shopify вебхуки)
Шаблони UTM - що насправді прикріплюється до пересланої події
Вебхуки - ширша система пікселів