Мы постоянно публикуем обновления документации, которые могут быть недоступны на вашем языке. Наиболее актуальные сведения содержатся в версии на английском языке.

Межсерверная передача данных о доходе от рекламы

Если вы отслеживаете доход от рекламы самостоятельно, то можете предоставить доступ к этим данным другим серверам (S2S), чтобы просматривать их вместе с остальными показателями, которые отслеживает Adjust. Это дает полное представление об эффективности кампании, а также позволяет рассчитывать показатель пожизненной ценности пользователей и оптимизировать показатели ROAS и ROI кампании.

Выполняйте межсерверную отправку данных о доходе от рекламы в Adjust, чтобы просматривать их в разделах «Статистика» и «Когорты» на панели управления.

Начало работы

Что нужно знать, чтобы начать работу.

Доступность

  • Пакет «Доход от рекламы»

Полезная информация

  • Доход от рекламы, данные о котором передаются между серверами, добавляется к KPI дохода от рекламы и формулам когорты для показателя пожизненной ценности и ROAS.

Межсерверная отправка данных о доходе от рекламы

Мы принимаем следующие типы запросов на межсерверную отправку данных о доходе от рекламы:

  • GET c URL-параметрами;
  • POST с URL-параметрами (без тела);
  • POST с параметрами тела как Content-Type application/x-www-form-urlencoded.

Когда нужно отправлять в Adjust сведения о доходе от рекламы, данные о котором передаются между серверами?

FAQ

Настройка межсерверной (S2S) безопасности

Функция межсерверной (S2S) безопасности позволяет гарантировать безопасность дохода от межсерверной рекламы и обеспечивает защиту от поддельных запросов. Для этого необходимо, чтобы каждый входящий запрос содержал токен, созданный на панели управления Adjust. Запросы, не содержащие действительного токена или содержащие недействительный токен, отклоняются нашим сервером. Чтобы выполнить настройку, следуйте инструкциям в статье, посвященной межсерверной безопасности.

Примечание:
Перед активацией межсерверной аутентификации на панели управления всегда проверяйте внедрение токена проверки подлинности в запросы на передачу данных о доходе от рекламы.

Требуемые параметры

Для отправки в Adjust данных о доходе от рекламы всегда передавайте следующие параметры по адресу https://s2s.adjust.com/ad_revenue:

параметрОписаниеПример
idfa; gps_adid; и т. д. Идентификатор устройства, зависящий от платформы (см. полный список).idfa=D2CADB5F-410F-4963-AC0C-2A78534BDF1E

gps_adid=660e1d86-6796-463a-be86-897993136018
app_tokenТокен приложения Adjust с панели управления.app_token=4w565xzmb54d
s2sПараметр S2S, которому задано значение 1.1
revenueили amountСумма дохода от рекламы, заработанная устройством.4.99
ВалютаВалюта, в которой представлен доход.

Если запрос события содержит параметр {revenue} или {amount} с прибавленным значением, важно включить {currency}. Если этот параметр отсутствует, наша внутренняя служба отклоняет запрос.
USD
ad_impressions_countКоличество показов, с которыми связан доход (целое число > 0).100
ИсточникВсегда издатель.Издатель
Рекомендованы, но не являются обязательными
adidИдентификатор устройства Adjust (все платформы)18546f6171f67e29d1cb983322ad1329
created_at_unix
(рекомендуется)

или

created_at
Сообщает точное время просмотра рекламы пользователю (не должно быть позже 28 дней).created_at_unix=1484085154

or

created_at=2017-01-02T15:04:05.000+0000
environmentТекущая настройка среды SDK. productionили sandbox

Рекомендуемые дополнительные параметры для колбэков

Параметр
Описание
Пример
callback_paramsИспользуется для передачи параметров колбэка в качестве JSON-объекта (должным образом экранированного; из строки в строку) callback_params=%7B%22f0o%22%3A%22bar%22%2C%20%22bar%22%3A%22baz%22%7D
ad_revenue_network
Дополнительные данные о доходе от рекламы 
ad_revenue_network=Admob
ad_revenue_unit
Дополнительные данные о доходе от рекламы 
ad_revenue_unit=rewarded_video
ad_revenue_placement
Дополнительные данные о доходе от рекламы 
ad_revenue_placement=home_screen

Пример запроса POST, к которому добавлен токен:

curl -X POST -H "Authorization: Bearer b9eb9d6228842aeb05d64f30d56b361e" "https://s2s.adjust.com/ad_revenue?app_token=abc123abc123&idfa=FAD135C7-C5F8-4DCC-9478-2203956B0870&source=publisher&ad_impressions_count=1&revenue=0.01&currency=USD&s2s=1"

Пример успешного ответа:

{"status":"OK"}

Пример ошибочного ответа:

{"error":"Ad revenue request failed (wrong authentication token) (app_token:abc123abc123)"}