Keitaro

Передача конверсий AlterCPA TOP в Keitaro — это стандартная S2S-интеграция постбэков. Один ключевой шаг: используйте макрос идентификатора клика Keitaro в диплинке, чтобы идентификатор клика путешествовал из Keitaro в AlterCPA TOP и мы могли отправлять его обратно с каждым постбэком.

Ключевая идея

Ссылка трафика Keitaro → подставляет {subid} → диплинк AlterCPA TOP сохраняет его как {click}
AlterCPA TOP отправляет постбэк → передаёт {click} обратно в эндпоинт /postback Keitaro
Keitaro сопоставляет {click} с исходной записью клика → конверсия атрибутирована ✓

Макрос идентификатора клика Keitaro — {subid} (также называемый «внешним id» в некоторых версиях Keitaro). Всегда проверяйте название макроса в вашей панели Keitaro — перейдите в Кампании → (любая кампания) → Интеграции → S2S постбэк, чтобы увидеть названия параметров для вашей версии.

Шаг 1 — настройте диплинк в Keitaro

В вашей кампании Keitaro установите URL назначения (ссылку, на которую идёт трафик) на диплинк AlterCPA TOP, вставив макрос идентификатора клика Keitaro вместо ожидаемого {click}:

t.me/YourBot?start=CAMPAIGNCODE-{subid}

Замените CAMPAIGNCODE на ваш код кампании из AlterCPA TOP. Keitaro заменит {subid} реальным идентификатором клика в момент редиректа.

Шаг 2 — настройте URL постбэков в AlterCPA TOP

В разделе Постбэки вашей кампании (или в Профиль → Глобальные постбэки) укажите пять шаблонов, указывающих на S2S-эндпоинт постбэков Keitaro.

Замените your-keitaro.com на домен вашего Keitaro:

wait:    https://your-keitaro.com/postback?subid={click}&status=lead
hold:    https://your-keitaro.com/postback?subid={click}&status=lead
approve: https://your-keitaro.com/postback?subid={click}&status=sale
cancel:  https://your-keitaro.com/postback?subid={click}&status=rejected
trash:   https://your-keitaro.com/postback?subid={click}&status=rejected

Маппинг статусов:

Событие AlterCPA TOP	Рекомендуемый статус Keitaro
wait	`lead`
hold	`lead`
approve	`sale`
cancel	`rejected`
trash	`rejected`

Точные значения статусов, принимаемые Keitaro, зависят от вашей версии и настроек кампании. Проверьте Кампании → Конверсии → Статусы в Keitaro для полного списка допустимых значений.

Шаг 3 — проверьте в Keitaro

После тестового клика по диплинку откройте Keitaro → Отчёты и убедитесь, что конверсия появилась с правильным статусом. Если ничего нет, проверьте:

Макрос {subid} в диплинке подставляется (проверьте необработанный URL в журнале кликов Keitaro).
URL постбэка публично доступен (Keitaro должен быть доступен с наших серверов — не localhost и не внутренний IP).
Значение статуса принимается настройками конверсий вашей кампании Keitaro.

→ Как работает трекинг — полный справочник макросов и правила доставки.

AlterCPA Pro Binom