Подключаем и настраиваем Postback
Обратите внимание: данный функционал работает только в паре с нашим сокращателем.
1) Включите в личном кабинете функцию POSTBACK. В данном разделе она получает два ключевых параметра:
• Auth key – это API-ключ для отправки в нашу систему POSTBACK-запросов.
• URL нашего обработчика POSTBACK-запросов – на этот адрес вы сможете отправлять события lead/sale.
Запросы можно отправлять методами GET и POST.
В настройках POSTBACK обязательные поля помечены звездочкой*. Это:
• ключ авторизации auth
• параметр key – по нему мы понимаем, к какой SMS привязывать совершённое пользователем действие
• параметр type – сюда передается либо lead, либо sale (одно СМС может быть как lead, так и sale одновременно)
Остальные поля можно отправлять по желанию для получения более детальных отчетов:
• payout – числовой параметр, который передаётся для подсчёта показателей прибыльности рекламной кампании.
В арбитраже трафика: payout – сумма выплаты от партнёрской рекламной сети за покупку услуги пользователем.
• currency – этот параметр ОБЯЗАТЕЛЬНО указывать, если передаётся параметр payout (они работают в паре), сюда передаётся тип валюты для конвертации прибыли и других финансовых метрик в валюту вашего личного кабинета.
• from_site и campaign – параметры, которые служат для объединения нескольких рассылок при группировке их в POSTBACK отчёте (например, если несколько рассылок было с ссылкой-ОФФЕРОМ-№1 и параметром campaign=comp1, а затем несколько рассылок было с ОФФЕРОМ-№2 и параметром campaign=comp2, тогда по значению «название кампании» в POSTBACK отчёте можно посмотреть метрики по всем рассылкам, сгруппированным по названиям кампаний «comp1» и «comp2». То же самое и с параметром from_site).
ВАЖНО соблюдать регистр и тип передаваемых параметров, как указано в настройках POSTBACK-функционала:
2) Настройте на своём сайте / в своей партнёрской рекламной сети отправку POSTBACK, указывая URL и все необходимые передаваемые параметры из раздела данной инструкции под номером (1).
2.1) Если вы сотрудничаете с партнёрской сетью, в которой невозможно принимать SMS-ID и отправлять его в POSTBACK, то используйте собственные Landing-page (страницы оффера), где можно самостоятельно настроить скрипты на определённые действия на странице оффера. Например, использовать технологию «ПИКСЕЛЯ» (как, например, это реализовано в запрещённой в РФ социальной сети «Meta»). Данный скрипт позволяет выдернуть из URL страницы «SMS-ID» и сгенерировать запрос, в котором будет указан наш URL POSTBACK-запроса с необходимыми параметрами, включая SMS-ID и lead/sale в зависимости от действий пользователя.
Postback URL вы можете взять в Личном кабинете в разделе Postback в поле «Запрос на отправку. метод POST/GET».
Примеры запросов указаны ниже в разделе 3.
3) Создайте рассылку, используя наш сокращатель.
К ссылке после всех параметров, указываемых после знака «?», добавьте переменную SMS-ID при помощи ключа «&».
После запуска рассылки на место параметра key=#smsId# подставляются уникальные числовые значения для каждой SMS, когда пользователь кликнет на сокращённую ссылку из SMS, его перенаправит на вашу ссылку, например с номером SMS-ID 14182710.
https://my-site.com/?очень_ много_ параметров_ клиента&key= 14182710
Именно этот SMS-ID вы должны будете указать в Postback-запросе в нашу систему.
Далее представлены примеры Postback-запросов для конкретной sms с SMS-ID 14182710 методами GET и POST:
Запрос методом GET:
https://admin. beta.p1sms.ru /api/postback? auth=j9b IUbBIU biUBiuboiI m&key=1418 2710 &type=lead
Запрос методом POST:
POST https://admin. beta.p1sms.ru/ api/postback
Content-Type: application/json
{
"auth": "j9bIUbBIUbiUBiuboiIm",
"key": "14182710",
"type": "lead"
}
4) После получения POSTBACK в нашу систему, информацию о конверсиях можно посмотреть в следующих разделах:
• Отчёт Postback: сводные данные по всем рекламным кампаниям Cost, Clicks, Leads, Sales, Profit, Revenue, ROI, CPC, CPL, CPS; доступны группировки.
Отчёт «Отправленные СМС»: с отметкой к каждому смс событий Clicks, Leads, Sales.
Отчёт «Информация о рассылке»: с отметкой к каждому смс событий Clicks, Leads, Sales.
Все перечисленные отчёты доступны для экспорта данных в CSV/Excel. Данные обновляются в реальном времени.