SKAN v3 매핑 API

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

엔드포인트

https://app.adjust.com/skadnetwork/{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

응답

매핑 엔드포인트는 앱에 관한 메타데이터와 매핑된 전환값의 배열을 포함한 JSON 객체를 반환합니다. 각 값에 대한 내용은 별도로 설명합니다.

{ "app_store_id":"1125517808", "updated_at":1617234177, "cut_off_period":1, "reporting_currency":"USD", "conversion_values":[ { "conversion_value":7, "events":[ ". .." ] }, { "conversion_value":10, "events":[ "..." ] }, { "conversion_value":12, "events":[ "..." ] } ] }

응답 메타데이터 파라미터

필드데이터 유형설명
app_store_idString앱의 App Store ID. 요청에서 전송된 app_store_id 파라미터와 일치.
updated_atNumber요청 파트너에게 보이는 가장 최근의 매핑 변경에 대한 Unix 타임스탬프.
Cut_off_periodNumber앱의 전환값 제한 설정. 값은 시간 단위로 표시됩니다.
reporting_currencyString앱에서 리포트 통화에 대한 ISO 4217 통화 코드. 매핑 스키마에 정의된 모든 매출 금액에 적용됩니다.

응답 전환값 필드

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

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

{ "app_store_id":"1125517808", "updated_at":1617234177, "cut_off_period":1, "reporting_currency":"USD", "conversion_values":[ { "conversion_value":12, "events":[ { "event_name": "Purchase", "count_min": 3, "count_max": 10, "revenue_min": 3.000, "revenue_max": 10.000 }, { "event_name": "Registration" } ] } ] } }

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

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

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

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

전체 응답 예시

{ "app_store_id":"1125517808", "updated_at":1617234177, "cut_off_period":1, "reporting_currency":"USD", "conversion_values":[ { "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" } } ] } ] }

응답 오류 코드

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