SKAN v4 매핑 API

매핑 엔드포인트는 광고주의 전환값 매핑에 관한 정보를 반환합니다. 네트워크 파트너는 엔드포인트에 GET 요청을 통해 이 정보를 언제든지 가져올 수 있습니다.

중요:
타겟 앱이 SKAdNetwork v4를 사용하도록 설정되어 있지 않은 경우, 이 엔드포인트는 v3 매핑 스키마로 폴백됩니다. SKAN v3 매핑 엔드포인트 문서를 참조하시기 바랍니다.

엔드포인트

https://app.adjust.com/skadnetwork/v4/{sk_network_token}/mapping/{app_store_id}

GET request

매핑 정보를 JSON 객체의 배열로 반환합니다. 각 GET 요청은 다음의 파라미터를 포함해야 합니다.

파라미터데이터 유형In설명
sk_network_token*StringPathAdjust가 할당한 파트너별 토큰.

예: abcdefklmn
app_store_id*StringPath앱의 App Store ID.

예: 1125517808

응답

매핑 엔드포인트는 SKAdNetwork v4에서 전송한 3개의 포스트백에 상응하는 3개의 JSON 객체 배열을 반환합니다. 각 객체는 이에 상응하는 conversion_window 로 식별됩니다.

엔드포인트는 첫 포스트백에 대해서만 fine 및 coarse 매핑 정보 를 모두 반환합니다. 두 번째와 세 번째 포스트백은 coarse 매핑 정보를 포함합니다.

[ { "data": { "fine": [{}], "coarse": [{}], "settings": {}, }, "conversion_window": 1 } , { "data": { "coarse": [{}], "settings": {}, }, "conversion_window": 2 } { "data": { "coarse" : [{}], "settings": {}, }, "conversion_window": 3 } ]

Fine 전환값 필드

참고:
매핑 엔드포인트는 공유 설정과 이벤트 링크가 적용된 이후 최소 1개의 파트너 이벤트를 가진 전환값에 대한 매핑 정보를 반환합니다. 자세한 정보는 API 활동 페이지를 참고하시기 바랍니다.

매핑 엔드포인트는 각 매핑된 전환값과 관련 상세 정보의 상세 내용을 반환합니다.

[ { "data": { "fine": [ { "conversion_value":12, "events":[ { "event_name":"Purchase", "count_min":3, "count_max":10, " revenue_min":3.00, "revenue_max":10.00 }, { "event_name":"Registration" } ] } ], } } ]

이벤트 수와 매출 범위는 광고주의 파트너 액세스 구성에 따라 반환되는 선택적 파라미터입니다. 다음의 상세 정보가 매핑될 수 있습니다.

  • 세션
  • 세션 수
  • 이벤트
  • 이벤트 수
  • 이벤트 매출
  • IAP
  • 광고 매출
  • 총 매출
참고:
매출 정보를 확인하려면, 광고주가 요청을 하는 파트너에 대한 매출 공유를 활성화해야 합니다.

개수와 매출 범위 파라미터는 모두 선택 사항으로, 다음과 같이 정의됩니다.

파라미터데이터 유형디폴트 값설명
count_minNumber1이벤트 또는 세션이 지정한 횟수 이상으로 기록되었습니다.
count_maxNumber무제한이벤트 또는 세션이 지정된 횟수 이하로 기록되었습니다.
revenue_minNumber0총 매출이 지정한 금액 이상. 금액은 앱의 reporting_currency에서 측정됩니다.
revenue_maxNumber무제한총 매출이 지정한 금액을 초과하지 않음. 금액은 앱의 reporting_currency에서 측정됩니다.

Coarse 전환값 필드

Coarse 전환값은 전환의 양이 fine 전환값을 위한 개인정보 보호 기준을 충족할 만큼 많지 않은 경우에 사용됩니다. Coarse CV는 low, medium, high로 설정할 수 있으며, 사전 정의된 CV 값에 대한 집계된 버킷 역할을 합니다.

[ { "data": { "coarse": [ { "coarse_conversion_value": "low", "events": [ { "event_name": "PURCHASE", "revenue_min": 0, "revenue_max": 0.5 } ] }, { "coarse_conversion_value": "medium", "events": [ { "event_name": "PURCHASE", "revenue_min": 0.5, "revenue_max": 1.0 } ] }, { "coarse_conversion_value": "high", "events": [ { "event_name": "PURCHASE", "revenue_min": 1.0, "revenue_max": 50 } ] } ] } } ]
파라미터데이터 유형디폴트 값설명
coarse_conversion_valueString정의되지 않음Coarse 전환값의 레벨. 다음 중 하나가 될 수 있습니다.
  • "low"
  • "medium"
  • "high"
