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

Повторное включение/отключение совместного доступа третьих сторон посредством S2S

With Adjust, you can manage how data is shared with third parties for statistics purposes. This gives your users greater choice over how their data is handled. Here, you can find instructions on how to re-enable and disable third-party sharing server-to-server (S2S).

Примечание:
Any user that opts-out of sharing user data will not be re-targeted again, even if they opt-in at a later point. This means they are not included in Audiences lists.
Минимально необходимая версия SDKДокументация разработчика
Android SDK 4.26.0+Android — возобновить передачу данных
iOS SDK 4.25.0+iOS — возобновить передачу данных

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

API адреса запроса конечной точки выглядит так:

https://s2s.adjust.com/third_party_sharing

Для взаимодействия с API используйте запрос POST. Вы также можете отправить параметры конечной в URL или как данные формы.

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

Название параметраЗначение
gps_adid, idfaСтрока ID устройства. Необходимо хотя бы одно устройство. API поддерживает те же ID устройств, что и другие Adjust S2S API.
s2sВсегда 1.
app_tokenТокен приложения.
sharing enable (включить) или disable (отключить) передачу данных третьим лицам соответственно.

Ответы

Правильный ответ

В случае успешного ответа вы получите следующее:

{
   “status”: "OK"
}

Ответ с ошибкой

В случае ошибки вы увидите код ошибки 400 Bad Request , а также сообщение с описанием ошибки.

Пример:

{
   "error": "Third party sharing failed (App not found)”
}

Примеры URL-адресов

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

https://s2s.adjust.com/third_party_sharing?s2s=1&sharing=enable&app_token=abc123abc123&gps_adid=10820328-872d-43a2-9786-0ccc748335d9

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

https://s2s.adjust.com/third_party_sharing?s2s=1&sharing=disable&app_token=abc123abc123&gps_adid=10820328-872d-43a2-9786-0ccc748335d9

Provide consent data to Google (Digital Markets Act compliance)

To comply with the EU's Digital Markets Act (DMA), Google Ads and the Google Marketing Platform require explicit consent to receive Adjust’s attribution requests to their APIs.

In the event a user changes their consent response, you can use Adjust's re-enable/disable third party sharing API to share this with us. Pass the following parameters in your request:

KeyValueDescription
eea1 = users are in the EEA and the DMA applies

0 = users are not in the EEA and the DMA does not apply
The eea parameter informs Google whether users are located in the EEA and thus whether the European regulations, including the DMA, apply to this user and conversion. The parameter type is boolean.
ad_personalization1 = user consented

0 = user did not consent
  • For Google Ads

The ad_personalization parameter informs whether users consented to being served personalized ads via Google Ads after installing the app, i.e. whether Google can retarget the users.
ad_user_data1 = user consented

0 = user did not consent
The ad_user_data parameter informs Google whether users granted consent to personal data being shared for measurement purposes or not. The consent applies to all the Core Platform Services (CPS) advertisers have specified in their Google Ads and Google Marketing Platform UI.
npa1 = user did not consent

0 = user consented
  • For Google Marketing Platform

The npa parameter informs whether users consented to being served personalized ads via Google Marketing Platform after installing the app, i.e. whether Google can retarget the users.

Note that you need to send the ad_personalization parameter if you are working with Google Ads, and the npa parameter if you are working with Google Marketing Platform.