UA	US	RU

UA	US	RU

Умные алгоритмы Meta превращают каждый потраченный доллар вашего рекламного бюджета в качественные лиды, основываясь на события конверсий, отправляемые с платформы Leeloo.ai.
Оптимизируйте и совершенствуйте свои рекламные кампании с помощью инструментов платформы Leeloo.ai, исключая случайные клики по рекламе и увеличивая продажи за счёт привлечения более качественных лидов.

Facebook Server-Side API — это возможность передавать серверные события конверсий напрямую из Leeloo.ai в Meta Business Manager, что позволяет оптимизировать рекламные кампании.

1 1. Введение
2 2. Основные термины
3 3. Перед началом
- 3.1 Необходимые права доступа
- 3.2 Ознакомление с существующими параметрами
4 4. Пошаговая инструкция
5 5. Частые ошибки

1. Введение

Данная инструкция поможет вам:

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

После выполнения всех шагов вы сможете передавать точные данные о конверсиях напрямую с платформы Leeloo.AI.

Примеры событий конверсий:

Subscription — событие подписки на бота.
MQL (Marketing Qualified Lead) — событие квалификации лида маркетингом (заполнение формы, пройденный опрос и т.д.).
SQL (Sales Qualified Lead) — событие квалификации лида отделом продаж.
Royal Lead — событие премиум-лида с высоким потенциалом (например, компании с оборотом 50,000+ евро).
Purchase — событие совершения покупки.

Навыки после ознакомления:

Подключение Facebook пикселя к Leeloo.ai.
Создание и настройка кастомных событий Facebook.
Отображение событий в рекламном кабинете Facebook.
Оптимизация рекламных кампаний на основе серверных событий.
Решение типичных проблем с интеграцией.

2. Основные термины

Термин	Пояснение
Facebook Serverside API	Серверный API Facebook для передачи событий конверсий напрямую с сервера
Пиксель ID	Уникальный идентификатор Facebook пикселя
Токен доступа	Ключ для авторизации API-запросов к Facebook
Events Manager	Инструмент Facebook для управления событиями и пикселями
Кастомное событие	Пользовательское событие, созданное специально для бизнес-потребностей
Lookalike аудитория	Похожая аудитория, созданная на основании лидов по которым отправились события конверсии
Action Source	Источник события (website, app, email и т.д.)
LGT	Lead Generation Tool - инструмент лидо-генерации в Leeloo.ai

3. Перед началом

Необходимые права доступа

Административные права в Facebook Business Manager
Права на управление пикселями и рекламными аккаунтами
Доступ к настройкам аналитики в Leeloo.ai
Права на создание и редактирование туннелей продаж в Leeloo.ai

Ознакомление с существующими параметрами

Изучите структуру существующих туннелей продаж в Leeloo.ai
Определите ключевые точки конверсий в вашем туннеле продаж события которых будут отправлятся в Facebook Ads Manager
Подготовьте список событий, которые нужно передавать из Leeloo.ai (Подписка, покупка, и т.д.)

4. Пошаговая инструкция

Шаг 1: Создание набора данных (Пикселя)

Перейти в кабинет Facebook и выбрать вашу бизнес страничку
Перейдите в найстройки бизнес страници или рекламного аккаунта. Затем перейдите в раздел “Наборы данных”
Нажать кнопку "Добавить"
Ввести название источника данных (Pixel) и нажать кнопку “Создать”
После создания появится окно об успешном создании, закойте его нажав на “Крестик”
Нажать кнопку "Назначить людей"
Выбрать страницы, которые будут управлять источником данных, активировать все галочки, нажать "Продолжить"
Нажать кнопку "Назначить"
Открыть вкладку "Назначить объекты"
Добавить рекламный аккаунт в котором будет размещена реклама и нажать "Добавить"
Нажать "Добавить"

Шаг 2: Получение данных для интеграции с платформой Leeloo.AI

Для успешной интеграции с платформой Leeloo.AI вам потребуется собрать следующие данные:

Pixel ID - уникальный идентификатор вашего Facebook Pixel
Access Token - токен доступа к вашему Business Manager для авторизации API-запросов
Test Event Code - специальный код для тестирования серверных событий

