Интеграция 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. |