Интеграция TikTok Events API с Leeloo.AI
Передача серверных событий в TikTok Ads предоставляет бизнесу более точный сигнал о реальных действиях пользователей внутри платформы Leeloo.AI. Это напрямую влияет на качество оптимизации и экономику вашей кампаний.
Лучшая оптимизация рекламы: алгоритм TikTok получает события конверсий и точнее находит аудиторию, которая выполняет целевое действие.
Более стабильные данные: серверная передача событий меньше зависит от блокировщиков, ограничений браузера и потерь клиентского трекинга.
Снижение стоимости лида: за счёт более качественных сигналов кампании быстрее выходят на эффективные связи и дают более низкий CPL.
Лучшая масштабируемость: когда события передаются корректно, проще масштабировать бюджеты без резкого падения качества лидов.
Более прозрачная аналитика: бизнес получает более полную картину пути от клика до конверсии и может принимать решения на основе фактических данных.
Как итог TikTok Events API в связке с Leeloo.AI — это не просто техническая интеграция, а инструмент для повышения ROMI, улучшения качества лидов и стабильного роста рекламных результатов.
- 1 1. Введение
- 2 2. Основные термины
- 3 3. Перед началом
- 4 4. Пошаговая инструкция
- 4.1 Шаг 1. Переход в раздел Events Manager
- 4.2 Шаг 2. Создание Data Source
- 4.3 Шаг 3. Выберите тип настройки
- 4.4 Шаг 4. Получите данные подключения
- 4.5 Шаг 5. Скопируйте тестовый ключ
- 4.6 Шаг 6. Перейдите в Leeloo.AI
- 4.7 Шаг 7. Добавьте подключение TikTok
- 4.8 Шаг 8. Добавления событий
- 4.9 Шаг 9. Проверьте тестовое событие
- 5 Отправка событий из платформы Leeloo.AI
- 5.1 В LGT:
- 5.2 В предложениях:
- 5.3 В туннеле продаж:
- 6 Заключение
1. Введение
Эта инструкция поможет вам:
Настроить интеграцию TikTok Events API с Leeloo.AI.
Передавать серверные события в TikTok Ads Manager.
Проверять тестовые события и корректность подключения.
После выполнения шагов вы сможете отправлять серверные события из Leeloo.AI в TikTok Ads.
2. Основные термины
TikTok Events API — серверный канал передачи событий в TikTok.
Pixel ID — уникальный идентификатор источника данных в TikTok.
Access Token — токен для авторизации запросов.
Test Event Code — код для проверки тестовых событий в Events Manager.
Тип события — действие конверсии (например: ViewContent, AddToCart, CompletePayment).
LGT (мини-лендинг) — источник, откуда передаётся контекст события в Leeloo.AI.
Fallback — резервное значение, если переменная лида отсутствует.
3. Перед началом
Необходимо:
Зарегистрировать аккаунт TikTok.
Авторизоваться в TikTok Ads: https://ads.tiktok.com/
Иметь доступ к Leeloo.AI.
Рекомендуется заранее:
Определить список событий для передачи.
Определить нужные переменные лида.
Проверить, что в ключах/токенах нет лишних пробелов.
4. Пошаговая инструкция
Шаг 1. Переход в раздел Events Manager
В TikTok Ads перейдите в Tools → Events Manager.
Шаг 2. Создание Data Source
Нажмите Connect Data Source. Выберите Web.
Шаг 3. Выберите тип настройки
Шаг с URL пропустите (Skip). Выберите Manual Setup. Выберите Events API.
Шаг 4. Получите данные подключения
Укажите имя источника.
Выберите шаблон (например, Application submission).
Скопируйте Pixel ID.
Сгенерируйте и скопируйте Access Token.
Шаг 5. Скопируйте тестовый ключ
Перейдите в Test Events.
Скопируйте Test Event Code из правого окна.
Шаг 6. Перейдите в Leeloo.AI
Авторизуйтесь на платформе Leeloo.AI .
Перейдите в раздел Настройки → Рекламная аналитика (Ad Analytics).
Выберите TikTok и нажмите Добавить.
Шаг 7. Добавьте подключение TikTok
Заполните поля:
Имя - укажите Имя подключения на платформе Leeloo.AI
Пиксель ID - вставить Pixel ID скопированный ранее (Шаг 4). Или под именем вашего Data source в TikTok ADS кабинете.
Токен доступа - вставить Access Token из вашего Data source скопированного ранее (Шаг 4). Или во вкладке Settings вашего Data source, в разделе Events API.
Тестовый код - вставить скопированный Test Event Code из раздела Test events в вашем Data source (Шаг 5).
Нажмите Сохранить.
Шаг 8. Добавления событий
Нажмите на имя подключенного DataSet.
Нажмите Добавить событие (Add Event).
Укажите:
Имя события на платформе.
Тип события.
Ссылку на LGT (мини-лендинг) или ваш личный сайт.
Данные события.
Если необходимо подставлять значения из карточки клиента, выбирайте нужно вам переменную из списка переменных карточки лида, нажмите синий плюс (+).
Выберите переменную и задайте fallback (Например null).
Шаг 9. Проверьте тестовое событие
После создания и заполнения полей, нажмите ОК тестовое событие отправляется сразу.
Проверьте его в TikTok Ads → Events Manager → Test Events вашего Data source.
Отправка событий из платформы Leeloo.AI
В LGT:
Открыть ваш LGT, перейти во вкладку "Traffic"
Нажать кнопку "Добавить событие"
Указать:
1. Тип действия - "подписка"
2. Указать в поле "Аналитика" ранее созданную аналитику TikTok
3. Указать созданное событие которым вы хотите отследить факт подписки на бота.
4. Нажать кнопку "Сохранить"
В предложениях:
Перейти в раздел Туннели продаж → Предложения → Выбрать категорию нужного предложения
Перейти в предложение, на которое хотите добавить аналитику
Открыть "Рекламная аналитика". Нажать "+ Добавить событие"
Выбрать:
1. "Тип действия", который хотите передавать
2."Аналитика", которую ранее подключили из TikTok
3. Выбрать событие, которое заранее настроили для предложения
4. Нажать кнопку "Сохранить"
В туннеле продаж:
Перейти в раздел Туннели продаж → Выбрать нужный туннель
Нажать правой кнопкой мыши (для Windows)/двумя пальцами по тачпаду (для MacOS) в пустом месте рядом с LGT, с которого хотите передавать аналитику, выбрать "Действие"
Выбрать созданный блок. Выбрать "Рекламная аналитика"
Выбрать:
1. В поле "Аналитика" ранее созданную аналитику
2. Выбрать в поле "Событие" ранее созданное событие
3. Нажать кнопку "Сохранить"Соединить блок "Действие" с нужным блоком
Заключение
После выполнения всех шагов интеграция TikTok Events API с Leeloo.AI полностью готова к работе.
С этого момента серверные события будут корректно передаваться в TikTok Ads Manager, что даст бизнесу более точные сигналы конверсии для оптимизации рекламы.
Это позволит:
• улучшить качество обучения рекламных кампаний;
• повысить точность аналитики по ключевым действиям пользователей;
• снижать стоимость целевого действия за счёт оптимизации на реальных событиях.
Рекомендуем регулярно проверять Test Events и корректность передачи полей после изменений в воронках или формах Leeloo.AI