Tellmetric
Meta CAPI

Meta Conversions API для Telegram-воронок

Когда клик приводит к новому участнику группы или к депозиту, Tellmetric передаёт конверсию в Meta через Conversions API. Ваши кампании смогут оптимизироваться на эти результаты, а не на клики.

Конверсии, которых Meta не видит

Система показов Meta работает на обратной связи. Она показывает объявление, видит результат и корректирует показы. В Telegram-воронке результат происходит вне поля зрения Meta: человек нажимает на объявление, открывается Telegram, и всё дальнейшее — вступление, переписка или депозит — происходит в приложении, где пиксель Meta работать не может. Обратная связь так и не приходит. Кампания без данных о конверсиях не может улучшить таргетинг, сколько бы она ни крутилась, и в итоге опирается на единственный доступный ей сигнал — клик.

Что меняет Conversions API

Conversions API (CAPI) — это канал «сервер — сервер». Вместо скрипта в браузере события в ваш датасет Meta отправляет напрямую сервер. Так можно передавать события, которые происходят внутри Telegram, и на них не влияют блокировщики рекламы, ограничения отслеживания в iOS и потеря cookie.

Сам API — лишь способ доставки. Чтобы событие было полезным, оно должно называться стандартным событием, на которое Meta умеет оптимизироваться, нести достаточно идентификаторов, чтобы Meta сопоставила его с человеком, видевшим объявление, и приходить один раз, а не несколько. Tellmetric берёт всё это на себя.

  • Стандартные названия событий. Вступления отправляются как CompleteRegistration, сообщения в бот — как Contact, а депозиты и платежи в Stars — как Purchase, чтобы Meta могла на них оптимизироваться. Соответствие можно изменить для каждого воркспейса.
  • Идентификация клика. Параметр fbc восстанавливается из исходного fbclid, который связывает событие с объявлением.
  • Параметры сопоставления. При наличии передаются хешированные email, телефон и хешированный id пользователя Telegram, а также IP-адрес и user agent клиента.
  • Дедупликация. Каждое событие несёт стабильный event ID, поэтому повторные отправки и повторные действия не учитываются дважды.

Какие события получает Meta

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

  • Вступление в группу или канал становится CompleteRegistration
  • Сообщение вашему боту становится Contact, если его удаётся сопоставить с кликом; сообщение без клика остаётся в ваших отчётах, но не отправляется, потому что Meta не смогла бы сопоставить его ни с кем
  • Депозит и первый депозит (FTD) становятся Purchase с суммой и валютой
  • Платёж в Telegram Stars (звёздах) становится Purchase, а сумма в Stars пересчитывается в доллары США, потому что Meta принимает только валюты ISO
  • Статусы постбэка lead, contact и reg становятся Lead, Contact и CompleteRegistration

В разделе Advanced (дополнительно) на странице Connections (подключения) любое из этих соответствий можно переопределить — по одной строке на событие, например Joiner=Lead. Если название, которое получает Meta, отличается от внутреннего, исходное сохраняется в поле source_event, так что в Events Manager по-прежнему можно отличить депозит от платежа в Stars. Клики, выходы участников из группы и возвраты как конверсии не отправляются.

Качество сопоставления: что несёт каждое событие

Meta может засчитать конверсию объявлению, только если узнаёт человека. Для этого используются параметры с информацией о клиенте, и чем больше надёжных параметров несёт событие, тем лучше сопоставление. В Telegram-воронке их меньше, чем при оформлении заказа на сайте, поэтому важен каждый.

  • fbc, восстановленный из fbclid, который Meta добавляет к URL объявления, — фиксируется в момент клика
  • fbp, браузерный id Meta, — если посетитель прошёл через лендинг со сниппетом tracker.js
  • IP-адрес и user agent клиента из клика — их наследуют все последующие события того же человека
  • Страна, определённая по клику и отправляемая в хешированном виде
  • external_id — SHA-256-хеш id пользователя Telegram, чтобы вступление и последующий депозит несли одну и ту же идентичность
  • Email, телефон, имя, город, почтовый индекс, дата рождения и пол — если ваша платформа передаёт их в постбэке или в вызове API событий; перед сохранением они хешируются, а уже хешированные значения передаются без изменений

На тарифах Pro и Agency панель качества сопоставления на дашборде показывает долю событий с каждым идентификатором. Например, видно, что депозиты несут fbc, но редко email, — и можно попросить платформу добавить его в постбэк.

Дедупликация и повторные покупки

Meta дедуплицирует события с одинаковым названием и event id. Tellmetric формирует стабильные id, чтобы каждое реальное действие учитывалось один раз:

  • Id постбэка складывается из статуса, id клика и id транзакции. Если трекер повторно отправит тот же депозит, он будет распознан как дубль и не запишется снова; второй депозит с новым id транзакции — это новое событие.
  • Для платежа в Stars используется собственный charge id Telegram.
  • Сообщения вашему боту учитываются один раз на человека в день, сколько бы сообщений он ни отправил.
  • Id транзакции также передаётся как order_id, а повторные депозиты помечаются как сделанные вернувшимся клиентом со ссылкой на первую покупку.

