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

Межсерверные события (S2S)

Используйте API межсерверных событий (S2S) для отправки данных о событиях в Adjust с помощью запросов HTTP. Используйте Adjust SDK для регистрации установок, сессий и реатрибуций и отправляйте пользовательские события только с помощью API S2S.

Если вы настраиваете события S2S для приложений iOS 14 и выше, Adjust отправляет значение конверсии на ваш сервер в виде ответа S2S. Затем ваш сервер должен обновить значения конверсии в приложении. Для получения дополнительной информации о том, как это работает, см. раздел Поддержка событий S2S для iOS 14 и выше.

Примечание:

В целях атрибуции Adjust не делает различия между кликами, отправленными из SDK, и кликами S2S. В каскаде атрибуции они считаются одними и теми же.

Из этой статьи вы узнаете, как настроить отслеживание S2S-событий и как устранять неполадки, связанные с записью.

Конечная точка

API S2S-событий использует следующую конечную точку:

https://s2s.adjust.com/event

Отправка S2S-событий

Конечная точка /event принимает следующие запросы на S2S-события:

  • GET c URL-параметрами.
  • POST c URL-параметрами.
  • POST с параметрами в теле. Для Content-Type должно быть установлено значение application/x-www-form-urlencoded.

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

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

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

Обязательные параметры

Важно:

Параметры для S2S-событий чувствительны к регистру.

Для конечной точки /event в каждом запросе требуются следующие параметры:

  1. Рекламный идентификатор, например idfa для iOS или gps_adid для Android.
  2. Токен события.
  3. Токен приложения.
  4. Статически закодированный параметр s2s=1 сообщает конечной точке о том, что запросы передаются от сервера к серверу.
параметрОписаниеПример
Рекламный идентификатор, например idfa (iOS) или gps_adid (Android)См. полный список идентификаторов устройств.idfa=D2CADB5F-410F-4963-AC0C-2A78534BDF1E

gps_adid=660e1d86-6796-463a-be86-897993136018
event_tokenТокен события Adjust с панели управленияevent_token=f0ob4r
app_tokenТокен приложения Adjust с панели управленияapp_token=4w565xzmb54d
s2sПараметр s2s со значением 1s2s=1

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

Для точной атрибуции событий включите приведенные здесь параметры в события.

Важно:

Для устройств под управлением iOS следует использовать рекламный идентификатор adid. Таким образом вы можете сопоставить данные устройства, когда IDFA недоступен.

параметрОписаниеПример
adidИдентификатор Adjust, связанный с устройством. Применяется для определения пользователей LAT на iOS без информации об IDFA.adid=18546f6171f67e29d1cb983322ad1329
ip_addressIP-адрес устройства. Используется для привязки событий к третьим сторонам (например, Google) и включения в колбэки информации о местоположении (например, city ,postal_code).

Параметр ip_address принимает только адреса IPv4. В настоящее время протокол IPv6 не поддерживается.
ip_address=192.0.0.1
created_at_unix(рекомендуется)

or

created_at
Дата и время наступления события.created_at_unix=1484085154

или

created_at=2017-01-02T15:04:05.000+0000
user_agent Идентификационная строка клиентского приложенияна устройстве. Должна быть закодирована в URL.user_agent=Mozilla%2F5.0%20%28iPhone%3B%20CPU%20iPhone%20OS%2016_6%20like%20Mac%20OS%20X%29%20AppleWebKit%2F605.1.15%20%28KHTML%2C%20like%20Gecko%29%20Version%2F16.5%20Mobile%2F15E148%20Safari%2F604.1

Временная отметка события

Временная отметка события может быть задана с помощью параметров created_at_unix или created_at.

  • created_at_unix: временная отметка UNIX, в которую было отправлено событие. Например: 1484085154.
  • created_at: закодированная в URL временная отметка в формате ISO 8601. Например: 2023-01-02T15%3A04%3A05.000%2B0000.
Важно:

Если в запросе не передается временная отметка, то в качестве даты события Adjust использует время его получения.

Обязательно проверьте следующие параметры:

  • События должны быть представлены в хронологическом порядке для каждого устройства и токена события в соответствии с временной отметкой в запросе. Если Adjust получает событие с более ранней временной отметкой, чем та, которая была получена ранее для указанного устройства и события, то это событие отклоняется.
  • Все события должны быть отправлены в течение 58 дней. События с временной отметкой, превышающей 58 дней, отклоняются.

Передача настраиваемых данных

Используйте колбэк и параметры партнера для отправки данных настраиваемых событий в Adjust. Параметры колбэка доступны при экспорте сырых данных, а параметры партнеров передаются партнерам по сети.

Используйте следующие параметры, чтобы добавить параметры к своим запросам:

  • callback_params: закодированный в URL-адрес объект JSON, содержащий строковые пары «ключ-значение».
  • partner_params: закодированный в URL-адрес объект JSON, содержащий строковые пары «ключ-значение».
Важно:

Не вставляйте объекты в настраиваемые объекты данных.

Пример без кодировки
Пример с кодировкой
{
   "f0o": "bar",
   "bar": "baz"
}

Чтобы получать параметры колбэка при экспорте сырых данных, добавьте данные в параметр callback_params межсерверного вызова.

curl --location https://s2s.adjust.com/event?s2s=1&event_token=f0ob4r&app_token=4w565xzmb54d&idfa=8A3CB124-5A79-4334-8802-F75FEC099C58&callback_params=%7B%22f0o%22%3A%22bar%22%2C%20%22bar%22%3A%22baz%22%7D

Чтобы отправлять информацию о событиях партнерам по сети, добавьте данные в параметр partner_params межсерверного вызова.

curl --location https://s2s.adjust.com/event?s2s=1&event_token=f0ob4r&app_token=4w565xzmb54d&idfa=8A3CB124-5A79-4334-8802-F75FEC099C58&partner_params=%7B%22f0o%22%3A%22bar%22%2C%20%22bar%22%3A%22baz%22%7D

Запись приносящих доход событий

Чтобы записать приносящие доход S2S-события, добавьте следующие параметры дохода в отправляемое событие:

параметрОписание
revenue

Значение приносящего доход события в полных денежных единицах
(149,99 = $149,99). Минимальное
значение этого параметра для серверов Adjust составляет 0.001.

currency Код валюты , связанный с событием.
environmentСреда для размещения данных (environment=sandbox или environment=production).
По умолчанию устанавливается значение production.

Образец запроса

GET c URL-параметрами;
POST c URL-параметрами
POST с параметрами в теле
curl --location 'https://s2s.adjust.com/event?s2s=1&event_token=f0ob4r&app_token=4w565xzmb54d&idfa=D2CADB5F-410F-4963-AC0C-2A78534BDF1E&created_at=2017-01-02T15%3A04%3A05Z%2B0200&callback_params=%7B%22f0o%22%3A%22bar%22%2C%20%22bar%22%3A%22baz%22%7D&partner_params=%7B%22f0o%22%3A%22bar%22%2C%20%22bar%22%3A%22baz%22%7D&currency=EUR&revenue=123.4&environment=sandbox'