Руководство по интеграции Keitaro

Чтобы настроить отслеживание конверсий сервер-сервер (S2S) для сети Blockchain-Ads с помощью Keitaro, вы настроите Blockchain-Ads для генерации URL постбэка (куда Keitaro будет отправлять данные о конверсиях), а затем интегрируете его как пользовательский источник трафика в Keitaro. Это гарантирует, что Keitaro захватывает {clickid} из входящего трафика и отправляет постбэки обратно в Blockchain-Ads с соответствующими ID кликов, доходом и другими деталями.

Шаг 1: Создайте событие конверсии S2S в Blockchain-Ads

1. Войдите в панель управления Blockchain-Ads HUB.
2. Перейдите в Advertising > Tracking > Create Conversion > Server to Server.
3. Следуйте инструкциям на экране для настройки события:
   
   • Назовите событие конверсии (например, "Lead" или "Sale").
   • Укажите тип события (например, lead, purchase) и любые поля дохода, если применимо.
   • Это сгенерирует уникальный ID трекера для вашего события и URL постбэка в формате:

GET https://server.blockchain-ads.com/www/delivery/tracker-mobile.php?clickid={clickid}&trackerid=YOUR_TRACKERID&transaction_value={transaction_value}

• {clickid}: Заполнитель для уникального ID клика (Blockchain-Ads сопоставит его с исходным кликом).
• trackerid: Ваш фиксированный ID события (не изменяйте его).
• {transaction_value}: Необязательный заполнитель для суммы дохода/оплаты (опустите, если не отслеживаете доход).

Скопируйте этот полный URL постбэка—он понадобится вам в Keitaro.

4. Сохраните событие. Примечание: При создании кампаний в Blockchain-Ads установите ваш целевой URL на URL вашей кампании Keitaro (например, https://your-keitaro-domain.com/campaign123?clickid={clickid}). Blockchain-Ads автоматически добавит фактическое значение ID клика.

Шаг 2: Добавьте Blockchain-Ads как пользовательский источник трафика в Keitaro

1. Войдите в панель управления Keitaro.
2. Перейдите в Traffic Sources > Create.
3. В поле "From template" найдите "Blockchain-Ads"—если шаблона нет, выберите Custom или оставьте пустым для ручной сборки.
4. Заполните основные данные:
   
   • Name: "Blockchain-Ads".
   • Параметр Click ID: Установите его на clickid (это говорит Keitaro захватывать входящее значение ?clickid=xxx из трафика Blockchain-Ads и хранить его внутренне как внешний ID для постбэков).
5. В разделе шаблона параметров (если предложено):
   
   • Добавьте строку для ID клика:
     
     • Столбец 1 (Alias): Оставьте пустым или установите "External ID" для отчетности.
     • Столбец 2 (Parameter name): clickid.
     • Столбец 3 (Macro): Оставьте пустым (так как Blockchain-Ads добавляет фактическое значение напрямую).
   • При необходимости добавьте другие параметры (например, для ID кампании или subID из макросов Blockchain-Ads).
6. В поле S2S Postback:
   
   • Вставьте URL постбэка из шага 1.
   • Замените заполнители Blockchain-Ads эквивалентами Keitaro:
     
     • {clickid} → {external_id} (передает захваченный ID клика обратно).
   • Пример преобразованного URL:

https://server.blockchain-ads.com/www/delivery/tracker-mobile.php?clickid={external_id}&trackerid=YOUR_TRACKERID&transaction_value={revenue}

Если вы хотите отправлять только определенные статусы конверсии (например, одобренные лиды), используйте выпадающее меню "Send only statuses" для их выбора (например, "Lead", "Sale").

7. Нажмите Create, чтобы сохранить источник трафика.
8. (Необязательно) Если у вас есть несколько кампаний, отметьте Update in campaigns, чтобы применить это к существующим.

Шаг 3: Настройте кампанию в Keitaro и проведите тестирование

1. Перейдите в Campaigns > Create (или отредактируйте существующую).
2. Выберите Blockchain-Ads в качестве Traffic Source.
3. Создайте ваш поток: Добавьте потоки, лендинги и предложения. Для конверсий:
   
   • Если используете аффилиатские предложения, настройте постбэки от аффилиатской сети к Keitaro (в разделе Affiliate Networks).
   • Определите правила конверсии (например, S2S постбэк от предложения, запуск пикселя или пользовательские события).
4. Сгенерируйте и скопируйте URL вашей кампании Keitaro (он будет выглядеть как https://your-domain.com/abc?clickid={external_id}—вставьте это как назначение в вашей кампании Blockchain-Ads).
5. Тестирование:
   
   • Запустите тестовую кампанию в Blockchain-Ads, указывающую на URL Keitaro.
   • Симулируйте клик и конверсию (например, через тестовое предложение).
   • Проверьте отчеты Keitaro (Reports > Conversions) на захваченные клики/конверсии.
   • Проверьте в отслеживании Blockchain-Ads, что постбэки приходят (с соответствующими ID кликов и доходом).
   • При необходимости используйте такие инструменты, как Postman, для ручного запуска тестового постбэка.

Советы и устранение неполадок

• Заполнители в Keitaro: Используйте {external_id} для clickid, {revenue} для сумм и {status} для типов событий (например, сопоставьте "lead" со статусом). Для незакодированных значений используйте префикс _ (например, {_external_id}).
• Доход/Валюта: Если конверсии в разных валютах, используйте {revenue:USD} для конвертации.
• Ошибки: Убедитесь, что используете HTTPS для постбэков. Если данные не поступают, проверьте кодировку URL, блокировки брандмауэра или несоответствующий ID трекера. Keitaro регистрирует попытки постбэков в Logs > Postbacks.
• Расширенные возможности: Для нескольких событий создайте отдельные события конверсии в Blockchain-Ads и добавьте несколько URL постбэков в Keitaro (один на статус).

Эта настройка обеспечивает точную атрибуцию без файлов cookie. Для получения дополнительной информации о Keitaro обратитесь к документации на docs.keitaro.io