Meta Conversions API для коротких ссылок

Сегодня Elido не пересылает конверсии в Meta Conversions API. Если вы пришли сюда из списка интеграций в поисках переключателя, его нет, и лучше сказать об этом сразу, чем вести вас по настройке, которая никуда не приведёт. Ниже: что Elido действительно записывает, что требует документация Meta (дата обращения 2026-10-25) и как самостоятельно собрать серверный вызов, с короткой ссылкой на пути или без неё.

Коротко: Elido даёт клики по каждой ссылке и, для Shopify и Stripe, выручку по каждой ссылке. Meta нужно событие с event_id, хешированными данными клиента и, в идеале, ID клика fbc. Собирать всё это вам.

Что Elido делает и не делает для Meta сегодня

Состояние кода, проверенное в репозитории 2026-10-25:

• ID пикселя Meta: рабочее пространство может его хранить. Он используется для браузерного пикселя на промежуточных и splash-страницах Elido. Это тег на стороне браузера, не CAPI.
• Серверный вызов Meta: в конвейере кликов есть ветка кода, которая отправляла бы PageView с IP и user agent. Она запускается только при наличии и ID пикселя, и токена доступа, а настройки токен не сохраняют, поэтому она никогда не срабатывает.
• Конверсии: заказы поступают только через вебхуки Shopify и Stripe и привязываются к ссылке по значению elido_link_id, которое вы передаёте. Публичного эндпоинта конверсий нет, как нет и заголовка или cookie с ID клика.
• fbclid: Elido его не захватывает и не пересылает.

Страница функции отслеживания конверсий описывает ту же модель вебхуков. Любой более старый материал, обещающий пересылку в Meta одним вызовом, описывает план, а не продукт.

Демо-воркспейс с синтетическими примерными данными, а не результаты клиентов.

Этот экран полезен и рядом с Meta. Выручка по кампаниям из ваших собственных заказов проверяет то, что заявляет Ads Manager. Две цифры редко совпадают до цента.

Как работает Meta Conversions API

Согласно документации Meta по Conversions API (дата обращения 2026-10-25), вы отправляете POST на https://graph.facebook.com/{API_VERSION}/{PIXEL_ID}/events с токеном доступа. В текущем примере документации используется v26.0. Несколько ограничений, которые стоит знать до написания кода:

• В одном запросе может быть до 1 000 событий.
• event_time может быть старше не более чем на 7 дней. Если хоть одно событие в пакете старше, Meta отклоняет весь запрос.
• Отправляйте event_id с каждым событием. Если Meta видит одинаковые event_id и event_name дважды, она сохраняет первую копию, поэтому повторные отправки безопасны.

Что касается токена, руководство Meta для начала работы (дата обращения 2026-10-25) рекомендует генерировать его в Events Manager: выберите пиксель, откройте Settings и нажмите "Generate access token" в разделе Conversions API. Эта ссылка видна только пользователям с правами разработчика для бизнеса. Храните токен в серверном секрете.

Соберите всё самостоятельно, шаг за шагом

Шаги одинаковы, откуда бы ни пришёл клик: с короткой ссылки, QR-кода или прямой рекламы.

1. Сохраните ID клика. Руководство Meta по fbp и fbc (дата обращения 2026-10-25) советует читать fbclid из посадочного URL на сервере, если он есть, и форматировать его как fb.1.<creation time in ms>.<fbclid>. Сохраните это как значение fbc в сессии посетителя, затем скопируйте в заказ. Если пиксель установил cookie _fbp, сохраните и его значение.
2. Выберите event ID. Используйте ID заказа, причём одну и ту же строку в вызове браузерного пикселя (eventID) и в серверном событии (event_id). Два разных формата для одного заказа, например ord_98231 и 98231, не дедуплицируются.
3. Нормализуйте и хешируйте. По параметрам информации о клиенте (дата обращения 2026-10-25) email обрезается по краям и приводится к нижнему регистру, затем хешируется SHA-256. В номерах телефонов удаляются символы, буквы и ведущие нули, а перед хешированием обязательно должен быть код страны. fbc, fbp и client_ip_address никогда не хешируются.
4. Отправьте событие, когда заказ оплачен, из вашего бэкенда или обработчика вебхука заказа.
5. Проверьте в Test Events, затем уберите тестовый код.

