Интеграция TikTok Events API с Leeloo.AI

Интеграция TikTok Events API с Leeloo.AI

UA

image-20240611-123449.png

US

image-20240611-123805.png

RU

image-20240611-131051.png

UA

image-20240611-123449.png

US

image-20240611-123805.png

RU

image-20240611-131051.png


Передача серверных событий в TikTok Ads предоставляет бизнесу более точный сигнал о реальных действиях пользователей внутри платформы Leeloo.AI. Это напрямую влияет на качество оптимизации и экономику вашей кампаний.

  • Лучшая оптимизация рекламы: алгоритм TikTok получает события конверсий и точнее находит аудиторию, которая выполняет целевое действие.

  • Более стабильные данные: серверная передача событий меньше зависит от блокировщиков, ограничений браузера и потерь клиентского трекинга.

  • Снижение стоимости лида: за счёт более качественных сигналов кампании быстрее выходят на эффективные связи и дают более низкий CPL.

  • Лучшая масштабируемость: когда события передаются корректно, проще масштабировать бюджеты без резкого падения качества лидов.

  • Более прозрачная аналитика: бизнес получает более полную картину пути от клика до конверсии и может принимать решения на основе фактических данных.

Как итог TikTok Events API в связке с Leeloo.AI — это не просто техническая интеграция, а инструмент для повышения ROMI, улучшения качества лидов и стабильного роста рекламных результатов.

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.

image-20260306-100024.png

Шаг 2. Создание Data Source

Нажмите Connect Data Source. Выберите Web.

image-20260306-100242.png

Шаг 3. Выберите тип настройки

Шаг с URL пропустите (Skip). Выберите Manual Setup. Выберите Events API.

image-20260306-100335.png
image-20260306-100537.png

Шаг 4. Получите данные подключения

Укажите имя источника.

image-20260306-100632.png


Выберите шаблон (например, Application submission).

image-20260306-100701.png


Скопируйте Pixel ID.

image-20260306-100738.png


Сгенерируйте и скопируйте Access Token.

image-20260306-100810.png

Шаг 5. Скопируйте тестовый ключ

Перейдите в Test Events.

image-20260306-102128.png

Скопируйте Test Event Code из правого окна.

image-20260306-102202.png

Шаг 6. Перейдите в Leeloo.AI

Авторизуйтесь на платформе Leeloo.AI .
Перейдите в раздел Настройки → Рекламная аналитика (Ad Analytics).

image-20260306-103755.png


Выберите TikTok и нажмите Добавить.

image-20260306-103834.png

Шаг 7. Добавьте подключение TikTok

Заполните поля:

  1. Имя - укажите Имя подключения на платформе Leeloo.AI

  2. Пиксель ID - вставить Pixel ID скопированный ранее (Шаг 4). Или под именем вашего Data source в TikTok ADS кабинете.

  3. Токен доступа - вставить Access Token из вашего Data source скопированного ранее (Шаг 4). Или во вкладке Settings вашего Data source, в разделе Events API.

  4. Тестовый код - вставить скопированный Test Event Code из раздела Test events в вашем Data source (Шаг 5).

  5. Нажмите Сохранить.

image-20260306-110125.png

Шаг 8. Добавления событий

Нажмите на имя подключенного DataSet.
Нажмите Добавить событие (Add Event).

image-20260306-112735.png

Укажите:

  1. Имя события на платформе.

  2. Тип события.

  3. Ссылку на LGT (мини-лендинг) или ваш личный сайт.

  4. Данные события.

  5. Если необходимо подставлять значения из карточки клиента, выбирайте нужно вам переменную из списка переменных карточки лида, нажмите синий плюс (+).
    Выберите переменную и задайте fallback (Например null).

image-20260306-113814.png

Шаг 9. Проверьте тестовое событие

После создания и заполнения полей, нажмите ОК тестовое событие отправляется сразу.
Проверьте его в TikTok AdsEvents ManagerTest Events вашего Data source.

image-20260306-115204.png

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

В LGT:

  1. Открыть ваш LGT, перейти во вкладку "Traffic"

    image-20260306-123028.png
  2. Нажать кнопку "Добавить событие"

    image-20260306-123108.png
  3. Указать:
    1. Тип действия - "подписка"
    2. Указать в поле "Аналитика" ранее созданную аналитику TikTok
    3. Указать созданное событие которым вы хотите отследить факт подписки на бота.
    4. Нажать кнопку "Сохранить"

    image-20260306-123352.png

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

  1. Перейти в раздел Туннели продаж → Предложения → Выбрать категорию нужного предложения

    1-20250116-135917.png
  2. Перейти в предложение, на которое хотите добавить аналитику

    1-20250116-140100.png
  3. Открыть "Рекламная аналитика". Нажать "+ Добавить событие"

    image-20260306-123629.png
  4. Выбрать:
    1. "Тип действия", который хотите передавать
    2."Аналитика", которую ранее подключили из TikTok
    3. Выбрать событие, которое заранее настроили для предложения
    4. Нажать кнопку "Сохранить"

    image-20260306-123739.png

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

  1. Перейти в раздел Туннели продаж → Выбрать нужный туннель

    1-20250116-141522.png
  2. Нажать правой кнопкой мыши (для Windows)/двумя пальцами по тачпаду (для MacOS) в пустом месте рядом с LGT, с которого хотите передавать аналитику, выбрать "Действие"

    1-20250116-141832.png
  3. Выбрать созданный блок. Выбрать "Рекламная аналитика"

    image-20260306-124149.png
  4. Выбрать:
    1. В поле "Аналитика" ранее созданную аналитику
    2. Выбрать в поле "Событие" ранее созданное событие
    3. Нажать кнопку "Сохранить"

  5. Соединить блок "Действие" с нужным блоком

    image-20260306-124348.png

Заключение

После выполнения всех шагов интеграция TikTok Events API с Leeloo.AI полностью готова к работе.
С этого момента серверные события будут корректно передаваться в TikTok Ads Manager, что даст бизнесу более точные сигналы конверсии для оптимизации рекламы.

Это позволит:

• улучшить качество обучения рекламных кампаний;
• повысить точность аналитики по ключевым действиям пользователей;
• снижать стоимость целевого действия за счёт оптимизации на реальных событиях.

Рекомендуем регулярно проверять Test Events и корректность передачи полей после изменений в воронках или формах Leeloo.AI