Нужен ли API-ключ, чтобы подключить Keitaro?

Нет. Трекинговые ссылки и постбэки настраиваются в портале партнёра, ключ для них не нужен. Ключ нужен, только если вы хотите читать свои отчёты и комиссии по API.

Какой токен ставить в sub1 для Keitaro?

{subid}. Keitaro при каждом клике заменяет его на свой click ID, а RevRake возвращает значение в постбэке как {sub1}.

Какие события RevRake может отправлять в Keitaro?

Шесть: registration, ftd, commission_approved, commission_rejected, commission_paid и chargeback. Нужные вы отмечаете для каждого адреса назначения.

Передаётся ли в постбэке сумма депозита?

Шаблоны отправляют вашу комиссию в {commission}. Депозит, за который она начислена, доступен как {amount}, а его валюта — в {amount_currency}: добавьте их в шаблон, если в Keitaro есть для них параметр.

Можно ли отправлять конверсии в Keitaro и в другой трекер одновременно?

Да. В аккаунте может быть до 10 адресов назначения, у каждого свой шаблон и свои события.

Что будет, если Keitaro недоступен в момент конверсии?

Постбэк повторяется шесть раз в течение примерно полутора суток. Каждая попытка сохраняется в журнале доставок, а остановленную доставку можно отправить снова вручную.

Как подключить Keitaro к RevRake: ссылка и постбэк

Что нужно взять из Keitaro

Две вещи: токен, вместо которого Keitaro подставляет свой click ID, — это {subid}, — и адрес вашего постбэка с названиями его параметров. Каждый параметр RevRake заполняет макросом:

Параметр Keitaro	Чем заполняется	Значение
`subid`	`{sub1}`	`sub1` клика: click ID, который ваш трекер подставил в ссылку.
`status`	`{status}`	Слово, которое показывает состояние конверсии, — из тех слов, которые знает Keitaro. Они приведены в таблице ниже.
`payout`	`{commission}`	Ваша комиссия в виде десятичного числа (`40.00`). Пусто для регистрации, `0` для отклонённой комиссии, отрицательное число для чарджбэка.
`currency`	`{currency}`	ISO-код валюты комиссии.
`tid`	`{conversion_id}`	ID, одинаковый для всех событий об одной комиссии: её первого депозита, одобрения, отклонения, выплаты и чарджбэка. У регистрации он свой.

Keitaro показывает адрес постбэка в разделе Settings → Postback URL. Он состоит из адреса трекера, вашего ключа постбэка и параметров конверсии: в шаблоне замените YOUR-TRACKER-DOMAIN и POSTBACK-KEY на эти две части вашего собственного адреса.

В Keitaro параметры subid и status обязательны; payout, currency и tid — нет. tid — это ID транзакции в Keitaro: постбэк с tid, которого Keitaro ещё не видел, записывается как отдельная конверсия, а постбэк с уже известным tid изменяет ту конверсию. Пресет подставляет туда {conversion_id}.

Пошагово в RevRake

1Создайте трекинговую ссылку

Откройте страницу «Трекинговые ссылки» в портале партнёра и создайте по одной ссылке на кампанию. У каждой ссылки свой короткий адрес на track.revrake.com, и она может вести на выбранную вами страницу сайта программы.

2Передайте click ID из Keitaro в sub1

Добавьте к ссылке sub1= с токеном click ID трекера Keitaro и используйте результат как URL оффера в Keitaro:

https://track.revrake.com/c/a8Kq2Zx?sub1={subid}

Keitaro при каждом клике заменяет {subid} на свой click ID. RevRake сохраняет значение вместе с кликом, до 200 символов, и возвращает его в ваших постбэках как {sub1}. Параметры от sub2 до sub5 свободны для ваших собственных значений; UTM-метки в ссылке тоже сохраняются.

3Добавьте адрес для постбэков

Откройте страницу «Постбэки» и нажмите «Добавить адрес». Адрес — это шаблон: всё в фигурных скобках — макросы, которые RevRake заполняет для каждой конверсии.

