Введение

Данное руководство описывает пошаговый процесс интеграции платформы 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 при переходе на кампанию кейтаро.
Именно этот идентификатор используется для обратного связывания клика с конверсией.

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}

Если на предыдущих шагах вы все сделали правильно, то скопированная ссылка из кейтаро уже будет содержать все необходимые макросы. А поле 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

• [ ] Выполнена тестовая конверсия и проверен приём постбэка

---

Устранение проблем