Adset.ProAdset.ProKnowledge base
Home/Інтеграції/Інтеграція Adset.pro з сервісом клоакінгу Veloraad.pro

Інтеграція Adset.pro з сервісом клоакінгу Veloraad.pro

Введення

Дане керівництво описує покроковий процес інтеграції платформи Adset.pro з сервісом клоакінгу Veloraad.pro для заливу трафіку з TikTok. Veloraad.pro виступає в ролі «клоаки»: віддає модераторам і ботам white-page, а реальному користувачу — цільове (money) посилання вашої кампанії Adset.pro.

Після налаштування ви зможете:

  • Пропускати трафік з TikTok через клоакінг Veloraad.pro перед попаданням на вашу кампанію Adset.pro

  • Коректно передавати всі параметри і макроси TikTok (Click ID, креатив, кампанія, адгрупа) по всьому ланцюжку

  • Бачити повну статистику по джерелу в Adset.pro і атрибутувати конверсії

Схема руху трафіку

TikTok Ads ──► Veloraad.pro (клоака) ──► Кампанія Adset.pro ──► PWA / Офер
                     │
              бот/модератор ──► White Page

Ключова ідея: в рекламі TikTok використовується посилання Veloraad.pro. Реальному користувачу клоака віддає ваше трекінгове посилання кампанії Adset.pro з усіма GET-параметрами TikTok, за якими Adset.pro розпізнає джерело і наповнює статистику.


Крок 1: Додати джерело трафіку TikTok в Adset.pro з шаблону

Щоб всі параметри TikTok передавалися автоматично, додайте джерело з готового шаблону TikTok — в ньому вже сформовані всі потрібні параметри і макроси, нічого вписувати вручну не потрібно.

Порядок дій

  1. Перейдіть в розділ Трекер → Джерела трафіку

  2. Натисніть кнопку «Джерело» (зелена кнопка з іконкою плюса)

  3. В полі «Вибрати з шаблону» виберіть TikTok

  4. Шаблон автоматично підставить набір параметрів і макросів:

GET-параметр

Макрос TikTok

Що передає

ttqid

__CLICKID__

ID кліка TikTok (Click ID)

creative_id

__CID__

ID креативу, з якого прийшов клік

creative_name

__CID_NAME__

Назва креативу

ad_campaign_id

__CAMPAIGN_ID__

ID рекламної кампанії

campaign_name

__CAMPAIGN_NAME__

Назва рекламної кампанії

adgroup_id

__AID__

ID адгрупи (групи оголошень)

adgroup_name

__AID_NAME__

Назва адгрупи

  1. Задайте назву джерела (наприклад, TikTok) і натисніть «Зберегти»

Важливо. Передача пікселя (параметр ttq) в цій зв'язці не використовується — піксель і відправка конверсій налаштовуються окремо на стороні Adset.pro (розділ Пікселі). До посилання клоаки параметр ttq додавати не потрібно.


Крок 2: Налаштувати кампанію в Adset.pro і скопіювати трекінгове посилання

Після додавання джерела створіть (або відкрийте) кампанію, яка буде приймати трафік, і отримайте її трекінгове посилання.

Порядок дій

  1. Перейдіть в Трекер → Кампанії

  2. Створіть нову кампанію або відкрийте існуючу

  3. В налаштуваннях кампанії в полі «Джерело трафіку» виберіть створене на Кроці 1 джерело TikTok

  4. Налаштуйте стрім-сет (PWA / лендинг / посилання на офер), фільтри і піксель за необхідності

  5. Збережіть кампанію і скопіюйте трекінгове посилання

За рахунок вибраного джерела TikTok трекінгове посилання вже буде містити всі GET-параметри з макросами TikTok, наприклад:

https://домен-вашої-кампанії/click?ttqid=__CLICKID__&creative_id=__CID__&creative_name=__CID_NAME__&ad_campaign_id=__CAMPAIGN_ID__&campaign_name=__CAMPAIGN_NAME__&adgroup_id=__AID__&adgroup_name=__AID_NAME__

Саме це посилання (і його GET-параметри) ми використовуємо далі в Veloraad.pro.


Крок 3: Налаштування в Veloraad.pro