https://YOUR-TRACKER-DOMAIN/POSTBACK-KEY/postback?subid={sub1}&status={status}&payout={commission}&currency={currency}&tid={conversion_id}

В RevRake этот шаблон есть в виде пресета Keitaro: выберите Keitaro в списке, и шаблон заполнится сам.

Замените YOUR-TRACKER-DOMAIN на адрес вашего собственного постбэка в Keitaro — так, как Keitaro его показывает. Портал не примет шаблон, в котором остался хост-плейсхолдер. Если в адресе вашего постбэка параметр называется иначе, чем в шаблоне, поменяйте название, а макрос оставьте.

4Выберите события

Отметьте события, о которых должен узнавать этот адрес назначения. registration и ftd сообщают в Keitaro о новом игроке и его первом депозите в течение нескольких секунд после того, как о них сообщил оператор. commission_approved, commission_rejected, commission_paid и chargeback отражают дальнейшее движение денег.

У постбэка в RevRake два ID. {conversion_id} одинаков для всех событий об одной комиссии, поэтому трекер, который обновляет конверсию по её ID, хранит одну конверсию на комиссию. {event_id} свой для каждого события. Пресет Keitaro использует тот из них, который подходит к тому, как Keitaro обращается с повторным ID; какой именно, сказано в разделах ниже. В аккаунте может быть до 10 адресов назначения.

5Отправьте тест и проверьте журнал доставок

Нажмите «Отправить тест» у адреса назначения. RevRake сразу отправляет вымышленную конверсию и показывает, что ответил Keitaro и как быстро. Тест выглядит как первый депозит: в нём передаются click ID TEST-CLICK-ID и комиссия 40.00. Keitaro не знает такого клика, поэтому может проигнорировать тест или ответить ошибкой: тест показывает, что адрес доступен и как выглядит заполненный адрес.

Для сквозной проверки откройте ссылку кампании через Keitaro, чтобы в sub1 передался настоящий click ID, и попросите оператора зарегистрировать с этого перехода тестового игрока. После этого конверсия появится в журнале доставок — с каждой попыткой и ответом трекера Keitaro — и в самом Keitaro.

Чему {status} соответствует в Keitaro

RevRake называет каждое событие и, кроме того, даёт ему слово-статус. Адрес назначения, созданный из пресета Keitaro, отправляет в {status} слова, которые знает Keitaro; в {event} всегда передаётся название события. Адрес назначения, созданный через «Другой / свой», отправляет lead, sale, approved, rejected и paid.

Событие	`{status}`	Когда
`registration`	`lead`	Игрок атрибутирован партнёру.
`ftd`	`sale`	Первый депозит принёс партнёру CPA-комиссию.
`commission_approved`	`sale`	Комиссия одобрена по окончании холда.
`commission_rejected`	`rejected`	Комиссия в холде отклонена после проверки.
`commission_paid`	`sale`	Комиссия выплачена в пакете выплат.
`chargeback`	`rejected`	Чарджбэк снял комиссию.

Keitaro знает lead, sale и rejected, а постбэк с незнакомым статусом игнорирует. Поэтому пресет отправляет sale также для одобренной и для выплаченной комиссии. У них тот же tid, что и у первого депозита, поэтому Keitaro хранит одну продажу на комиссию и не считает её повторно.

Отклонение и чарджбэк приходят как rejected с tid комиссии и переводят эту продажу в отклонённые. Какие смены статуса допускает Keitaro, задаётся в поле "Next statuses" у каждого типа конверсии, в разделе Settings → Conversion Types. Регистрация — это lead со своим собственным tid.

Решение проблем

