Отслеживание через Postback позволяет HilltopAds отправлять уведомления о событиях напрямую в вашу систему трекинга. Это помогает сопоставлять показы, клики и конверсии с вашими записями, а при соответствующей настройке – также получать данные о сумме дохода.
Что такое Postback для паблишеров и как использовать его в HilltopAds?
Postback – это запрос от сервера к серверу, который HilltopAds отправляет на ваш эндпоинт трекинга при возникновении события, соответствующего условиям отправки уведомлений.
В зависимости от настроек Postback может уведомлять вас о следующих событиях и данных:
Учтённый показ Popunder или учтённый клик по медийной рекламе.
Конверсия.
Сумма дохода от события, если вы добавили соответствующий плейсхолдер.
Если вы получили Postback о показе или клике, это означает, что событие было учтено. Данные о доходе отражают ваш заработок от показов по модели CPM или конверсий по модели CPA.
Примечание: Postback не передаёт данные о потерянных или отфильтрованных показах. Получаемые уведомления зависят от выбранных событий и доли отправляемых уведомлений, согласованной с вашим аккаунт-менеджером.
Как настроить отслеживание через Postback
Интеграцию настроит ваш аккаунт-менеджер HilltopAds. Перед началом подготовьте эндпоинт для приёма Postback и определите, какие события вы хотите отслеживать.
1. Отправьте URL Postback своему аккаунт-менеджеру
Передайте адрес эндпоинта, на который ваша система трекинга получает уведомления о событиях. Например:
https://website.com/postback?click_uuid={externalid}&payout={payout}&uid=uidВ этом примере:
click_uuid— параметр, через который ваша система трекинга получает идентификатор.{{clickId}}заменяется уникальным идентификатором, переданным через ссылку монетизации HilltopAds.{{payout}}заменяется суммой дохода, связанной с событием, о котором отправляется уведомление.uid— ID вашего аккаунта паблишера. Его можно найти в личном кабинете.
Ваш эндпоинт может использовать другие названия параметров. Отправьте аккаунт-менеджеру точный URL, необходимый вашей системе трекинга, чтобы он мог проверить соответствие параметров и значений.
Если эндпоинту нужны дополнительные значения, например ID пользователя, согласуйте с аккаунт-менеджером порядок их передачи до начала настройки.
2. Выберите события, о которых хотите получать уведомления
HilltopAds предлагает следующие варианты отправки уведомлений:
Показы или клики
Postback отправляется, когда учитывается показ Popunder или клик по медийной рекламе.
Такой Postback подтверждает, что событие было учтено.
Пример:
https://website.com/postback?click_uuid={{clickId}}Только конверсии
Postback отправляется при возникновении конверсии. Этот вариант полезен для паблишеров, работающих через прямую ссылку.
Пример:
https://website.com/postback?click_uuid={{clickId}}Все события, приносящие доход
Postback отправляются только для событий, которые приносят вам доход.
Например, если показ в CPA-кампании не принёс дохода, Postback для него не отправляется. Если позже произойдёт конверсия, которая принесёт доход, вы получите Postback для этого события.
Пример:
https://website.com/postback?click_uuid={{clickId}}&payout={{payout}}Примечание: Плейсхолдер {{payout}} можно использовать с любым вариантом отправки уведомлений. Вариант «Все события, приносящие доход» отправляет уведомления только о событиях, по которым начислен доход.
Все события
Postback отправляются как для учтённых показов или кликов, так и для конверсий.
Если показ или клик впоследствии приведёт к конверсии, вы получите два Postback с одинаковым clickId: один для показа или клика, второй — для конверсии.
Пример:
https://website.com/postback?click_uuid={{clickId}}Убедитесь, что ваша система трекинга может обрабатывать несколько уведомлений с одним и тем же идентификатором.
3. Согласуйте долю отправляемых уведомлений
Уточните у аккаунт-менеджера, какой процент событий, соответствующих условиям отправки, должен передаваться на ваш эндпоинт.
Можно настроить отправку уведомлений для определённой доли событий, например 10% или 100%. Обычно по умолчанию используется 10%, чтобы снизить нагрузку на систему.
Выбор событий и доля отправляемых уведомлений – независимые настройки. Выбор варианта «Все события» не означает, что вы получите 100% уведомлений. Если включена выборочная отправка, ваша система трекинга получит только согласованную долю.
Учитывайте этот процент при сравнении записей Postback со статистикой HilltopAds.
4. Добавьте параметры трекинга в ссылку монетизации
После настройки Postback аккаунт-менеджер предоставит вам ссылку монетизации HilltopAds и объяснит, какие значения для трекинга нужно использовать.
https://dengd.com/bC3aV/0.Pf3hp/vpb/m_VLJiZtD/0/3/N/T/QvwrNmTMQ/5kLbTvcJ1WNYDFAx1/NdT-Mf?clickId=PARAM_NAME&sId=PARAM_NAME
Параметры трекинга включают:
clickId— ваш уникальный ID показа или клика, используемый для сопоставления уведомлений Postback с записями в вашей системе трекинга.sId— ID рекламной зоны.
Следуя инструкциям аккаунт-менеджера, замените примеры значений или плейсхолдеры в ссылке монетизации на корректные значения либо динамические макросы вашей системы.
Ссылка монетизации и URL Postback выполняют разные функции:
Ссылка монетизации направляет трафик в HilltopAds.
URL Postback принимает уведомления о событиях от HilltopAds.
Всегда используйте ссылку монетизации, предоставленную аккаунт-менеджером. Не используйте эндпоинт Postback в качестве адреса для направления трафика.
5. Проверьте интеграцию
Протестируйте настройки вместе с аккаунт-менеджером, прежде чем применять их ко всему трафику. Убедитесь, что:
Ваш эндпоинт получает уведомления о выбранных событиях.
Полученные идентификаторы совпадают с записями в вашей системе трекинга.
Суммы дохода передаются, если эта функция настроена.
При использовании варианта «Все события» ваша система трекинга может обрабатывать несколько уведомлений с одинаковым
clickId.Доля отправляемых уведомлений соответствует согласованным настройкам.
Если вам нужна помощь с настройкой Postback для паблишера или устранением неполадок, обратитесь к своему аккаунт-менеджеру HilltopAds.