Keitaro інтеграція: Як створити Джерело Трафіку для darkcore
Створіть у Keitaro джерело darkcore, передайте click_id у Campaign URL і поверніть конверсію для потрібного click_id.
У Keitaro створюємо Traffic Source darkcore.
Зробіть це по черзі
1. Створіть Traffic Source darkcore у Keitaro
- У Keitaro відкрийте Джерело трафіку → Створити.
- Не обирайте шаблон Facebook, TikTok чи іншої рекламної мережі. Створіть кастомне джерело з назвою
darkcore. - У блоці Parameters заповніть не лише External ID. Внесіть повну зв'язку з darkcore:
| Назва в Keitaro | Параметр | Placeholder |
|---|---|---|
| External ID | external_id | {click_id} |
| Sub Id 1 | sub1 | {sub1} |
| Sub Id 2 | sub2 | {sub2} |
| Sub Id 3 | sub3 | {sub3} |
| Sub Id 4 | sub4 | {sub4} |
| Sub Id 5 | sub5 | {sub5} |
| Sub Id 6 | sub6 | {sub6} |
Якщо ви використовуєте більше сабів, заповніть sub7–sub10 за тим самим принципом. darkcore підтримує всі десять.
- У полі S2S postback вставте URL прийому постбеків darkcore:
https://edge.darkcorepwa.com/p?click_id={external_id}&status={status}&payout={revenue}&transaction_id={tid}- У "Лише зі статусами" оберіть статуси, які має приймати darkcore, зазвичай
leadіsale. Якщо у вашому воркспейсі інші типи конверсій, спочатку додайте для них відповідні аліаси. - Збережіть Source.
2. Створіть Campaign у Keitaro
- Відкрийте Campaigns → Create.
- У полі Source оберіть створений
darkcore. - Додайте в Campaign ваші партнерські офери та правила розподілу.
- Збережіть 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.
- У Офери → Створити додайте офер, наприклад
Keitaro universal. - У URL вставте домен Keitaro та макроси darkcore:
https://YOUR_KEITARO_DOMAIN/{sub1}?external_id={click_id}&sub1={sub1}&sub2={sub2}&sub3={sub3}&sub4={sub4}&sub5={sub5}&sub6={sub6}- У Stream → Розподіл трафіку → Трекінг-посилання створіть трек-посилання без фільтрів, оберіть цей офер і поставте його останнім. Це буде дефолтний офер для всього трафіку, який не перехопили попередні правила.
- Під час заливу вказуйте у посиланні 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.
Зробіть один тестовий клік
- Відкрийте саме той URL Stream, який піде в рекламу, наприклад
https://YOUR_STREAM_DOMAIN/?sub1=123. - Після PWA або Direct Link браузер має відкрити
https://keitaro.example/123, а в URL уже не повинно лишитися{click_id}або{sub1}у фігурних дужках. - У Keitaro → Logs → Clicks відкрийте цей клік і звірте:
- External ID дорівнює
click_idцього кліку в darkcore; - Sub Id 1 дорівнює
123; - інші Sub Id містять значення, які ви передали у Stream.
- External ID дорівнює
- Відправте тестову конверсію в 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. |