darkcore docs
PWAИнтеграции

Интеграция Keitaro: как создать источник трафика для darkcore

Создайте в Keitaro источник darkcore, передайте click_id в Campaign URL и верните конверсию для нужного click_id.

В Keitaro создаём Traffic Source darkcore.

Сделайте это по порядку

1. Создайте Traffic Source darkcore в Keitaro

  1. В Keitaro откройте Источник трафика → Создать.
  2. Не выбирайте шаблон Facebook, TikTok или другой рекламной сети. Создайте кастомный источник с названием darkcore.
  3. В блоке Parameters заполните не только External ID. Добавьте полную связку с darkcore:
Название в KeitaroПараметрPlaceholder
External IDexternal_id{click_id}
Sub Id 1sub1{sub1}
Sub Id 2sub2{sub2}
Sub Id 3sub3{sub3}
Sub Id 4sub4{sub4}
Sub Id 5sub5{sub5}
Sub Id 6sub6{sub6}

Если используете больше сабов, заполните sub7–sub10 по тому же принципу. darkcore поддерживает все десять.

  1. В поле S2S postback вставьте URL приёма постбеков darkcore:
https://edge.darkcorepwa.com/p?click_id={external_id}&status={status}&payout={revenue}&transaction_id={tid}
  1. В «Только со статусами» выберите статусы, которые должен принимать darkcore, обычно lead и sale. Если в вашем воркспейсе другие типы конверсий, сначала добавьте для них соответствующие алиасы.
  2. Сохраните Source.

2. Создайте Campaign в Keitaro

  1. Откройте Campaigns → Create.
  2. В поле Source выберите созданный darkcore.
  3. Добавьте в Campaign ваши партнёрские офферы и правила распределения.
  4. Сохраните Campaign и скопируйте её Campaign URL.

В скопированном URL должны быть все параметры из Source:

https://YOUR_KEITARO_DOMAIN/YOUR_CAMPAIGN?external_id={click_id}&sub1={sub1}&sub2={sub2}&sub3={sub3}&sub4={sub4}&sub5={sub5}&sub6={sub6}

Если нет external_id или нужного sub, вернитесь в Traffic Source и нажмите Обновить параметры в привязанных кампаниях. Без external_id Keitaro не сможет вернуть конверсию, без sub в Keitaro пропадёт контекст трафика.

3. Добавьте Keitaro Campaign как оффер в Stream darkcore

В Stream → Трекинг-ссылка создайте ссылку, которая ведёт на Campaign URL из шага 2. Оставьте {click_id} в URL как макрос darkcore:

https://YOUR_KEITARO_DOMAIN/YOUR_CAMPAIGN?external_id={click_id}&sub1={sub1}&sub2={sub2}&sub3={sub3}&sub4={sub4}&sub5={sub5}&sub6={sub6}

Теперь правило Stream ведёт трафик на PWA или Direct Link, а его трекинг-ссылка переводит трафик в Keitaro.

Один дефолтный оффер для всех Campaign Keitaro

Создайте один универсальный оффер и передавайте ID Campaign в sub1.

  1. В Офферы → Создать добавьте оффер, например Keitaro universal.
  2. В URL вставьте домен Keitaro и макросы darkcore:
https://YOUR_KEITARO_DOMAIN/{sub1}?external_id={click_id}&sub1={sub1}&sub2={sub2}&sub3={sub3}&sub4={sub4}&sub5={sub5}&sub6={sub6}
  1. В Stream → Распределение трафика → Трекинг-ссылка создайте трекинг-ссылку без фильтров, выберите этот оффер и поставьте его последним. Это будет дефолтный оффер для всего трафика, который не перехватили предыдущие правила.
  2. При заливе указывайте в ссылке Stream только ID или alias нужной Campaign Keitaro в sub1:
https://YOUR_STREAM_DOMAIN/?sub1=123

В этом примере darkcore отправит трафик на https://YOUR_KEITARO_DOMAIN/123.

Универсальный оффер резервирует sub1 под ID или alias Campaign Keitaro. Не передавайте туда ID ad set, креатива или другое значение. Для них используйте sub2–sub10.

Перед сохранением откройте реальный Campaign URL в Keitaro и проверьте его форму. Заменяйте на {sub1} только часть URL, в которой действительно стоит ID или alias Campaign. Не вставляйте в sub1 полный URL.

Сделайте один тестовый клик

  1. Откройте именно тот URL Stream, который пойдёт в рекламу, например https://YOUR_STREAM_DOMAIN/?sub1=123.
  2. После PWA или Direct Link браузер должен открыть https://keitaro.example/123, а в URL не должно остаться {click_id} или {sub1} в фигурных скобках.
  3. В Keitaro → Logs → Clicks откройте этот клик и сверьте:
    • External ID равен click_id этого клика в darkcore;
    • Sub Id 1 равен 123;
    • другие Sub Id содержат значения, переданные в Stream.
  4. Отправьте тестовую конверсию в Keitaro. В darkcore должна появиться конверсия для того же click_id.

Что исправить по результату теста

Что видноЧто сделать
Открывается 404 Keitaro или другая ошибка, а не нужная CampaignВ URL Stream нет sub1=ID_КАМПАНИИ или ID в sub1 не совпадает с Campaign URL Keitaro.
В Keitaro нет кликаУбедитесь, что дефолтный оффер выбран в трекинг-ссылке Stream, а эту трекинг-ссылку не перекрывает правило выше.
External ID пустойВ Source должно быть external_id = {click_id}. После изменения нажмите Обновить параметры в привязанных кампаниях.
Sub Id 1 пустойВ Source должно быть sub1 = {sub1}, а в URL Stream — ?sub1=ID_КАМПАНИИ.
Есть конверсия в Keitaro, но нет в darkcoreВ Source проверьте S2S URL: он должен содержать click_id={external_id}.
darkcore отклоняет конверсиюВ Только со статусами Source оставьте статусы с алиасами darkcore, например lead и sale.

На этой странице