Рекомендации: API Conversions

Эти общие рекомендации помогут вам интегрировать Conversions API. Эти советы должны помочь вам с максимальной эффективностью использовать Conversions API. Воспользуйтесь рекомендациями по реализации и дальнейшим действиям, чтобы настроить интеграцию и получить оптимальные результаты при передаче данных в Meta.

В дополнение к советам ниже посмотрите это видео, посвященное практическим приемам работы с Conversions API. В нем рассматриваются следующие темы:

отправка запросов;
обработка отброшенных событий, времени транзакции событий и пакетных запросов;
подтверждение событий;
Использование инструмента тестирования событий

Для событий с сайта, из приложения или физического магазина, отправленных через API Conversions, требуются определенные параметры. Их список можно посмотреть в этой статье.

Реализация

При настройке кампании вы сможете упростить структуру своего аккаунта, следуя рекомендациям ниже.

Следуйте рекомендациям для этапа обучения.
Не вносите в кампанию существенных изменений.
Минимизируйте пересечение в аукционах.
Выберите автоматические места размещения и оптимизацию бюджета кампании.
Выберите оптимальную стратегию назначения ставок с учетом своих бизнес-целей.

Конфигурация с избыточными событиями

Рекомендуем использовать Conversions API в дополнение к пикселю Meta и отправлять одни и те же события с помощью обоих инструментов. Мы называем это конфигурацией с избыточными событиями. Например, если вы отправляете события Purchase, Initiate Checkout и Contact с помощью пикселя Meta, те же события следует отправлять с вашего сервера через Conversions API.

Conversions API позволяет отправлять события на сайте, которые могут быть потеряны пикселем из-за проблем с сетью или ошибок при загрузке страницы. Conversions API также можно использовать для отправки важных событий других типов и данных, возникающих офлайн или позже, не обрабатываемых пикселем.

Настройка дедупликации избыточных событий

При отправке избыточных событий с помощью пикселя Meta и Conversions API используйте в обоих экземплярах каждого события одинаковые значения event_name, а также не забудьте добавить event_id или комбинацию из external_id и fbp. Рекомендуем использовать все эти параметры, чтобы система Meta могла правильно дедуплицировать события и уменьшить количество повторов. См. дополнительные сведения о дедупликации, о том, зачем она нужна и как ее настроить.

Отправка обязательных и рекомендуемых параметров

Ниже перечислены обязательные параметры серверных событий и информации о клиенте.

Параметр	Тип	Когда необходимо использовать
`action_source`	Серверное событие	Для всех событий
`event_source_url`	Серверное событие	Для всех событий сайта
`client_user_agent`	Информация о клиенте	Для всех событий сайта

Используя Conversions API, вы соглашаетесь, что параметр action_source является максимально точным, насколько вам это известно. Рекомендуем также добавлять для всех событий параметры external_id и event_id.

Отправка дополнительных параметров информации о клиенте может повысить качество сопоставления событий. Для атрибуции объявлений и оптимизации показа рекламы можно использовать только сопоставленные события, и чем выше качество сопоставления, тем лучше. Несопоставленные события нельзя использовать для атрибуции и оптимизации показа рекламы, но они подходят для базовых измерений. Примеры качественных параметров информации о клиенте:

электронный адрес (em);
IP-адрес (client_ip_address);
имя (fn и ln);
номер телефона (ph).

Базовые требования для поиска совпадений

После выхода Graph API версии 13.0 мы обновим базовые требования, которые определяют допустимость различных сочетаний параметров информации о клиенте для события Conversions API. Эти изменения помогут нам лучше идентифицировать ситуации, когда набор параметров информации о клиенте в событии такой широкий, что поиск совпадений с высокой вероятностью будет неэффективен.

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

ct + country + st + zp + ge + client_user_agent;
db + client_user_agent
fn + ge
ln + ge.

Например, если событие содержит только параметры информации о клиенте ge, ct, st и country (которые, например, описывают мужчину в г. Менло-Парк, штат Калифорния, США), оно будет отклонено, поскольку эти параметры являются подмножеством одной из перечисленных выше комбинаций.

Обновление параметров `fbp` и `fbc`