Минимальный пример на Node:

import { createHash } from "node:crypto";

const sha256 = (v) => createHash("sha256").update(v).digest("hex");

const event = {
  event_name: "Purchase",
  event_time: Math.floor(Date.now() / 1000),
  event_id: order.id, // same string the browser pixel uses as eventID
  action_source: "website",
  event_source_url: order.thankYouUrl,
  user_data: {
    em: [sha256(order.email.trim().toLowerCase())],
    fbc: order.fbc,
    fbp: order.fbp,
    client_ip_address: order.ip,
    client_user_agent: order.userAgent,
  },
  custom_data: { currency: "EUR", value: 89.5 },
};

await fetch(
  `https://graph.facebook.com/v26.0/${PIXEL_ID}/events?access_token=${TOKEN}`,
  {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({ data: [event] }),
  },
);

На время тестов добавьте в тело запроса test_event_code. В продакшене не логируйте полный URL: в нём есть токен.

Дедупликация и Test Events: две ловушки

Руководство Meta по дедупликации (дата обращения 2026-10-25) описывает сопоставление по event_id плюс event_name: eventID пикселя сравнивается с event_id сервера в окне 48 часов. Там сказано, что это в основном работает, когда браузерное событие приходит первым, а серверное следует за ним. Также сказано, что при использовании только одного источника дедупликации нет вовсе.

У инструмента Test Events есть ловушка. test_event_code предназначен только для тестирования, но на странице Meta об использовании API указано, что события с ним не отбрасываются: они попадают в Events Manager и используются для таргетинга и измерений. Так что "безобидная" тестовая покупка на 500 EUR всё равно засчитывается. Отправьте несколько небольших тестовых событий и уберите код из боевой нагрузки.

После начала отправки, по словам Meta, события можно проверить примерно через 20 минут в обзоре Events Manager. Убедитесь, что название события совпадает с тем, что отправляет ваш пиксель, и что событие показывает сопоставленные пользовательские данные.

Где здесь короткая ссылка

Короткая ссылка не меняет принцип работы CAPI. Она важна в двух местах, и только в двух.

Первое - ID клика. Meta добавляет fbclid к адресу назначения, заданному в рекламе. Если это короткая ссылка, параметр приходит на неё. В коде редиректа Elido я не нашёл места, где входящий query string копировался бы на адрес назначения. Поэтому для рекламы Meta я бы направлял объявление на итоговый посадочный URL с UTM, а короткие ссылки оставил для email, SMS, QR-кодов и органических постов. Если всё же хотите короткую ссылку в рекламе, сначала проверьте её с тестовым ?fbclid=test и посмотрите, что получает ваша посадочная страница.

Второе - отчётность. Разметьте чекаут Shopify или Stripe значением elido_link_id. Тогда отчёт Elido по конверсиям покажет выручку по ссылкам и кампаниям на основе ваших собственных заказов. Сторона вебхуков разобрана в руководстве по Shopify. Более общую картину того, почему подсчёт только в браузере теряет события, см. в материалах серверное отслеживание конверсий и атрибуция без cookie.

Согласие и приватность

Хеширование - не анонимизация. SHA-256-хеш адреса email по GDPR остаётся персональными данными, потому что Meta может сопоставить его со своими записями. В ЕС нужно правовое основание, для измерения рекламы это обычно согласие, и серверный вызов должен учитывать тот же выбор, который посетитель сделал в вашем баннере. Вопросы согласия и передачи данных разобраны в материалах Consent Mode v2 для отслеживания и Schrems II и пиксели отслеживания. Если посетитель отказался, не отправляйте ничего.

Чего не хватает в Elido

Пересылка покупок в Meta одним вызовом, захват fbclid на редиректе и поле для токена доступа в настройках Meta - всё это пока не построено. Это отражено в бэклоге продукта, и эта статья изменится, когда функции выйдут. До тех пор честная схема такая, как описано выше: событие отправляет ваш сервер, а Elido поставляет вокруг него данные о кликах и выручке на уровне ссылок.

Читайте также в блоге

• Серверное отслеживание конверсий
• Click ID: gclid и fbclid
• Отслеживание UTM от начала до конца
• Ретаргетинг по ссылкам: разбор
• Сокращатель ссылок для Shopify