Перейти в Events Manager, выберите свой пиксель, затем перейлите во вкладку "Настройки"
Скопировать "ID группы данных" который понадобится что бы вставить в кабинете настроек аналитики на платформе Leeloo.ai

Это ваш Пиксель ID для настроек в Leeloo.ai

Спуститься до раздела "API Conversions" и нажать "Сгенерировать маркер доступа"
Нажать по коду, чтобы скопировать в буфер обмена
Этот токен также нужно будет вставить в кабинете настроек аналитики на платформе Leeloo.ai

Шаг 3: Подключение набора данных (Пикселя) в Leeloo.ai

На платформе Leeloo.ai перейти в раздел Настройки → Аналитика → Facebook
Заполнить данные для подключения интеграции:

Имя: Указать название для идентификации пикселя
Пиксель ID: Указать идентификатор пикселя
Токен доступа: Ввести токен доступа

Шаг 4: Получение тестового кода

Тестовый код необходим для:

Проверки корректности настройки - убедиться, что события успешно передаются с сервера в Facebook
Отладки интеграции - выявить возможные ошибки в передаче данных до запуска основных кампаний
Валидации данных - проверить, что все параметры событий (стоимость, валюта, пользовательские данные) передаются правильно
Мониторинга в реальном времени - видеть в Events Manager, как события поступают и обрабатываются
Предотвращения потерь - избежать потери важных конверсионных данных из-за технических ошибок

Перейти в Events Manager
Открыть "Источники данных"
Выбрать необходимый источник данных и перейти в раздел "Тестирование событий"
Нажать по разделу "Убедитесь, что события сервера настроены правильно"
Нажать кнопку "Копировать"

Шаг 5: Создание события

Создание событий необходимо для:

Точного отслеживания воронки продаж - фиксировать каждый этап взаимодействия клиента с вашим продуктом
Оптимизации алгоритмов Facebook - предоставить машинному обучению Facebook детальные данные для поиска похожих пользователей
Создания Lookalike-аудиторий - использовать качественные конверсии для поиска новых потенциальных клиентов
Улучшения attribution - получать полную картину customer journey от первого клика до покупки
Снижения стоимости рекламы - более точные данные помогают Facebook показывать рекламу наиболее релевантной аудитории

Пример событий:

Subscription leeloo - факт подписки на бота
MQL Leeloo - квалифицированый лид маркетингом
Royal MQL Leeloo - показатель крупности бизнеса/лида подтвержденный маркетингом
SQL Leeloo - квалифицированый лид отделом продаж
Royal SQL Leeloo - показатель крупности бизнеса/лида подтвержденный отделом продаж
Purchase Leeloo (Стандартное событие покупки) - факт покупки в оффере

Разместите их в рамках подключенного пикселя на платформе Leeloo.AI :

На платформе Leeloo.AI, в разделе Настройки → Аналитика → Facebook кликните на ранее добавленый Pixel
Нажать кнопку "+ Добавить событие"
Указать "Имя на платформе" - название для оперирования на платформе
Пример: "subscription_leeloo", "mql_leeloo", "sql_leeloo"
Выбрать "Events Type Parameters":

Для передачи событий выбрать "custom"

При выборе custom указать в поле "Имя" какое будет передаваться название события в Meta Events Manager (Facebook)

Имя новых событий должно быть уникальным

Указать action_source - "website"

10. Нажать кнопку "Ok" и "Закрыть"

Шаг 6: Отправка тестового события

В настройках интеграции Facebook выбрать ранее созданный Pixel
Кликните на событие, для которого хотите отправить тест в ваш Pixel
В открывшимся окне вставьте скопированый Тестовый код (шаг 4) в строку "Тестовый код"
Нажмите на кнопку “Ок” и не закрывайте окно
Перейдите в Events Manager > Наборы данных > Кликникните на Пиксель который подключен к платформе Leeloo.AI и из которого копировали тестовый код (шаг 4)
Перейдите на вкладку “Тестовые события”
В окне тестовых событий будет отображатся отправленной из платформы Leeloo.AI тестовое событие

Если событие отобразилось значит что настройки интегарции успешны.
Можете закрыть окно настрое события на платформе Leeloo.AI.

Шаг 7: Как подтвердить пользовательские события и отобразить их при настройке рекламы?

