Інтеграція 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-154251.png

Оберіть TikTok і натисніть Додати.

image-20260306-154325.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-154419.png

Крок 8. Додавання подій

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

image-20260306-154443.png

Вкажіть:

  1. Ім’я події на платформі.

  2. Тип події.

  3. Посилання на LGT (міні-лендинг) або ваш особистий сайт.

  4. Дані події.

  5. Якщо потрібно підставляти значення з картки клієнта, обирайте потрібну змінну зі списку змінних картки ліда, натисніть синій плюс (+).
    Оберіть змінну і задайте fallback (Наприклад null).

image-20260306-154601.png

Крок 9. Перевірте тестову подію

Після створення та заповнення полів, натисніть ОК — тестова подія відправляється одразу.
Перевірте її в TikTok AdsEvents ManagerTest Events вашого Data source.

image-20260306-115204.png

Відправка подій із платформи Leeloo.AI

У LGT:

  1. Відкрити ваш LGT, перейти у вкладку "Traffic"

    image-20260306-155509.png
  2. Натиснути кнопку "Додати подію"

    image-20260306-155608.png

     

  3. Вказати:
    1. Тип дії - "підписка"
    2. Вказати у полі "Аналітика" раніше створену аналітику TikTok
    3. Вказати створену подію, якою хочете відстежити факт підписки на бота.
    4. Натиснути кнопку "Зберегти"

    image-20260306-155645.png

     

У пропозиціях:

  1. Перейти у розділ Тунелі продажів → Пропозиції → Обрати категорію потрібної пропозиції

    image-20260306-155746.png

     

  2. Перейти до пропозиції, до якої хочете додати аналітику

    image-20260306-155942.png

     

  3. Відкрити "Рекламна аналітика". Натиснути "+ Додати подію"

    image-20260306-163535.png

     

  4. Обрати:
    1. "Тип дії", який хочете передавати
    2."Аналітика", яку раніше підключили з TikTok
    3. Обрати подію, яку заздалегідь налаштували для пропозиції
    4. Натиснути кнопку "Зберегти"

    image-20260306-163610.png

У тунелі продажів:

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

    image-20260306-163700.png

     

  2. Натиснути правою кнопкою миші (для Windows)/двома пальцями по тачпаду (для MacOS) у пустому місці поруч із LGT, з якого хочете передавати аналітику, обрати "Дія"

    image-20260306-163745.png

     

  3. Обрати створений блок. Обрати "Рекламна аналітика"

    image-20260306-163815.png
  4. Обрати:
    1. У полі "Аналітика" раніше створену аналітику
    2. Обрати у полі "Подія" раніше створену подію
    3. Натиснути кнопку "Зберегти"

  5. З’єднати блок "Дія" з потрібним блоком

    image-20260306-163944.png

Висновок

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

Це дозволить:

• покращити якість навчання рекламних кампаній;
• підвищити точність аналітики за ключовими діями користувачів;
• знижувати вартість цільової дії завдяки оптимізації на реальних подіях.

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