S2S를 통한 서드파티 공유 재활성화/비활성화

Adjust를 사용하면 통계 목적으로 서드파티와 데이터가 공유되는 방식을 직접 관리하여 데이터 처리 방식을 선호에 맞게 조정할 수 있습니다. 본문을 통해 서드파티 서버 간 공유(S2S)를 재활성화 및 비활성화하는 방법을 확인하시기 바랍니다.

참고:
사용자 데이터 공유를 옵트아웃한 사용자는 이후에 옵트인하더라도 다시 리타겟팅되지 않습니다. 즉, 오디언스 목록에는 포함되지 않습니다.
최소 SDK 버전개발자 문서
Android SDK 4.26.0+Android - 공유 재활성화
iOS SDK 4.25.0+iOS - 공유 재활성화

엔드포인트

API 엔드포인트 요청 주소는 다음과 같습니다.

https://s2s.adjust.com/third_party_sharing

POST 요청을 사용하여 API와 상호 작용합니다. 엔드포인트 파라미터를 URL 또는 양식 데이터로 전송할 수도 있습니다.

필수 파라미터

파라미터 이름
gps_adid, idfa기기 ID 문자열. 최소 1개의 기기 ID가 필요합니다. API는 기타 Adjust S2S API에서 지원되는 동일한 기기 ID를 지원합니다.
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

Google에 동의 데이터 제공(디지털 시장법 준수)

EU의 디지털 시장법(DMA)에 따라 Google Ads와 Google Marketing Platform은 API에 대한 Adjust의 어트리뷰션 요청을 수신하기 위해 명시적인 동의를 받아야 합니다.

사용자가 동의 응답을 변경한 경우, Adjust의 서드파티 공유 재활성화/비활성화 API를 사용하여 이를 Adjust와 공유할 수 있습니다. 요청에서 다음 파라미터를 전달합니다.

Key설명
EEA1 = 사용자가 유럽경제지역 사용자이며, 디지털마케팅법이 적용됨

0 = 사용자가 유럽경제지역 사용자가 아니며, 디지털마케팅법이 적용되지 않음
EEA 파라미터를 통해 Google은 사용자가 유럽경제지역 거주자인지 확인하여, 디지털마케팅법을 포함한 EU 규정이 해당 사용자와 전환에 적용되는지 확인합니다. 본 파라미터 유형은 boolean입니다.
ad_personalization1 = 사용자가 동의함

0 = 사용자가 동의하지 않음
  • Google Ads에 해당

ad_personalization 파라미터는 사용자가 앱 설치 이후 Google Ads를 통한 개인화된 광고 제공에 동의했는지(예: Google이 사용자를 리타겟팅할 수 있는지 여부)를 알려줍니다.
ad_user_data1 = 사용자가 동의함

0 = 사용자가 동의하지 않음
ad_user_data 파라미터는 사용자가 측정 목적의 개인 정보 공유에 동의했는지 알려줍니다. 해당 동의 정보는 광고주들이 Google Ads와 Google Marketing Platform UI에서 명시한 모든 Core Platform Services (CPS)에 적용됩니다.
npa1 = 사용자가 동의하지 않음

0 = 사용자가 동의함
  • Google Marketing Platform에 해당

npa 파라미터는 사용자가 앱 설치 이후 Google Marketing Platform을 통한 개인화된 광고 제공에 동의했는지(예: Google이 사용자를 리타겟팅할 수 있는지 여부)를 알려줍니다.

Google Ads를 사용하는 경우 ad_personalization 파라미터를 전송하고, Google Marketing Platform을 사용하는 경우 npa 파라미터를 전송해야 합니다.