Параметры серверных событий

Обязательный параметр.
Имя стандартного или специально настроенного события. Это поле используется для дедупликации событий сервера (отправленных через пиксель Meta), приложения (через SDK или API App Events) или API Conversions. Параметр event_id также используется в дедупликации.

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

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

Необязательный параметр.
URL браузера, где произошло событие. URL должен начинаться с http:// или https:// и соответствовать подтвержденному домену.

Примечание. Поле event_source_url является обязательным для событий на сайте, передаваемых через API Conversions.

Необязательный параметр.
Этот ID можно указать в виде уникальной строки, заданной рекламодателем. Параметры event_id и event_name используются для дедупликации событий сервера (отправленных через пиксель Meta), приложения (через SDK или API App Events) или API Conversions. Обратите внимание: поле event_id помечено как необязательное, однако мы рекомендуем использовать для дедупликации событий именно его.

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

Номер заказа или ID транзакции — это два потенциальных идентификатора, которые можно использовать для event_id. Например, если клиент делает на вашем сайте две покупки с номерами заказа 123 и 456, каждый вызов API Conversions должен содержать соответствующий номер заказа для event_id. Это позволяет нам правильно идентифицировать эти два события покупки в виде отдельных заказов. Два соответствующих события покупки пикселя браузера также должны отправить эти же номера покупок в параметре eventID, благодаря чему мы сможем понять, что имели место именно два события, а не четыре отдельные покупки.

Для других событий без действительного номера ID может использоваться произвольный номер (при условии, что этот же произвольный номер отправляется между событиями браузера и сервера).

Необязательный параметр.
Параметры обработки, которые следует включить для определенного события. Допустимое в настоящее время значение — LDU (ограниченное использование данных). Чтобы явным образом указать, что событие должно обрабатываться без ограничений, передайте пустой массив. Подробнее о параметрах обработки данных см. в этой статье. См. примеры реализации Conversions API.

Обязательный параметр в некоторых случаях. (Подробную информацию см. в примечании ниже.)
Штат, связанный с параметром обработки данных. Допустимые в настоящее время значения — 1000 (Калифорния) или 0 (мы самостоятельно определяем местонахождение пользователя).

Примечание.

• Если указана страна, необходимо также указать штат. В противном случае мы используем геолокационные данные для всего события.
• Это поле обязательно, если в поле data_processing_options отправляется значение LDU, а IP-адрес не предоставляется.

Подробнее о параметрах обработки данных см. в этой статье. См. примеры реализации Conversions API.