AlterCPA Pro — Внешние сайты

AlterCPA Pro получает наши постбэки через инструмент Внешние сайты — функцию, доступную в любом оффере Pro. Вы получаете токен сайта и два эндпоинта постбэков; мы отправляем запрос на нужный для каждого события лида.

Как работают Внешние сайты в Pro

Интеграция «Внешние сайты» позволяет внешней посадочной странице рекламодателя (или в нашем случае AlterCPA TOP) отправлять конверсии напрямую в трекер. Есть два эндпоинта:

Эндпоинт	Назначение
`api/site/click.json`	Регистрация нового визита / создание лида
`api/site/status.json`	Перевод существующего лида в новый статус

Аутентификация — параметр token в запросе, содержащий токен сайта, который выдаётся при создании внешнего сайта в Pro.

Собственная документация Pro находится по адресу www.altercpa.pro/help/section-external.

Настройка в Pro

Откройте любой оффер в AlterCPA Pro и перейдите в Внешние сайты → Добавить сайт.
Создайте новый внешний сайт. Вы получите токен сайта — скопируйте его в настройки трекера AlterCPA TOP в поле token.
Идентификатор клика, который вы хотите сопоставлять, — это значение, передаваемое в параметре click в click.json. Мы берём его из диплинка.

Маппинг наших пяти событий

Используйте {domain} и {token} из настроек внешнего сайта в Pro. {click} и {lead} — макросы AlterCPA TOP, подставляемые в момент отправки.

wait:    https://{domain}/api/site/click.json?token={token}&click={click}&exto={lead}
hold:    https://{domain}/api/site/status.json?token={token}&click={click}&status=hold&auto=1&exto={lead}
approve: https://{domain}/api/site/status.json?token={token}&click={click}&status=approve&auto=1&exto={lead}
cancel:  https://{domain}/api/site/status.json?token={token}&click={click}&status=cancel&auto=1&exto={lead}
trash:   https://{domain}/api/site/status.json?token={token}&click={click}&status=trash&auto=1&exto={lead}

Параметры:

Параметр	Значение	Примечания
`token`	`{token}`	Токен сайта из раздела «Внешние сайты» в Pro
`click`	`{click}`	Макрос AlterCPA TOP — идентификатор клика из диплинка
`exto`	`{lead}`	Наш id лида; используется Pro для дедупликации (обязателен в каждом вызове)
`auto=1`	фиксировано	Говорит Pro создать лид автоматически, если он ещё не существует

Почему wait использует click.json, а остальные — status.json:
click.json регистрирует начальный визит (создаёт запись лида в Pro). status.json переводит существующий лид. Поэтому первое событие (wait, когда подписчик нажимает «Старт») создаёт лид Pro; последующие события обновляют его.

Настройка диплинка

В источнике трафика вашей кампании Pro настройте подстановку идентификатора клика в позицию {click} диплинка AlterCPA TOP:

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

Макрос идентификатора клика Pro в ссылках трафика, как правило, {click} — проверьте в настройках вашей кампании Pro.

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

Симптом	Вероятная причина
Лид не создан в Pro	Постбэк `wait` не отправляется — проверьте URL `click.json` и токен сайта
Статус не обновляется	Неверное значение `status` или отсутствует `auto=1` в вызовах `status.json`
Ошибки «Forbidden»	Неверный токен сайта — скопируйте его заново из «Внешних сайтов» в AlterCPA Pro

AlterCPA Lite Keitaro