Как использовать Facebook Pixel в мини-лендингах

https://docs.salebot.ai/mini-landing#how-to-use-social-networking-pixels

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

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

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

Выберите API Conversions

Внимание! Если при настройке Conversion API откроется следующее окно, лучше выйти из настроек и начать заново.

Если при настройке Conversion API откроется следующее окно, лучше выйти из настроек и начать заново.

Выберите нужный пиксель

Сгенерируйте токен доступа и сохраните его в надежном месте.

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

Для передачи событий в Facebook у вас должен быть собственный домен, настроенный в мини-лендинге, одобренный в Facebook, и в настройках мини-лендинга для Facebook должна быть включена опция «Сохранение значений из cookie в переменные клиента»:

Теперь в карточке клиента, пришедшего из мини-лендинга, будет автоматически заполнена переменная _fbp. Эту переменную можно передавать в Pixel вместе с событием

В блоке, через который нужно передать событие, необходимо настроить следующие параметры:

URL функции: https://store.salebot.ai/function/fb\\_pixel

Пример параметров:
{
"pixel_id": "#{pixel_id}",
"access_token": "#{access_token}",
"event_name": "Entered the bot",
"event_source_url": "https://my\\_best\\_site.com",
"action_source": "chat",
"fbp": "#{_fbp}",
"fbc": "#{_fbc}"
}

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

pixel_id - ID пикселя
access_token - токен для доступа к API
event_name - название события. Можно использовать стандартные названия (например, Lead, PageView, Purchase и др.; подробнее здесь), а также собственные (например, Entered the bot)
event_source_url - домен, одобренный в Facebook
fbp - ID браузера клиента

Необязательные параметры:

action_course - (по умолчанию other) это поле позволяет указать, где именно произошли конверсии. Информация о том, где произошли события, помогает показывать вашу рекламу нужной аудитории.
В поле action_source можно задать следующие значения:

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

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

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

{
"pixel_id": "#{pixel_id}",
"access_token": "#{access_token}",
"event_name": "Entered the bot",
"event_source_url": "https://my\\_best\\_site.com",
"fbp": "#{_fbp}",
"fbс": "#{_fbс}",
"test_event_code": "TEST11421"
}

Внимание! Не забудьте удалить этот параметр из запроса при запуске рабочей версии!

Дополнительные необязательные параметры:

fn - имя
ln - фамилия
email - email клиента
phone - номер телефона клиента
fbc - ID клика
gender - пол клиента (f - женский, m - мужской)
country - страна
state - штат/регион
city - город
index - почтовый индекс клиента
external_id - любой уникальный ID клиента, например, ID пользователя или ID сторонних cookie-файлов
client_ip_address - IP-адрес клиента
client_user_agent - user agent браузера клиента

Вы также можете передавать в Pixel собственные параметры (необязательно), для этого нужно добавить дополнительный параметр my_params и указать в нем свои поля.

Пример:
“my_params”: {“value1”: “Hello”, “val2”: “Hi”}

Полный пример:

{
"pixel_id": "#{pixel_id}",
"access_token": "#{access_token}",
"event_name": "Entered the bot",
"event_source_url": "https://my\\_best\\_site.com",
"email": "[email protected]",
"phone": "1234567890",
"currency": "USD",
"value": "142.52",
"test_event_code": "TEST11421",
"external_id": "#{client_id}",
"fn": "#{name}",
"gender": "m",
"post_index": "12345",
"my_params": {“value1”: “Hello”, “val2”: “Hi”}
}

Внимание! Не забудьте удалить этот параметр из запроса при запуске рабочей версии!

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

Сначала необходимо открыть доступ к вашему аккаунту

Сохраните и перейдите на вкладку Related Objects -> Add Objects

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