Определите изначально ключевые показатели, которые вы хотите отслеживать.

После создания событий, которые вы хотите передавать из Leeloo.Ai, нужно отправить тестовые события, и отобразить их в Наборе Данных (Event Manager):

Что бы пользовательские события отобразились в настройках вашей рекламы где есть Conversions, нужно подтвердить эти пользовательские события

Переходим в Events Manager > Наборы Данных, выбираем наш пиксель, на который мы отправляли наши тестовые события.
Затем переходим в “Обзор”, и мы видим наши тестовые события, которые принимает пиксель
Далее нам необходимо подтвердить наши пользовательские события. Для этого нужно нажать на наши пользовательские события в разделе “Обзор”.
Затем нажать кнопочку “Управление Статусом”
Появится окно подтверждения. Нажимаем «Я подтверждаю»
Затем появится следующее окно Информация событий, где внизу нам необходимо нажать Подтвердить Специально настроеное Событие, а затем кнопку «Подтвердить»
Появится соответствующая иконка подтверждения справа снизу
Далее мы переходим в Ads Manager
Создаем новую рекламную кампанию и выбираем цель компании, которая подходит для отслеживания конверсий (Engagement, Leads, Sales), а затем нажимаем “Продолжить”
Переходим в настройки группы объявлений
В DataSet указываем пиксель, который будет получать события конверсий, а в Conversion Event мы указываем, нужное событие созданное в Leeloo.AI
События могут быть как активные, так и неактивные

Шаг 8: Отправка событий из платформы Leeloo.AI

В LGT:

Открыть ваш LGT, перейти во вкладку "Traffic"
Нажать кнопку "Добавить событие"
Указать:"Тип действия" - "подписка"
Указать в поле "Аналитика" ранее созданную аналитику Facebook
Указать созданное событие которым вы хотите отследить факт подписки на бота.
Нажать кнопку "Сохранить"

В предложениях:

Перейти в раздел Туннели продаж → Предложения → Выбрать категорию нужного предложения
Перейти в предложение, на которое хотите добавить аналитику
Открыть "Аналитика FB & Google"
Нажать "+ Добавить событие"
Выбрать "Тип действия", который хотите передавать
Выбрать "Аналитика", которую ранее подключили из Facebook
Выбрать событие, которое заранее настроили для предложения
Нажать кнопку "Сохранить"

В туннеле продаж:

Перейти в раздел Туннели продаж → Выбрать нужный туннель
Нажать правой кнопкой мыши (для Windows)/двумя пальцами по тачпаду (для MacOS) в пустом месте рядом с LGT, с которого хотите передавать аналитику, выбрать "Действие"
Выбрать созданный блок
Выбрать "Аналитика FB & Google"
Выбрать в поле "Аналитика" ранее созданную аналитику
Выбрать в поле "Событие" ранее созданное событие
Нажать кнопку "Сохранить"
Соединить блок "Действие" с нужным LGT или блоком

5. Частые ошибки

Проблема	Причина	Решение
События не отображаются в Ads Manager	Не создана специально настроенная конверсия	Создать специально настроенную конверсию согласно шагам 55-59
"Прямые ссылки" не передают события	Используется прямая ссылка вместо туннеля	Использовать только туннели продаж Leeloo.ai
Задержка передачи событий на 10-20 минут	Особенность серверной обработки Facebook	Это нормально, подождать или проверить через некоторое время
Дублирование событий	События настроены в нескольких местах одновременно	Проверить настройки в LGT, предложениях и туннелях
Неправильный action_source	Указан неверный источник события	Установить action_source как "website"
Ошибка токена доступа	Токен устарел или неверный	Сгенерировать новый маркер доступа в Events Manager
События не появляются в списке конверсий	Рекламный аккаунт не добавлен к конверсии	Добавить рекламный аккаунт согласно шагам 68-74
Низкое качество событий	Передаются неполные данные пользователя	Проверить настройки сбора данных в Leeloo.ai

После выполнения всех шагов вы сможете выбирать нужный пиксель и конверсию при создании рекламного объявления.
По умолчанию из системы Leeloo.ai передаются следующие параметры: почта, телефон, пол, имя, фамилия, fb external id, user agent, ip, fbc, fbp.

Facebook Serverside API (конверсии фейсбук)