Інтеграція Adset pro з трекером Keitaro

Введення

Дане керівництво описує покроковий процес інтеграції платформи Adset.pro з трекером Keitaro. Після налаштування ви зможете:

• Направляти трафік з рекламного джерела через Adset.pro і Keitaro в партнерську програму

• Отримувати постбеки про конверсії (реєстрації, депозити) назад по всьому ланцюжку

• Бачити повну статистику по конверсіях в обох системах

Ролі систем

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

Джерело трафіку (FB, Google, TikTok...) ──► Adset.pro ──► Keitaro ──► Партнерська програма (офер)
                                          ◄── S2S Постбек ◄── Постбек ◄──

---

Крок 1: Додати партнерську мережу в Adset.pro

Оскільки для Adset.pro трекер Keitaro виступає в ролі партнерської мережі (CPA), необхідно додати його як CPA-мережу з шаблоном Keitaro. Це дозволить Adset.pro правильно формувати посилання і приймати постбеки від Keitaro.

Порядок дій

1. Перейдіть в розділ Трекер → Партнерські мережі

2. Натисніть кнопку "Партнерська мережа" (зелена кнопка з іконкою плюса)

3. Заповніть основні поля:

4. Шаблон Keitaro автоматично заповнить поля для налаштування постбеків:

5. Натисніть "Зберегти"

Важливо

Після збереження CPA-мережі скопіюйте URL постбека з налаштувань створеної партнерської програми — він знадобиться на наступному кроці для налаштування S2S постбека в Keitaro.

URL постбека має формат:

https://adset.pro/postback/?clickId={external_id}&status={status: lead=reg sale=dep}&revenue={revenue}&currency=USD

---

Крок 2: Додати джерело трафіку Adset.pro в Keitaro

Оскільки для Keitaro платформа Adset.pro виступає в ролі джерела трафіку, необхідно додати його як Traffic Source. Це дозволить Keitaro правильно приймати параметри з Adset.pro і відправляти постбеки назад.

Порядок дій

1. В панелі Keitaro перейдіть в Traffic Sources (Джерела трафіку)

2. Натисніть "Create" для додавання нового джерела

3. Заповніть налаштування:

4. Налаштуйте параметри для передачі даних:

   

5. Налаштуйте додаткові параметри (опціонально):

2.1 Налаштування S2S постбека в Keitaro

Для того щоб Adset.pro отримував інформацію про конверсії з Keitaro, необхідно налаштувати S2S (server-to-server) постбек в Keitaro.

1. В налаштуваннях джерела трафіку Adset.pro в Keitaro знайдіть секцію S2S Postback

   

2. Вставте URL постбека, скопійований з налаштувань партнерської програми в Adset.pro (Крок 1)

3. Для передачі нашого Click ID в постбеку використовуйте макрос Keitaro:

{external_id}

Зверніть увагу: макрос {external_id} — це внутрішній Click ID трекера Adset.pro, який передається через параметр external_id при переході на кампанію Keitaro.
Саме цей ідентифікатор використовується для зворотного зв'язку кліка з конверсією.

4. Збережіть налаштування джерела

---

Крок 3: Створити кампанію в Keitaro

Тепер потрібно створити кампанію в Keitaro, яка буде приймати трафік від Adset.pro і направляти його на офери партнерських програм.

Порядок дій

1. В панелі Keitaro перейдіть в Campaigns (Кампанії)

2. Натисніть "Create" для створення нової кампанії

3. В полі Traffic Source виберіть Adset.pro (створений на Кроці 2)

4. Налаштуйте кампанію (домен, фільтри, лендинги і т.д.)

5. Збережіть кампанію

6. Скопіюйте посилання на кампанію — воно знадобиться в Adset.pro

Посилання на кампанію в Keitaro має приблизний формат:

https://your-keitaro-domain.com/hashparam?external_id={event.event_click_id}

---

Крок 4: Налаштувати кампанію в Adset.pro

Використовуйте посилання на кампанію з Keitaro для створення зв'язок (оферів і флоу) в Adset.pro.

4.1 Створити офер

1. Перейдіть в Трекер → Офери

2. Натисніть "+ Офер"

3. Заповніть:

4. Збережіть офер

4.2 Створити флоу (посилання на офер)

1. Перейдіть в Трекер → Посилання на офери

2. Натисніть "+ Посилання на офери"

3. Заповніть:

4. В URL флоу обов'язково передайте {event.event_click_id} — ідентифікатор кліка Adset.pro:

https://your-keitaro-domain.com/campaign-alias?external_id={event.event_click_id}

Якщо на попередніх кроках ви все зробили правильно, то скопійоване посилання з Keitaro вже буде містити всі необхідні макроси. А поле URL для введення буде містити GET параметри з вашого посилання.

5. Збережіть посилання на офер

4.3 Використати флоу в кампанії

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

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

3. В стрім-сеті додайте створене посилання в ротацію

4. Налаштуйте фільтри (країна, пристрій) за необхідності

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

Трекінгове посилання використовуйте в рекламному кабінеті (Facebook, Google, TikTok та ін.) для запуску трафіку.

---

Повна схема роботи

                        РУХ ТРАФІКУ
                        ════════════════

1. Користувач клікає по рекламі (Facebook, Google, TikTok та ін.)
      │
      ▼
2. Adset.pro приймає клік, генерує Click ID (показує PWA)
      │
      ▼
3. Adset.pro перенаправляє на Keitaro (через URL налаштований в Посиланні на офер)
   URL: https://keitaro.com/campaign?external_id={event.event_click_id}
      │
      ▼
4. Keitaro приймає трафік від Adset.pro (як від джерела трафіку)
   Зберігає external_id (= Click ID Adset.pro)
      │
      ▼
5. Keitaro перенаправляє на офер партнерської програми
      │
      ▼
6. Користувач здійснює конверсію (реєстрація/депозит)

                        РУХ ПОСТБЕКІВ
                        ══════════════════

7. Партнерська програма відправляє постбек в Keitaro
      │
      ▼
8. Keitaro відправляє S2S постбек в Adset.pro
   URL: https://yourdomain.com/postback?clickId={external_id}&status=...
      │
      ▼
9. Adset.pro пов'язує конверсію з вихідним кліком по Click ID
      │
      ▼
10. Adset.pro відправляє постбек в джерело трафіку (FB, Google...)
      │
      ▼
11. Дані відображаються в статистиці всіх систем

---

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

• [ ] В Adset.pro створена Партнерська мережа з шаблоном Keitaro

• [ ] Скопійований URL постбека з налаштувань Партнерської мережі в Adset.pro

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

• [ ] В Keitaro налаштований S2S постбек з URL з Adset.pro

• [ ] В Keitaro створена кампанія з джерелом Adset.pro

• [ ] В Adset.pro створено офер, прив'язаний до Партнерської мережі Keitaro

• [ ] В Adset.pro створено Посилання на офер з URL кампанії Keitaro і макросом {event.event_click_id}

• [ ] Посилання на офер додано в ротацію стрім-сета кампанії Adset.pro

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

• [ ] Виконано тестову конверсію і перевірено прийом постбека

---

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