Параметры fbp и fbc представляют собой значения cookie, которые обычно устанавливаются в браузерах посетителей сайта в рамках собственного решения Meta для обработки файлов cookie и могут меняться. Если вы отправляете их как параметры пользователя, их значения следует регулярно обновлять.

Эти значения будут установлены в качестве основных файлов cookie при реализации пикселя Meta на сайте и могут быть получены для использования в запросах Conversions API.

Отправка событий по мере их возникновения улучшает результаты кампании. С помощью Conversions API серверные события можно отправлять в режиме реального времени либо пакетами близко к реальному времени.

Тестирование событий

Рекомендуем использовать инструмент тестирования событий для проверки соединения с Conversions API. Как правило, разработчики используют в тестовых событиях собственные параметры информации о клиенте (например, имя, электронный адрес, номер телефона), поскольку такие события могут быть отклонены, если они не соответствуют ни одному аккаунту Facebook или Meta.

С помощью инструмента тестирования событий можно:

убедиться, что все события сервера настроены правильно и мы их получаем;
просмотреть обработанные и дедуплицированные события и убедиться, что дедупликация выполняется правильно;
выполнить отладку в случае подозрительных действий.

См. подробные сведения о тестировании серверных событий с помощью инструмента тестирования событий.

Использование помощника по полезным данным

Заполните поля обязательных и рекомендуемых параметров в инструменте Помощник по полезным данным, чтобы увидеть, какую структуру полезных данных нужно использовать, и получить рекомендации по добавлению тех или иных параметров.

Использование нашего Business SDK

В нашей документации приведены примеры кода для Business SDK на Python, Java, Ruby, PHP и Node. Они помогут вам сэкономить время при разработке, например при хэшировании параметров пользователей (в Business SDK эта операция выполняется автоматически).

Если вы не планируете использовать Business SDK, рекомендуем вам реализовать хэширование.

Использование Conversions API для офлайн-событий

Conversions API поддерживает все офлайн-события. Его следует использовать в качестве единого контейнера для событий этих типов. В число примеров входят продажи в физических точках, телефонные звонки, действия на устройствах (например, на интеллектуальных телевизорах и игровых консолях) и офлайн-подписки.

При отправке офлайн-событий обязательно добавляйте параметр события action_source и выбирайте соответствующее значение (не website). Чтобы определить цели кампании, с которыми связано событие, необходим источник действия.

Используя Conversions API, вы соглашаетесь, что параметр action_source является максимально точным, насколько вам это известно.

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

Агентства: отправка строки `partner_agent`

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

Платформы сайтов: новые рекламодатели

По умолчанию партнерские платформы сайтов могут на свое усмотрение предлагать Conversions API лишь определенным рекламодателям или тем, кто явным образом дал на это согласие. Для пикселя Meta и Conversions API действуют одинаковые условия для компаний, и мы рекомендуем предлагать клиентам также выбирать отправку данных через Conversions API, когда они настраивают у себя пиксель Meta. Мы считаем, что комбинация из этих инструментов обеспечивает надежный обмен данными в долгосрочной перспективе, однако рекомендуем предоставлять клиентам информацию об обоих этих вариантах, чтобы они могли принять информированное решение.

Дальнейшие действия после реализации

Проверка качества сопоставления событий

Если вы используете для отправки серверных событий Conversions API, то можете проверить качество сопоставления (EMQ) для каждого события в Events Manager. Показатель EMQ события (по 10-балльной шкале) отражает, насколько эффективно информация о клиенте из серверного события сопоставляется с соответствующим аккаунтом Meta. Подробнее о рекомендациях по работе с EMQ см. в этой статье.

В настоящее время показатели качества сопоставления событий (EMQ) доступны только для веб-событий. Чтобы получить рекомендации по улучшению качества сопоставления других типов событий, таких как офлайн-события, события в физических магазинах, события в приложениях, конверсия лидов или интеграции на стадии альфа- или бета-версии, свяжитесь со своим представителем в Meta.

Тестирование

Если вы используете Conversions API, рекомендуем вам протестировать и оптимизировать свою стратегию рекламы на Meta. Ниже перечислены некоторые из доступных вариантов тестирования.

Исследование прироста конверсий: помогает оценить эффект дополнительного прироста от использования серверных событий.
Сплит-тестирование: помогает выбрать стратегию кампании, которая обеспечивает максимальные результаты, чтобы оптимизировать эффективность.