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