Conversions API

Дедупликация событий пикселя и API Conversions

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

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

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

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

Способы дедупликации событий

Facebook выполняет дедупликацию идентичных событий, отправленных через пиксель Meta и API Conversions. Существует два способа дедупликации.

По идентификатору и имени события (рекомендуется)

Обязательные параметры

При использовании этого способа к событиям API Conversions и пикселя добавляется параметр event_id. Этот event_id позволяет различить похожие события. Подробнее о параметре event_id см. в этом разделе.

Описание

Идентичные события определяются по совпадающим идентификаторам и имени. Дедупликация выполняется, если:

  1. Значение eventID события пикселя Meta совпадает с event_id события API Conversions.
  2. Значение event события пикселя Meta совпадает с event_name в API Conversions.

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

Примечание. Параметр eventID для пикселя — это четвертый аргумент в вызове fbq.

Пример

fbq('track', 'Purchase', {value: 12, currency: 'USD'}, {eventID: 'EVENT_ID'});

По FBP или внешнему идентификатору

Обязательные параметры

В этом случае нужно стабильно использовать параметры event_name, fbp и (или) external_id во всех событиях браузера или сервера. Подробнее о параметрах external_id и fbp см. в статье Параметры информации о клиентах.

Описание

Если параметры external_id и fbp отправляются как через браузер, так и через сервер, мы выполняем дедупликацию автоматически. Этот процесс описан ниже.

  1. Вы отправляете нам событие браузера с параметрами event_name, fbp и (или) external_id.
  2. Затем вы отправляете нам событие сервера с параметрами event_name, fbp и (или) external_id.
  3. Мы сравниваем событие сервера с отправленным ранее событием браузера. В частности, мы сравниваем комбинации event_name, fbp и external_id.
  4. Мы используем ряд стратегий для удаления дубликатов между событиями, которые могут улучшить оптимизацию и измерения. Если данные о событиях сервера и браузера существенно не отличаются, обычно мы удаляем событие, которое было получено первым.

Ограничения

Ограничения этого способа:

  • Обычно он работает только для дедупликации событий, которые были отправлены сначала из браузера, а потом через сервер. Если за последние 48 часов не было событий браузера, серверные события не отбрасываются, даже если после серверного события приходит идентичное событие браузера.
  • Если используется только один источник событий (только браузер или только сервер), дедупликация не выполняется. Если вы отправляете подряд два одинаковых события браузера, ни одно из них не отбрасывается. Если вы отправляете подряд два одинаковых события сервера, ни одно из них не отбрасывается.

Настройка дедупликации для пикселя браузера

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

  • Значение eventID в необязательном параметре eventData должно быть уникальным. В зависимости от реализации пикселя Meta можно использовать перечисленные далее варианты.
    • track — отправка события для всех пикселей на странице: 
      fbq('track', 'Purchase', {value: 12, currency: 'USD'}, {eventID: 'EVENT_ID'});
    • trackSingle — отправка события только для одного пикселя: 
      fbq('trackSingle', 'SPECIFIC_PIXEL_ID', 'Purchase', {value: 12, currency: 'USD'}, {eventID: 'EVENT_ID'});
    • метка пикселя-изображения с параметром eid: 
      <img src="https://www.facebook.com/tr?id=PIXEL_ID&ev=Purchase&eid=EVENT_ID"/>
    Если событие не содержит таких параметров, как стоимость и валюта, его можно настроить так: 
    fbq('track', 'Lead', {}, {eventID: 'EVENT_ID'});
  • Значение eventID, получаемое от пикселя Meta, должно совпадать со значением event_id соответствующего события, получаемого от API Conversions.
  • Если в течение 48 часов на один и тот же ID пикселя будут отправлены события с одинаковыми значениями параметров сервера (event_id и event_name) и одинаковыми значениями параметров браузера (eventID и event), события браузера будут отброшены.
  • Если вы отправляете события с одинаковыми event_ids как через браузер, так и через API Conversions, дедупликация выполняется, только если повторные события с одинаковым event_id получены в течение 48 часов с момента получения первого события.

Проверка настройки дедупликации

Информацию о том, как проверить настройку дедупликации и объединения событий, см. в документации по проверке настройки.

Статьи по теме