Відстеження конверсій

Піксель повідомляє вам про те, що стався клік. Конверсія повідомляє вам про те, що клік приніс вам гроші. Elido обробляє вебхуки Stripe та Shopify, пов’язує кожне замовлення з початковим коротким посиланням і відображає дохід на тій самій панелі приладів, що й загальну кількість кліків.

Процес наступний:

1. Додайте кінцеву точку вебхука в Stripe або Shopify, що вказує на Elido.
2. Позначте свої сесії оформлення замовлення / замовлення ідентифікатором elido_link_id посилання, яке привело клієнта.
3. Зчитуйте атрибутовані конверсії через API.

1. Налаштуйте секрет вебхука

Кожен провайдер надає вам секрет підпису (signing secret) під час створення кінцевої точки вебхука. Збережіть обидва через кінцеву точку пікселів (вона також слугує сховищем секретів):

curl -X PUT \
  https://api.elido.app/v1/workspaces/1/pixels \
  -H "Authorization: Bearer $ELIDO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "stripe_webhook_secret": "whsec_a1b2c3...",
    "shopify_webhook_secret": "shpss_a1b2c3..."
  }'

Вебхуки без налаштованого секрету повертають 401.

2. Спрямуйте провайдера на Elido

У вашій панелі приладів Stripe додайте кінцеву точку:

URL:    https://api.elido.app/v1/workspaces/1/conversions/stripe
Events: checkout.session.completed, payment_intent.succeeded

У Shopify додайте вебхук orders/paid:

URL:     https://api.elido.app/v1/workspaces/1/conversions/shopify
Format:  JSON
Topic:   Order paid

Elido перевіряє підписи (Stripe-Signature та X-Shopify-Hmac-Sha256 відповідно), використовуючи секрет з кроку 1, і відхиляє невідповідності з помилкою 401.

3. Тегуйте сесії оформлення замовлення

Надсилайте початковий link_id разом із замовленням, щоб Elido міг атрибутувати дохід.

Stripe

Встановіть metadata.elido_link_id або client_reference_id при створенні сесії оформлення замовлення:

await stripe.checkout.sessions.create({
  mode: "payment",
  line_items: [...],
  success_url: "https://example.com/thanks",
  cancel_url: "https://example.com/cart",
  metadata: { elido_link_id: "42" },
});

Shopify

Використовуйте атрибути приміток (note attributes) - заповнюйте їх у кошику з вітрини:

{% comment %} заповнити з параметра URL, наприклад ?elido=42 {% endcomment %}
<input type="hidden" name="attributes[elido_link_id]" value="{{ elido_id }}">

Elido шукає note_attributes[].name == "elido_link_id" і витягує відповідне value.

Якщо link_id відсутній, конверсія все одно фіксується, але без атрибуції - link_id та campaign_id зберігаються як null.

4. Зчитування конверсій

curl 'https://api.elido.app/v1/workspaces/1/conversions?limit=50' \
  -H "Authorization: Bearer $ELIDO_TOKEN"

{
  "conversions": [
    {
      "id": 4711,
      "platform": "stripe",
      "external_id": "cs_test_a1b2c3",
      "link_id": 42,
      "campaign_id": 7,
      "revenue_cents": 4900,
      "currency": "USD",
      "customer_email": "alice@example.com",
      "converted_at": "2026-05-01T12:00:00Z"
    }
  ],
  "limit": 50,
  "offset": 0
}

Пагінація здійснюється за допомогою limit (≤100, за замовчуванням 50) + offset. Картки підсумків:

curl https://api.elido.app/v1/workspaces/1/conversions/summary \
  -H "Authorization: Bearer $ELIDO_TOKEN"

{
  "total_revenue_cents": 1234500,
  "currency": "USD",
  "count": 211,
  "average_order_cents": 5851
}

Що атрибутується

Коли надходить вебхук, Elido зчитує elido_link_id з метаданих / атрибутів приміток і:

• Зберігає його в конверсії як link_id.
• Шукає campaign_id посилання і також зберігає його - атрибуція кампанії є похідною, вам не потрібно тегувати кампанії окремо.
• Виконує дедуплікацію за (workspace_id, platform, external_id), щоб повторні доставки не враховувалися двічі.

На сьогодні немає інтерфейсного тегувальника - вам потрібно самостійно заповнювати метадані в інтеграції оформлення замовлення. Більшість команд фіксують параметр URL ?elido=... на цільовій сторінці та передають його в оформлення замовлення.

Довідка по кінцевих точках