* На территории Российской Федерации запрещена деятельность социальных сетей Facebook* и Instagram*, принадлежащих компании Meta Platforms Inc., признанной экстремистской.

Как установить пиксель Facebook*

Как отправить события в пиксель из бота

Для передачи событий из сценария чат-бота необходимо иметь бизнес-аккаунт Meta*.

Создать его можно по ссылке

Как создать новый пиксель

Выберите API Conversions.

Важно

Если во время настройки Conversion API появится окно, показанное ниже, закройте мастер настройки и начните создание заново.

Выберите необходимый пиксель.

Сгенерируйте маркер доступа (Access Token) и сохраните его.

Как передавать события

* На территории Российской Федерации запрещена деятельность социальных сетей Facebook* и Instagram*, принадлежащих компании Meta Platforms Inc., признанной экстремистской.

Для передачи событий необходимо:

  1. использовать собственный домен;
  2. подтвердить домен в Meta*;
  3. включить сохранение Facebook Cookie в настройках сайта Salebot.

После этого у клиента автоматически появится системная переменная:

_fbp

Именно ее необходимо передавать вместе с событием в пиксель.

Функция fb_pixel_event()

Для передачи события используется функция:

fb_pixel_event(
    event_name,
    pixel_id,
    access_token,
    event_source_url,
    action_source,
    fbc,
    test_event_code,
    data
)

Функция отправляет событие из чат-бота в пиксель Facebook*.

Параметры

Параметр Описание
event_name Название события. Можно использовать стандартные события Meta* (Lead, Purchase, PageView и др.) или собственные события, например Вошли в бот.
pixel_id ID пикселя. Если параметр не передан, используется значение константы проекта fb_pixel_id.
access_token Access Token для Conversion API. Если параметр не передан, используется константа проекта fb_access_token.
event_source_url Домен, подтвержденный в Meta*.
action_source Источник события. По умолчанию используется значение other.
fbc Идентификатор рекламного клика Facebook (_fbc). Необязательный параметр.
test_event_code Код тестирования событий. Используется только при тестировании. Необязательный параметр.
data Дополнительные данные пользователя и собственные параметры события.

Значения action_source

Поле action_source определяет источник конверсии.

Возможные значения:

Значение Описание
email Конверсия произошла после перехода из электронной почты.
website Конверсия произошла на сайте.
phone_call Конверсия произошла после телефонного звонка.
chat Конверсия произошла в чате, мессенджере или SMS.
physical_store Конверсия произошла в офлайн-магазине.
system_generated Конверсия создана автоматически (например, продление подписки).
other Любой другой источник.

Параметр data

Параметр data представляет собой словарь с дополнительными данными пользователя.

Поддерживаются следующие поля.

Поле Описание
fn Имя
ln Фамилия
email Email
phone Телефон
fbc Идентификатор рекламного клика
gender Пол (m или f)
country Страна
state Регион
city Город
index Почтовый индекс
external_id Любой уникальный идентификатор пользователя
client_ip_address IP-адрес пользователя
client_user_agent User-Agent браузера

Также можно передавать собственные параметры.

Для этого используется объект:

"my_params": {
    "value1": "Hello",
    "value2": "Hi"
}

Пример данных

{
    "fn": "Ivan",
    "ln": "Ivanov",
    "client_ip_address": "127.0.0.1",
    "my_params": {
        "value1": "Hello",
        "value2": "Hi"
    }
}

Сохранение токена

Рекомендуется сохранить Access Token в константу проекта.

После этого в функции можно не передавать параметр access_token.

Пример передачи параметров:

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

Для проверки отправки событий используйте параметр:

test_event_code

Код можно получить в разделе «Тестирование событий» в Meta Events Manager.

Пример запроса:

{
  "pixel_id": "#{pixel_id}",
  "access_token": "#{access_token}",
  "event_name": "Вошли в бот",
  "event_source_url": "https://my_best_site.ru",
  "fbp": "#{_fbp}",
  "fbc": "#{_fbc}",
  "test_event_code": "TEST99986"
}

Важно

После завершения тестирования удалите параметр test_event_code из рабочего сценария.

Дополнительные параметры

При необходимости можно передавать дополнительные данные пользователя.

Параметр Описание
fn Имя
ln Фамилия
email Email
phone Телефон
fbc Идентификатор рекламного клика
gender Пол (m или f)
country Страна
state Регион
city Город
index Почтовый индекс
external_id Любой уникальный идентификатор пользователя
client_ip_address IP-адрес пользователя
client_user_agent User-Agent браузера

Также можно передавать собственные параметры.

Для этого используется объект:

"my_params": {
    "value1": "Hello",
    "value2": "Hi"
}

Важно

Не забудьте удалить параметр test_event_code после окончания тестирования.

Как добавить рекламный аккаунт

Чтобы использовать пиксель и Conversion API, предоставьте доступ своему рекламному аккаунту.

Откройте настройки Business Manager и добавьте необходимые разрешения.

После сохранения настроек перейдите на вкладку «Связанные объекты» и нажмите «Добавить объекты».

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