Как устроена доставка

Воркер доставки забирает новые события каждые 30 секунд и отправляет их в ваш датасет пакетами. Перед отправкой каждое событие проверяется на соответствие правилам Meta. Meta отклоняет весь пакет, если в нём есть хотя бы одно некорректное событие, поэтому событие старше семи дней, с неподдерживаемой валютой или с небраузерным user agent откладывается отдельно и не блокирует остальные. Временные ошибки, например превышение лимитов запросов, повторяются с растущими интервалами, прежде чем событие будет помечено как неудачное. Трафик, похожий на автоматический, — например, с user agent известных краулеров или с частных IP-адресов, — записывается, но не отправляется, чтобы Meta училась на людях, а не на ботах.

Если в вашем воркспейсе депозиты проходят проверку, депозит ждёт, пока его одобрит участник команды, и только после этого отправляется. Статус доставки каждого события и ответ Meta видны в приложении.

Подключение Meta пошагово

  1. В Meta Events Manager выберите свой датасет (пиксель) и откройте Settings. Скопируйте id датасета.
  2. В разделе Conversions API сгенерируйте токен доступа и скопируйте его.
  3. Вставьте оба значения на странице Connections в Tellmetric.
  4. Скопируйте тестовый код события на вкладке Test events (тестовые события) в Events Manager и добавьте его на той же странице.
  5. Откройте одну из своих трекинговых ссылок на телефоне и вступите в группу. Примерно через минуту вступление появится в Test events как CompleteRegistration.
  6. Удалите тестовый код, чтобы реальные события засчитывались вашим кампаниям, затем выберите в кампании событие конверсии — тот этап, на который Meta должна оптимизироваться.

Условный пример: что получает Meta

Событие Purchase с суммой 120 и валютой EUR, fbc, IP-адрес и user agent клиента из исходного клика, external ID на основе аккаунта Telegram, id транзакции брокера в поле order_id и поле source_event, показывающее, что в вашей воронке это был Deposit. Тестовые коды событий позволяют проверить событие в Events Manager до того, как на него будет опираться какая-либо кампания.

Пиксель и Conversions API вместе

Если перед Telegram у вас есть лендинг, на нём, возможно, уже стоит пиксель Meta. Оставьте его. Пиксель передаёт то, что происходит на странице; Tellmetric — то, что происходит после неё, в Telegram и в вашей системе учёта депозитов. Если одно и то же событие может прийти от обоих, общий event id позволяет Meta учесть его один раз. Подробное сравнение — в материале Пиксель Meta или Conversions API для Telegram.

Частые ошибки

  • Отправка пользовательских событий, которые Meta измеряет, но не может использовать как цель оптимизации
  • Отправка депозитов без суммы и валюты — Meta их учитывает, но не может оценить их вес
  • Сбор депозитов раз в неделю, хотя Meta принимает события не старше семи дней
  • Тестовый код события, не удалённый после проверки
  • Отсутствие email или телефона, которые уже есть у вашей платформы, — тогда депозиты сопоставляются только по данным клика

Что это даёт рекламодателю

  • Кампании, оптимизированные на участников и депозиторов, а не на клики
  • Похожие аудитории (lookalike), построенные на людях, которые совершили конверсию
  • Столбцы конверсий в Ads Manager, отражающие результаты в Telegram
  • Отчётность, которая продолжает работать, когда браузеры блокируют стороннее отслеживание

Частые вопросы

Что мне нужно получить от Meta?

Id датасета и токен доступа Conversions API — оба бесплатно доступны в Events Manager.

Можно ли оставить пиксель на сайте?

Да. Пиксель и Conversions API могут работать вместе. Event ID от Tellmetric позволяют Meta дедуплицировать любое событие, переданное обоими.

Как Meta оценивает качество моих данных?

В основном по параметрам сопоставления, которые несёт каждое событие. Панель качества сопоставления показывает покрытие по fbc, email, телефону и external ID, так что видно, что можно улучшить.

Можно ли переименовать события?

Да. В каждом воркспейсе внутренние события можно сопоставить с любым стандартным событием Meta, например Joiner с Lead вместо CompleteRegistration.

Входит ли Conversions API в тариф Free?

Да. Передача в Meta входит в любой тариф, включая Free, который покрывает 1 000 отслеживаемых пользователей в месяц. TikTok, Snapchat, Reddit, Spotify и Google Ads добавляются на тарифах Pro и Agency.

Можно ли отправлять события со своего бэкенда?

Да. API событий принимает конверсии с id пользователя Telegram или с вашим собственным id клиента, а эндпоинт постбэка принимает формат, который уже используют партнёрские трекеры. Оба описаны на странице для разработчиков.

Связанные руководства

Отслеживайте конверсии в Telegram из рекламы в Meta

Для тарифа Free карта не нужна. Перейти на Pro можно в любой момент.