Большая статья по s2s постбекам
Немного о принципе работы/Для чего нужны
Все исходящие данные из трекера вы можете отправлять только через s2s постбеки. Трекер получает конверсию из партнерки или вашего сайта, ее вы можете отправить в рекламную сеть или вашу CRM, а параметры которые вам нужно отправлять, выставляются в настройках этого постбека. Настройка передачи параметров происходит индивидуально и вы сами можете выбирать что передавать, а что нет.
Список параметров, которые можно передавать в s2s постбеке
Обязательным параметром для передачи является id клика источника. Точно так же как и в трекере - это необходимо источнику для инициализации всех данных связанных с кликом, которые записаны в базу данных. Без id клика источник просто не сможет распознать входящие данные и отобразить все что вам нужно.
Для этого в трекере в параметрах кампании есть поле external_id
Остальные параметры: ключевик, Валюта, ID креатива, ID кампании источника, Источник и sub_id_1-15 - это параметры, которые вы отправляете при возможности и необходимости
Настройка s2s постбеков для кампании
Здесь существует три варианта:
Шаблон источника трафика уже есть в разделе Источники в трекере
Шаблона источника трафика нет в разделе Источники в трекере
Отправляем S2S в стороннюю систему - например в любую CRM, здесь настройка будет не через источники трафика, а через вкладку S2S в кампании, куда вы разместите ссылку на вашу системы с нужными параметрами
Рассмотрим первый
Шаблон источника трафика уже есть в разделе Источники в трекере
В таком случае в уже созданной кампании в разделе Настройки нужно выбрать Источник
И все параметры, заданные в шаблоне будут автоматически добавлены в ссылку вашей кампании
Это нужно, чтобы трекер принял значения макросов источника, а также знал, по какой ссылке отправлять s2s постбек
В готовых шаблонах тех источников, которые принимают s2s постбеки ссылка уже собрана, протестирована и добавлена в сам шаблон.
Существуют такие источники, которые s2s не принимают, самый яркий пример - facebook.
У них свои методы оптимизации кампаний - а именно прием пикселя и обработка с его помощью данных по кампании.
Шаблона источника трафика нет в трекере
В таком случае Вам нужно будет его создать самостоятельно, либо же в каждой кампании прописывать параметры и ссылку для s2s вручную. Очевидно, что первый вариант удобнее.
Для того, чтобы создать шаблон - вам необходимо узнать список макросов которые они передают и прописать их в соответствующие параметры.
А также ссылку s2s постбека, на которую им нужно его отправлять
Ссылка s2s постбека
Обычно источники предоставляют ссылку со своими параметрами вот такого вида:
параметр1={replace}&параметр2={replace}&параметр3={replace}
Где параметр1, параметр2 и параметр3 и тд - это параметры, в которых они готовы принимать данные
А макросы - {replace} это любая информация, которую вы можете отправить из трекера
Разберем на конкретном примере:
Источник присылает в трекер стоимость клика в долларах, id своего клика, id креатива, id рекламной кампании и собственно данные о себе - source
Трекер записывает все это в вашу базу данных на сервере и при получении входящего постбека с которым пришли эти данные он отправляет s2s по ссылке, которая указана в шаблоне в следующих параметрах
token=REPLACE - это значение которое в этом источнике у каждого веба свое, это может быть например токен аккаунта или токен пользователя, его нужно заменить на актуальное
campaign_id={ad_campaign_id} - это id рекламной кампании источника
click_id={external_id} - это тот самый id клика, который трекер записал в свой параметр external_id взяв его из макроса [CLICK_ID] который прислал источник
И теперь в ссылке s2s мы отдаем его в источник в нужном им параметре
Им без разницы в каком макросе мы отдадим им их id клика, будь то click_id={external_id} либо же click_id={blablabla}, главное отдать им это в параметре click_id=
payout={conversion_revenue} - что чтобы передавать сумму конверсии, нужно использовать макрос {conversion_revenue}
Список всех доступных макросов есть у нас в документации
Как настроить отправку s2s постбеков на несколько адресов или в CRM систему?
Для этого вам нужно перейти на вкладку s2s постбеки и выбрать кнопку Добавить внешний постбек
Перед вами откроется меню настройки
URL - адрес, на который нужно отправлять постбек с необходимыми get параметрами
Метод отправки - нужно уточнять на принимающей стороне
Состояние - выбрать какой статус конверсии может инициировать отправку постбека
Отправка постбеков не работает
Всю информацию о статусе отправки и других данных можно получить в Логе отправленных постбеков: Обслуживание-Логи-Отправленные постбеки.
Мы постарались максимально детализировать его, вплоть до того, что добавили туда информацию о том, какой subid инициирует s2s отправку.
А по нему можно уже сориентироваться для получения любой информации по клику в трекере в любом разделе. Будь то логи или отчеты.
1) В первую очередь следует убедиться, что в вашей кампании подключен шаблон и в ссылке на которую идет трафик прописаны эти параметры
Важно!
В случае с любым методом интеграции (KClient PHP, KClient JS и тд) - нужно руками указывать в ссылке все эти параметры, т.к трафик идет на внешнюю ссылку, и только потом вызывается трекер, а параметры с этой вкладки автоматически добавляются к ссылке кампании, но не к ссылке сайта на который вы изначально льете трафик
2) Убедитесь, что источник действительно присылает в макросах эти данные, их реальные значения (например external_id=33313038333736325f38353038, а не не просто названия макросов без значений external_id=[CLICK_ID])
Отчеты-Клики-Нажать на Дата и время клика. Также можете смотреть это в Логе трафика в строке Requested.
3) Также есть кейс, когда в строке Requested в логе передаются параметры, а в Дата и время - записываются как макросы, чаще всего это из за того что в ссылке нет ? (вопросительного знака) после идентификатора, и трекер принимает это все как один параметр и ничего не записывает
4) Убедитесь, что в шаблоне источника включена отправка всех статусов событий
5) Убедитесь, что принимающая сторона отдает ответ 200 либо аналогичный, и что сервер источника в данный момент работоспособен
Если вы не нашли здесь ответа на свой вопрос или какие то моменты остались для вас непонятными - всегда можете написать нам в поддержку в чат на сайте keitaro.io либо в телеграм @keitarobot - мы подскажем и объясним.