S2S Postback из Keitaro в Cointraffic

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

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

Перед началом настройки в Keitaro, убедитесь, что вы получили от вашего менеджера в Cointraffic следующие данные:

1. Уникальный ID пикселя (UNIQUE_PIXEL_ID): Это ваш персональный идентификатор в системе Cointraffic.
• Пример: a1b2c3d4e5f6
2. Название события (EVENT_NAME): Вы должны определить, какое именно действие будет считаться конверсией. Это название вы будете использовать в Postback URL.
• Примеры: registration, deposit, signup, first_deposit

Без этих данных настройка невозможна.

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

На этом шаге мы научим Keitaro правильно принимать и обрабатывать трафик из Cointraffic.

1. Откройте Keitaro. Перейдите в раздел "Источники" (Sources).
2. Нажмите кнопку "Создать" (Create).
3. Заполните основные поля:
• Название (Name): Введите Cointraffic. Это имя будет отображаться в ваших отчетах.
4. Настройте параметры приема данных:
• Keitaro должен знать, какой параметр в ссылке от Cointraffic содержит уникальный ID клика. По умолчанию, Cointraffic передает его в параметре click_id. Keitaro сохраняет это значение в макрос {external_id}.
• В форме настройки источника найдите секцию "Параметры" (Parameters).
• В поле External ID впишите click_id.

codeCode

# Логика этого действия:

# Когда на Keitaro приходит ссылка вида:

# https://your_keitaro_domain.com/campaign?click_id=SOME_VALUE

# Keitaro автоматически сохранит "SOME_VALUE" в переменную {external_id}

1. Настройка Postback URL:
• В этой же форме найдите поле Postback URL.
• Вставьте в него следующий шаблон URL. Этот шаблон является полным и готовым к использованию после замены констант.

# === Postback URL Template ===

# Описание: URL для отправки данных о конверсии в Cointraffic.

# {external_id} - Макрос Keitaro, который будет заменен на ID клика,

# полученный от Cointraffic.

#

# Константы для замены:

# YOUR_UNIQUE_PIXEL_ID: Замените на ваш ID пикселя от Cointraffic.

# YOUR_EVENT_NAME: Замените на название вашего события.

https://apps-pxl.ctengine.io/e?k=YOUR_UNIQUE_PIXEL_ID&ev=YOUR_EVENT_NAME&click_id={external_id}

• Пример заполненного URL для события "registration":
  https://apps-pxl.ctengine.io/e?k=a1b2c3d4e5f6&ev=registration&click_id={external_id}
1. (Опционально) Настройка статусов постбэка:
• Если вы хотите отправлять постбэки только для подтвержденных конверсий, используйте опцию "Отправлять постбэки со статусами" (Send postbacks with statuses).
• Выберите нужные статусы, например, lead (для лидов) или sale (для продаж/депозитов). Конверсии с другими статусами (например, rejected) отправляться не будут.
2. Сохраните источник трафика, нажав кнопку "Создать" (Create) или "Сохранить" (Save).

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

1. Перейдите в раздел "Кампании" (Campaigns) и создайте новую кампанию или откройте существующую.
2. В настройках кампании, в поле "Источник" (Source), выберите созданный на предыдущем шаге Cointraffic.
3. Keitaro автоматически сгенерирует ссылку кампании. Она будет выглядеть примерно так:
   https://your_keitaro_domain.com/ABCDE?click_id={click_id}
• Заметьте, что Keitaro сам подставил параметр click_id={click_id}.
4. Скопируйте эту сгенерированную ссылку. Именно ее вы должны использовать в качестве целевой URL для ваших рекламных объявлений на платформе Cointraffic. Cointraffic, в свою очередь, заменит плейсхолдер {click_id} на реальное значение при клике пользователя.

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

Чтобы убедиться, что всё настроено верно, проведите тестовую конверсию.

• Шаг 1: Имитация клика
1. Возьмите ссылку вашей кампании из Keitaro.
2. Вручную замените макрос {click_id} на тестовое значение. Например: test_click_001.
3. Итоговая ссылка будет выглядеть так:
   https://your_keitaro_domain.com/ABCDE?click_id=test_click_001
4. Перейдите по этой ссылке в браузере.
• Шаг 2: Имитация конверсии
1. Пройдите по воронке (например, зарегистрируйтесь на лендинге), чтобы сработала конверсия. Если вы тестируете с партнерской сетью, вам может потребоваться инициировать тестовую конверсию там.
• Шаг 3: Анализ логов в Keitaro
1. Перейдите в Keitaro, в раздел "Логи" > "Клики". Найдите ваш клик со значением test_click_001 в колонке External ID. Убедитесь, что для него отобразилась конверсия.
2. Перейдите в "Логи" > "Постбэки". Здесь вы должны увидеть исходящий запрос (Postback) на URL Cointraffic.
3. Проверьте, что в отправленной ссылке click_id равен вашему тестовому значению (test_click_001).
4. Проверьте колонку "Код" (Code) для этой записи. Успешным считается ответ сервера 200 или 204. Если вы видите ошибку (например, 400 или 404), это означает, что URL составлен неверно или UNIQUE_PIXEL_ID указан неправильно.

Если все шаги пройдены и ответ сервера 200, настройка завершена успешно.