event_nameStringnull매핑된 이벤트의 이름.
count_minNumber1이벤트가 지정한 횟수 이상으로 기록되었습니다.
count_maxNumber무제한이벤트는 지정한 횟수 이하로 기록됩니다.
revenue_minNumber0이벤트에 대해 기록된 총 매출이 최소 지정된 금액입니다. 금액은 앱의 reporting_currency에서 측정됩니다.
revenue_maxNumber무제한이벤트에 대해 기록된 총 매출이 지정된 금액을 초과하지 않습니다. 금액은 앱의 reporting_currency에서 측정됩니다.

응답 설정 필드

[ { "data": { "settings": { "lock_window": { "time_in_hours": 24 }, "app_store_id":"1125517808", "updated_at":1617234177, "reporting_currency":"USD" , } } } ]
필드데이터 유형설명
app_store_idString앱의 App Store ID. 요청에서 전송된 app_store_id 파라미터와 일치.
updated_atNumber요청 파트너에게 보이는 가장 최근의 매핑 변경에 대한 Unix 타임스탬프.
lock_windowObject lock 윈도우관련 설정.
time_in_hoursNumberlock 윈도우의 길이(시간 단위).
reporting_currencyString앱에서 리포트 통화에 대한 ISO 4217 통화 코드. 매핑 스키마에 정의된 모든 매출 금액에 적용됩니다.

전체 응답 예시

[ { "data": { "fine": [ { "conversion_value":7, "events":[ { "event_name":"Registration" } ] }, { "conversion_value":10, "events":[ { "event_name":"TutorialComplete" } ] }, { "conversion_value":12, "events":[ { "event_name":"Purchase", "count_min":3, " count_max":10, "revenue_min":3.00, "revenue_max":10.00 }, { "event_name":"Registration" } ] } ], "coarse": [ { "coarse_conversion_value": "low", "events": [ { "event_name": "PURCHASE", "revenue_min": 0, "revenue_max": 0.5 } ] }, { "coarse_conversion_value": "medium", "events": [ { " event_name": "PURCHASE", "revenue_min": 0.5, "revenue_max": 1.0 } ] }, { "coarse_conversion_value": "high", "events": [ { "event_name": "PURCHASE", " revenue_min": 1.0, "revenue_max": 50 } ] } ], "settings": { "lock_window": { "time_in_hours": 24 }, "app_store_id":"1125517808", "updated_at":161723417772 , "reporting_currency":"USD", } }, "conversion_window": 1 }, { "data": { "coarse": [ { "coarse_conversion_value": "low", "event s": [ { "event_name": "PURCHASE", "revenue_min": 0, "revenue_max": 0.5 } ] }, { "coarse_conversion_value": "medium", "events": [ { "event_name ": "PURCHASE", "revenue_min": 0.5, "revenue_max": 1.0 } ] }, { "coarse_conversion_value": "high", "events": [ { "event_name": "PURCHASE", "revenue_min ": 1.0, "revenue_max": 50 } ] } ], "settings": { "app_store_id":"1125517808", "updated_at":1617234177, "reporting_currency":"USD", } }, " conversion_window": 2 }, { "data": { "coarse": [ { "coarse_conversion_value": "low", "events": [ { "event_name": "PURCHASE", "revenue_min": 0 , "revenue_max": 0.5 } ] }, { "coarse_conversion_value": "medium", "events": [ { "event_name": "PURCHASE", "revenue_min": 0.5, "revenue_max": 1.0 } ] }, { "coarse_conversion_value": "high", "events": [ { "event_name": "PURCHASE", "revenue_min": 1.0, "revenue_max": 50 } ] } ], "settings" : { "app_store_id":"1125517808", "updated_at":1617234177, "reporting_currency":"USD", } }, "conversion_window": 3 } ]

응답 오류 코드

오류 코드설명
400 Bad Request스토어 ID가 없거나 올바른 형식이 아닙니다.
401 Unauthorized네트워크 토큰이 없거나 인식되지 않습니다.
403 Forbidden앱이 인식되지만, 요청된 앱에 대한 파트너 공유 요건이 충족되지 않음.
404 Not Found요청하신 앱을 찾을 수 없거나 SKAdNetwork가 검증되지 않았습니다.
422 Unprocessable EntityAdjust가 요청한 앱을 인식하고 검증했으나, 해당 앱에 대한 전환값 관리 기능이 활성화되지 않았습니다.
429 Too Many Requests요청은 파트너/앱 당 기반으로 제한됩니다. Adjust는 하루에 한 번 업데이트를 가져오는 것을 권장합니다.