Facebook* Pixel
*На территории Российской Федерации запрещена деятельность социальных сетей Facebook и Instagram, принадлежащих компании Meta Platforms Inc., признанная экстремистской!
Как установить пиксель Facebook*
Как отправить события в пиксель из бота
Для передачи событий из воронки бота, нужно иметь бизнес аккаунт. Зарегистрировать можно по ссылке.
Как создать новый пиксель
Выбираем API Conversions
Внимание! Если на этапе создания настройки conversion api у вас появится следующее окно, следует выйти из настройки и начать заново.
Выбираем нужный пиксель
Генерируем маркер доступа (токен) и сохраняем в надежном месте.
Как передать события
*На территории Российской Федерации запрещена деятельность социальных сетей Facebook и Instagram, принадлежащих компании Meta Platforms Inc., признанные экстремистскими!
Для передачи события в фейсбук у вас на сайте должен быть установлен свой домен, подтвержденный в фейсбук и в настройках сайта включено сохранение значений из куки для фейсбук.
Теперь клиенту, который перешел с сайта автоматически запишется переменная: _fbp, которую нужно передать в пиксель вместе с событием.
Функция и параметры
fb_pixel_event(event_name, pixel_id, access_token, event_source_url, action_source, fbc, test_event_code, data) - передает событие в фейсбук пиксель из бота
event_name
название события. Можно использовать как стандартные события (например Lead, PageView, Purchase и тд https://developers.facebook.com/docs/facebook-pixel/implementation/conversion-tracking/#standard-events), так и свои (например Вошли в бот).
pixel_id
id пикселя. Если в настройках проекта создать переменную fb_pixel_id, а в функцию передать пустое значение, то данные будут взяты из переменной fb_pixel_id
access_token
маркер доступа к апи (токен). Если в настройках проекта создать переменную fb_access_token, а в функцию передать пустое значение, то данные будут взяты из переменной fb_access_token
event_source_url
домен, который подтвержден в аккаунте Фейсбук
action_source
(по умолчанию other) Это поле позволяет указать, где произошли конверсии. Информация о том, где произошли события, позволяет убедиться, что ваши объявления отображаются целевой аудитории. В поле action_source можно отправить следующие значения: 1) email - Конверсия произошла через электронное письмо.
2) website - Конверсия произошла на сайте.
3) phone_call - Конверсия произошла по телефону.
chat - Конверсия произошла через приложение для обмена сообщениями, SMS или онлайн-переписку.
4) physical_store - Конверсия произошла в физическом магазине.
5) system_generated - Конверсия произошла автоматически, например в результате продления ежемесячной подписки.
6) other - Конверсия произошла другим способом.
fbc
идентификатор клика. Необязательный параметр
test_event_code
Код для теста отправки событий. Необязательный параметр (информация где взять в разделе "как тестировать события")
data
дополнительные необязательные параметры. Представляет из себя словарь с данными. Возможные значения: 1) fn - имя
2) ln - фамилия
3) email - емейл пользователя
4) phone - телефон пользователя
5) fbc - идентификатор клика
6) gender - пол ( f - женский m - мужской)
7) country - страна
8) state - область
9) city - город
10) index - почтовый индекс
11) external_id - Любой уникальный ID клиента, например членский ID, ID пользователя или ID внешних файлов cookie.
12) client_ip_address - IP адрес клиента 13) client_user_agent - user agent браузера клиента
Вы также можете передать собственные параметры в пиксель (не обязательно), для этого дополнительно нужно добавить параметр:
my_params и в нем перечислить свои поля. Например:
“my_params”: {“value1”: “Hello”, “val2”: “Hi”}
Пример:
{"fn": "Ivan", "ln": "Ivanov", "client_ip_address":"127.0.0.1", "my_params": {“value1”: “Hello”, “val2”: “Hi”}}
Пример сохранения токена в настройках проекта:
Причем передачи параметров:
Как тестировать события
Для тестирования в тело запроса вам нужно добавить параметр test_event_code с текстом, который находится во вкладке Тестирование событий
{ "pixel_id": "#{pixel_id}", "access_token": "#{access_token}", "event_name": "Вошли в бот", "event_source_url": "https://my_best_site.ru", "fbp": "#{_fbp}", "fbс": "#{_fbс}", "test_event_code": "TEST99986" }
Внимание! Не забудьте удалить этот параметр из запроса, при запуске рабочей версии!
Дополнительные необязательные параметры
fn - имя ln - фамилия email - емейл пользователя phone - телефон пользователя fbc - идентификатор клика gender - пол ( f - женский m - мужской) country - страна state - область city - город index - почтовый индекс external_id - Любой уникальный ID клиента, например членский ID, ID пользователя или ID внешних файлов cookie. client_ip_address - IP адрес клиента client_user_agent - user agent браузера клиента
Вы также можете передать собственные параметры в пиксель (не обязательно), для этого дополнительно нужно добавить параметр:
my_params и в нем перечислить свои поля. Например:
“my_params”: {“value1”: “Hello”, “val2”: “Hi”}
Внимание! Не забудьте удалить этот параметр из запроса, при запуске рабочей версии!
Как добавить рекламный аккаунт
В настройках нужно открыть доступ своему аккаунту
Сохраняем и переходим тут же во вкладку Связанные объекты -> Добавить объекты:
И добавляем ваш рекламный аккаунт.
Last updated
Was this helpful?