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.

На цій сторінці