Bài viết liên tục được cập nhật, và những phần được cập nhật rất có thể chưa được dịch sang ngôn ngữ của bạn. Để xem thông tin mới nhất, vui lòng chọn ngôn ngữ Tiếng Anh.

Bật lại/tắt tính năng chia sẻ dữ liệu với bên thứ ba qua 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).

Lưu ý:
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.
Phiên bản SDK có hỗ trợTài liệu dành cho nhà phát triển (developer)
Android SDK 4.26.0+Android - re-enable sharing
iOS SDK 4.25.0+iOS - re-enable sharing

Endpoint

Địa chỉ yêu cầu của API endpoint:

https://s2s.adjust.com/third_party_sharing

Sử dụng POST để gửi yêu cầu đến API. Bạn cũng có thể gửi tham số endpoint trong URL hoặc dưới dạng dữ liệu biểu mẫu (form data).

Tham số bắt buộc

Tên tham sốGiá trị
gps_adid, idfaChuỗi Device ID. Ít nhất phải có một device ID. API cũng hỗ trợ các device ID mà các Adjust S2S API khác hỗ trợ.
s2sLuôn bằng 1
app_tokenApp token.
sharing enable hoặc disable để cho phép hoặc từ chối chia sẻ thông tin cho bên thứ ba.

Phản hồi (response)

Phản hồi thành công

Dưới đây là một phản hồi thành công:

{
   “status”: "OK"
}

Phản hồi lỗi

Trong trường hợp có lỗi xảy ra, bạn sẽ nhận phản hồi 400 Bad Request cùng một thông báo miêu tả lỗi.

Ví dụ:

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

Ví dụ (URL)

Bổ sung tham số enable để bật tính năng chia sẻ dữ liệu cho bên thứ ba, ví dụ:

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

Bổ sung tham số disable để tắt tính năng chia sẻ dữ liệu cho bên thứ ba, ví dụ:

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.