В Keitaro нет конверсий. Откройте журнал доставок на странице «Постбэки». Если строки нет, событие ещё не произошло или оно не отмечено для этого адреса назначения. Если строка есть, в ней видно, какой адрес был вызван и что ответил Keitaro.
Click ID приходит пустым. У клика не было sub1. Проверьте, что URL оффера в Keitaro заканчивается на sub1= и {subid} и что клик прошёл через Keitaro: у ссылки, открытой напрямую, нет click ID, который можно передать.
Макрос приходит как написан, в фигурных скобках. Незнакомое название RevRake отправляет без изменений, поэтому опечатка видна в журнале доставок. Сверьте название со списком макросов.
Выплата пустая или нулевая. Регистрация не несёт денег, поэтому {commission} для неё пуст. Для отклонённой комиссии он равен 0, для чарджбэка — отрицательный.
Доставка не удалась. Keitaro должен быть доступен по публичному адресу и отвечать статусом 2xx в течение 5 секунд. Неудачная доставка повторяется через 1 минуту, 5 минут, 25 минут, 2 часа, 10 часов и 24 часа, после чего помечается как остановленная; её можно отправить снова вручную.
Адрес назначения был выключен. После 20 неудач подряд RevRake выключает адрес назначения; после 5 и после 15 приходит e-mail. Исправьте адрес и включите его снова: все постбэки, которые за это время встали в очередь, будут отправлены.
В логе Keitaro написано "Conversion type not found". Keitaro не знает это слово-статус. Так бывает с адресом назначения, созданным через «Другой / свой»: он отправляет approved и paid. Выберите для него пресет Keitaro.
Один и тот же игрок посчитан в Keitaro несколько раз. У адреса назначения, сохранённого с более ранней версией пресета, в адресе стоит tid={event_id}, а это значение своё для каждого события. Отредактируйте адрес назначения и впишите tid={conversion_id}.

Keitaro — продукт своего разработчика (https://keitaro.io/) и упомянут здесь только для того, чтобы назвать трекер, которому посвящено руководство. RevRake с ним не связан.

Вопросы

Нужен ли API-ключ, чтобы подключить Keitaro?: Нет. Трекинговые ссылки и постбэки настраиваются в портале партнёра, ключ для них не нужен. Ключ нужен, только если вы хотите читать свои отчёты и комиссии по API.
Какой токен ставить в sub1 для Keitaro?: {subid}. Keitaro при каждом клике заменяет его на свой click ID, а RevRake возвращает значение в постбэке как {sub1}.
Какие события RevRake может отправлять в Keitaro?: Шесть: registration, ftd, commission_approved, commission_rejected, commission_paid и chargeback. Нужные вы отмечаете для каждого адреса назначения.
Передаётся ли в постбэке сумма депозита?: Шаблоны отправляют вашу комиссию в {commission}. Депозит, за который она начислена, доступен как {amount}, а его валюта — в {amount_currency}: добавьте их в шаблон, если в Keitaro есть для них параметр.
Можно ли отправлять конверсии в Keitaro и в другой трекер одновременно?: Да. В аккаунте может быть до 10 адресов назначения, у каждого свой шаблон и свои события.
Что будет, если Keitaro недоступен в момент конверсии?: Постбэк повторяется шесть раз в течение примерно полутора суток. Каждая попытка сохраняется в журнале доставок, а остановленную доставку можно отправить снова вручную.

Источники

Всё, что в этом руководстве сказано о Keitaro, взято из собственной документации Keitaro в том виде, в каком она была на указанную дату. Трекеры меняются: если название на вашей странице постбэка отличается от этого руководства, верьте своей странице постбэка. Сказанное о RevRake есть в руководстве по интеграции и в справочнике API.

Postback | Keitaro https://docs.keitaro.io/en/conversions-and-postback/postback.html прочитано 4 октября 2026 г.
Affiliate network postback | Keitaro https://docs.keitaro.io/en/conversions-and-postback/affiliate-network-postback.html прочитано 4 октября 2026 г.
Conversion types | Keitaro https://docs.keitaro.io/en/settings/conversion-types.html прочитано 4 октября 2026 г.
Placeholders | Keitaro https://docs.keitaro.io/en/landing-pages-and-offers/placeholders.html прочитано 4 октября 2026 г.
Postback Troubleshooting | Keitaro https://docs.keitaro.io/en/conversions-and-postback/postback-troubleshooting.html прочитано 4 октября 2026 г.

Как подключить Keitaro к RevRake.