3.1 Додати домен

  1. В панелі Veloraad.pro перейдіть в розділ доменів і додайте свій домен

  2. В Cloudflare у цього домену пропишіть A-запис, що вказує на IP-адресу сервера Veloraad.pro (актуальний IP береться з інструкції/панелі Veloraad.pro)

  3. Дочекайтеся застосування DNS і переконайтеся, що домен в Veloraad.pro перейшов в активний статус

3.2 Додати кампанію

  1. Створіть нову кампанію в Veloraad.pro

  2. Заповніть дані кампанії. В якості посилання на офер (money / цільове посилання) використовуйте трекінгове посилання кампанії Adset.pro з Кроку 2

  3. Виберіть домен, доданий на кроці 3.1

  4. Налаштуйте Фільтри і Гео (white-page для ботів/модераторів, гео-таргетинг під вашу кампанію)

  5. Збережіть зміни

3.3 Додати GET-параметри до посилання з Veloraad.pro

Після збереження кампанії Veloraad.pro видасть підсумкове (заклоаковане) посилання короткого виду, наприклад:

https://bleacn.icu/bf1ad4

До цього посилання необхідно вручну додати всі GET-параметри з трекінгового посилання кампанії Adset.pro (Крок 2). Поставте ? і без пробілів допишіть параметри:

https://bleacn.icu/bf1ad4?ttqid=__CLICKID__&creative_id=__CID__&creative_name=__CID_NAME__&ad_campaign_id=__CAMPAIGN_ID__&campaign_name=__CAMPAIGN_NAME__&adgroup_id=__AID__&adgroup_name=__AID_NAME__

Зверніть увагу:

  • Параметри беруться як є з трекінгового посилання Adset.pro — макроси (__CLICKID__ і ін.) підставить сам TikTok при показі реклами.

  • Параметр пікселя ttq додавати не потрібно — він в цій зв'язці не передається.

  • Якщо в самому Veloraad.pro є пункт Sub Id (передача параметрів після клоакінгу), параметри можна прописати там — результат буде той же.


Крок 4: Використати підсумкове посилання в рекламній кампанії TikTok

Отримане на кроці 3.3 посилання (домен Veloraad.pro + GET-параметри) вкажіть в якості цільового URL в рекламній кампанії TikTok. Після цього:

  • Боти і модератори TikTok побачать white-page Veloraad.pro;

  • Реальний користувач буде перенаправлений на вашу кампанію Adset.pro;

  • Усі параметри TikTok коректно дійдуть до Adset.pro і потраплять в статистику.


Чек-лист перед запуском

  • [ ] В Adset.pro додано джерело трафіку з шаблону TikTok

  • [ ] Створена/налаштована кампанія Adset.pro з цим джерелом, скопійоване трекінгове посилання

  • [ ] В Veloraad.pro додано домен, в Cloudflare прописаний A-запис на IP сервера Veloraad.pro

  • [ ] В Veloraad.pro створена кампанія: в полі офера — трекінгове посилання Adset.pro, вибрано домен, налаштовані Фільтри і Гео

  • [ ] До заклоакованого посилання Veloraad.pro додані всі GET-параметри з трекінгового посилання Adset.pro (без ttq)

  • [ ] Підсумкове посилання вставлене в рекламну кампанію TikTok

  • [ ] Виконано тестовий клік і перевірена передача Click ID і параметрів в статистиці Adset.pro


Усунення проблем

Проблема

Рішення

Параметри TikTok приходять порожніми

Переконайтеся, що GET-параметри дописані до заклоакованого посилання Veloraad.pro (після ?, без пробілів) і що в кампанії Adset.pro вибрано джерело TikTok.

Трафік не доходить до кампанії Adset.pro

Перевірте A-запис домену в Cloudflare (IP сервера Veloraad.pro) і що в кампанії Veloraad.pro в якості money-посилання вказане саме трекінгове посилання Adset.pro.

Весь трафік йде на White Page

Перевірте налаштування Фільтрів і Гео в кампанії Veloraad.pro — занадто суворі правила можуть відправляти реальних користувачів на white-page.

Конверсії не відправляються в TikTok

Відправка конверсій виконується через TikTok Pixel в Adset.pro (розділ Пікселі), а не через параметр ttq в посиланні. Перевірте налаштування пікселя в кампанії Adset.pro.