S2S Postback из Keitaro в Coinzilla

Цель: Настроить точную передачу конверсий из трекера Keitaro в рекламную сеть Coinzilla для оптимизации рекламных кампаний.

Этап 1: Подготовка необходимых данных

В отличие от многих сетей, Coinzilla не требует персонального ключа API или ID пикселя для базовой настройки постбэка. Вместо этого используется уникальный хэш клика.

Вам нужно будет определить только название события, которое вы планируете отслеживать.

Название события (EVENT_NAME): Это необязательный параметр. Если его не указать, Coinzilla по умолчанию назовет конверсию register. Вы можете задать свое имя, например, deposit или sale. Имя должно содержать только буквы, без цифр и спецсимволов.[1]

Этап 2: Создание и настройка источника трафика в Keitaro

Этот шаг научит Keitaro принимать и правильно обрабатывать данные от Coinzilla.

Откройте Keitaro. Перейдите в раздел "Источники" (Sources) и нажмите "Создать" (Create).
Заполните название:

Название (Name): Coinzilla.

Настройте параметры приема данных:codeCode# Логика этого действия: # Когда на Keitaro приходит ссылка вида: # https://your_keitaro_domain.com/campaign?uhash=VERY_LONG_STRING # Keitaro автоматически сохранит "VERY_LONG_STRING" в переменную {external_id}.

Coinzilla передает свой уникальный идентификатор клика в параметре под названием uhash. Keitaro должен сохранять это значение как {external_id}.[1]
Важное замечание: Coinzilla предупреждает, что значение uhash может быть очень длинной строкой (более 2500 символов). Убедитесь, что настройки вашего сервера и трекера позволяют обрабатывать такие длинные GET-параметры.[1]
В форме настройки источника, в секции "Параметры" (Parameters), укажите следующее:

В поле External ID впишите: uhash.

Настройка Postback URL:codePython# === Postback URL Template === # Описание: URL для отправки данных о конверсии в Coinzilla. # {external_id} - Макрос Keitaro, который будет заменен на {uhash}, # полученный от Coinzilla. # # Константы для замены: # YOUR_EVENT_NAME: Замените на название вашего события (например, deposit). # Этот параметр опционален. https://request-global.czilladx.com/s2s.php?uhash={external_id}&event=YOUR_EVENT_NAME

Это самый важный шаг. Здесь вы указываете URL, на который Keitaro будет отправлять уведомления о конверсиях.
Вставьте в поле Postback URL следующий шаблон.

Пояснение: Документация Coinzilla указывает конечную точку для S2S, но не предоставляет полного URL в явном виде. Представленный выше URL (s2s.php) является стандартным для таких систем и наиболее вероятным. Тем не менее, рекомендуется уточнить его у вашего менеджера в Coinzilla.
Пример заполненного URL:
https://request-global.czilladx.com/s2s.php?uhash={external_id}&event=deposit
Пример URL без указания события (будет засчитан как 'register'):
https://request-global.czilladx.com/s2s.php?uhash={external_id}

Сохраните источник трафика.

Этап 3: Применение источника в кампании Keitaro

Перейдите в раздел "Кампании" (Campaigns) и создайте новую или откройте существующую.
В настройках кампании, в поле "Источник" (Source), выберите созданный ранее Coinzilla.
Keitaro сгенерирует ссылку кампании. Скопируйте её.
Формирование финальной ссылки для Coinzilla:Когда пользователь нажмет на вашу рекламу, Coinzilla заменит {uhash} на реальное значение, которое и будет обработано Keitaro.

Возьмите ссылку из Keitaro (например, https://your_keitaro_domain.com/ABCDE).
Добавьте к ней в конце параметр ?uhash={uhash}. Coinzilla использует макрос {uhash} для передачи своего ID.
Ваша финальная ссылка для размещения в рекламных кампаниях Coinzilla будет выглядеть так:
https://your_keitaro_domain.com/ABCDE?uhash={uhash}

Этап 4: Пошаговая проверка и отладка интеграции

Для проверки корректности настройки выполните следующие шаги.

Шаг 1: Имитация клика

Возьмите вашу финальную ссылку для Coinzilla.
Замените макрос {uhash} на тестовое значение. Например: test_uhash_001.
Итоговая ссылка:
https://your_keitaro_domain.com/ABCDE?uhash=test_uhash_001
Перейдите по этой ссылке в браузере.

Шаг 2: Проверка логов Keitaro

В Keitaro откройте "Логи" > "Клики". Вы должны увидеть свой тестовый клик.
Убедитесь, что в колонке External ID для этого клика отображается test_uhash_001. Если да, значит, Keitaro правильно получает данные.

Шаг 3: Имитация конверсии и проверка постбэка

Инициируйте тестовую конверсию для этого клика (например, через партнерскую сеть или вручную в Keitaro).
Перейдите в "Логи" > "Постбэки".
Найдите исходящий запрос (Postback) на домен request-global.czilladx.com.
Проверьте полный URL запроса. Он должен содержать ваш тестовый uhash: ...&uhash=test_uhash_001.
Посмотрите на код ответа сервера в колонке "Код" (Code). Успешный ответ должен быть 200 OK или 204 No Content. Если вы видите ошибку (например, 4xx), проверьте правильность написания Postback URL и обратитесь в поддержку Coinzilla.

Если все шаги пройдены и постбэк ушел с кодом 200, ваша интеграция настроена правильно.