서버 간 서드파티 공유

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

엔드포인트

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

https://s2s.adjust.com/third_party_sharing

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

필수 파라미터

글로벌 설정

all 파라미터는 파트너 공유 설정을 간소화할 수 있는 유연한 단축키입니다.

• all 파트너 이름 은 설정이 모든 파트너에게 적용됨을 의미합니다.
• all 활동 이름 (예: 설치 또는 세션)은 설정이 모든 활동 유형에 적용됨을 의미합니다.
• 이 두 가지를 결합하여 모든 파트너에 대한 모든 활동 을 적용하거나 제한할 수 있습니다.

이를 사용하여 광범위한 공유를 신속하게 비활성화(또는 허용)한 다음, 특정 파트너 또는 활동 유형에 대해 공유를 선택적으로 다시 활성화할 수 있습니다.

파트너 공유 설정 업데이트

개별 파트너에 대한 서드파티 공유 설정을 업데이트하려면 업데이트된 설정을 partner_sharing_settings 파라미터로 전달해야 합니다. 서드파티 공유 설정은 URL 인코딩된 양식 객체로 전달되어야 합니다. 여러 객체를 전달하여 한 번에 여러 설정을 변경할 수 있습니다.

각 파트너 공유 설정 양식에서 다음의 키를 반드시 전달해야 합니다.

key를 사용하여 비활성화 또는 재활성화하고자 하는 지표를 지정할 수 있습니다. 모든 지표 공유를 활성화/비활성화하려면 all 키를 사용할 수 있습니다. 이용 가능한 지표의 전체 목록은 다음과 같습니다.

• ad_revenue
• all
• update
• att_update
• event
• 설치
• 리어트리뷰션
• reattribution_reinstalls
• reinstall
• rejected_install
• rejected_reattributions
• sdk_click
• sdk_info
• 세션
• subscription
• uninstall

지표 그룹

특정 파트너에 대해 특정 지표에 false 값을 설정하면 Adjust는 해당 그룹의 모든 하위 지표와 함께 해당 파트너와의 지표 공유를 중단합니다. 중첩된 그룹은 다음과 같습니다.

• 세션

  • 설치

    • rejected_install

  • reinstall

  • 리어트리뷰션

  • rejected_reattributions

  • reattribution_reinstalls

방법은 다음과 같습니다.

• session 공유를 비활성화하면 모든 하위 지표도 비활성화됩니다.
• session 공유는 비활성화하고 reattribution은 활성화하면 reattribution을 제외한 모든 하위 지표가 비활성화됩니다.
• session 공유는 비활성화하고 install은 활성화하면 install을 제외한 session의 모든 하위 지표가 비활성화됩니다. install의 하위 지표는 활성화된 상태로 유지됩니다.
• session 공유는 활성화하고 install은 비활성화하면 install을 제외한 session의 모든 하위 지표가 활성화됩니다. install의 하위 지표는 비활성화된 상태로 유지됩니다.

사용 사례

다음은 몇 가지 일반적인 사용 사례입니다. 본 예시는 Android SDK와 S2S용 curl을 사용합니다. iOS 구현은 플랫폼에 특화된 신택스와 동일한 로직을 따릅니다.

파트너 A를 제외한 모든 파트너 활동 공유 비활성화

Adjust는 파트너 A와만 모든 데이터를 공유합니다.

curl -G \
--data-urlencode 's2s=1' \
--data-urlencode 'app_token=36wbd8gmlvsw' \
--data-urlencode 'idfa=105C1794-7CF8-43A3-9C3F-B0DCEA2D29A9' \
--data-urlencode 'partner_sharing_settings={"all":{"all":false},"PartnerA":{"all":true}}' \
https://s2s.adjust.com/third_party_sharing

세션 활동을 제외한 모든 공유 비활성화

Adjust는 세션 및 관련 이벤트(설치 또는 리어트리뷰션 등)를 제외한 모든 파트너 데이터 공유를 중단합니다.

curl -G \
--data-urlencode 's2s=1' \
--data-urlencode 'app_token=36wbd8gmlvsw' \
--data-urlencode 'idfa=105C1794-7CF8-43A3-9C3F-B0DCEA2D29A9' \
--data-urlencode 'partner_sharing_settings={"all":{"all":false,"session":true}}' \
https://s2s.adjust.com/third_party_sharing

파트너 A에 대한 세션 활동만 허용

파트너 A에 대한 세션 및 관련 이벤트(설치 또는 리어트리뷰션 등)를 제외한 모든 파트너 데이터 공유가 비활성화됩니다.

curl -G \
--data-urlencode 's2s=1' \
--data-urlencode 'app_token=36wbd8gmlvsw' \
--data-urlencode 'idfa=105C1794-7CF8-43A3-9C3F-B0DCEA2D29A9' \
--data-urlencode 'partner_sharing_settings={"all":{"all":false},"PartnerA":{"session":true}}' \
https://s2s.adjust.com/third_party_sharing

다이나믹 콜백만 비활성화

이렇게 하면 동적으로 생성된 콜백과의 공유가 비활성화되며 일반 파트너 연동에 영향을 주지 않습니다.

curl -G \
--data-urlencode 's2s=1' \
--data-urlencode 'app_token=36wbd8gmlvsw' \
--data-urlencode 'idfa=105C1794-7CF8-43A3-9C3F-B0DCEA2D29A9' \
--data-urlencode 'partner_sharing_settings={"dynamic_callbacks":{"all":false}}' \
https://s2s.adjust.com/third_party_sharing

오류 처리

third_party_sharing endpoint는 HTTP 응답 상태 코드를 사용하여 각 요청의 상태를 전달합니다. 다음과 같은 상태 코드가 반환됩니다.

200

요청의 모든 부분이 유효하며 적용되었습니다.

{
   "status": "OK"
}

202

요청의 일부가 유효하지 않습니다. 예를 들면 파트너 ID가 없거나 공유 옵션의 형식이 잘못되었습니다. 유효한 부분이 적용되고, 엔드포인트는 요청과 함께 문제의 상세 정보를 반환합니다.

{
  “error”: "Third party sharing failed (<error_message>)"
}

400

요청의 형식이 올바르지 않거나, 필수 파라미터를 포함하지 않거나, 유효한 데이터가 없습니다.

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

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

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

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

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

예시

curl -X POST \
  'https://s2s.adjust.com/third_party_sharing?s2s=1&sharing=enable&app_token=abc123abc123&gps_adid=10820328-872d-43a2-9786-0ccc748335d9' \
  -H 'Content-Type: application/json' \
  -d '{
    "granular_third_party_sharing_options": {
        "google_dma": {
            "ad_personalization": "1",
            "eea": "1",
            "ad_user_data": "1",
            "npa": "0"
        }