Apple 페이로드 구조

Apple 페이로드 구조를 사용하여 SKAdNetwork 페이로드로부터의 정보 및 기타 캠페인 정보를 Adjust에 전송하시기 바랍니다.

Adjust는 Apple의 JSON SKAdNetwork 페이로드 구조를 지원합니다.

시작에 앞서

시작하기 전에 알아야 할 사항은 다음과 같습니다.

필수 요건

아래의 파라미터와 함께 Apple로부터의 SKAdNetwork 페이로드를 수신하시기 바랍니다.

  • version
  • ad-network-id
  • campaign-id
  • transaction-id
  • app-id
  • attribution-signature
  • redownload
  • source-app-id
  • conversion-value
  • fidelity-type (SKAdNetwork 버전 2.2 이상)
  • did-win (iOS 14.6 이상, SKAdNetwork 버전 3.0)
  • coarse-conversion-value (iOS 16.1 이상, SKAdNetwork 버전 4.0)
  • source-identifier (iOS 16.1 이상, SKAdNetwork 버전 4.0)
  • postback-sequence-index (iOS 16.1 이상, SKAdNetwork 버전 4.0)

예시:

{
  "version" : "2.2",
  "ad-network-id" : "com.example",
  "campaign-id" : 42,
  "transaction-id" : "6aafb7a5-0170-41b5-bbe4-fe71dedf1e28",
  "app-id" : 525463029,
  "attribution-signature" : "MEYCIQDTuQ1Z4Tpy9D3aEKbxLl5J5iKiTumcqZikuY/AOD2U7QIhAJAaiAv89AoquHXJffcieEQXdWHpcV8ZgbKN0EwV9/sY",
  "redownload": true,
  "source-app-id": 1234567891,
  "fidelity-type": 1,
  "conversion-value": 20,
  "did-win": true
  "coarse-conversion-value": "high" 
  "postback-sequence-index": 0
  "source-identifer": "5239"
}

Apple 페이로드 구조 생성하기

지원되는 Adjust 캠페인 파라미터를 Apple SKAdNetwork 페이로드에 추가한 뒤, SKAdNetwork 설치 포스트백을 Adjust에 전송해야 합니다.

아래의 단계를 참조하여 Apple 페이로드 구조를 생성하시기 바랍니다.

  1. 추가 정보를 Apple SKAdNetwork 페이로드에 첨부합니다.
파라미터설명
adjust-tracker6/7자로 이루어진 Adjust 링크 토큰
adjust-campaignAdjust 캠페인 이름
adjust-campaign-idAdjust 캠페인 ID
adjust-adgroupAdjust 광고 그룹 이름
adjust-adgroup-idAdjust 광고 그룹 ID
adjust-creativeAdjust 크리에이티브 이름
adjust-creative-idAdjust 크리에이티브 ID
timestampApple로부터의 오리지널 포스트백을 받은 시점의 UNIX 타임스탬프(초 단위).
이 값이 공란인 경우, Adjust는 이를 고객사로부터 포스트백을 수신한 시간으로 대체합니다.
country설치 위치를 나타내는 2자리 국가 코드.
이 값이 공란인 경우, Adjust는 해당 값을 "ZZ"(또는 집계된 리포트에서는 "Unknown")로 보고합니다.
  1. Adjust로 정보를 전송하려면 HTTP POST 메서드를 Content-Type: application/json 와 함께 사용하시기 바랍니다.

Adjust는 다음의 정보를 수신하게 됩니다:

예시:

URL: https://app.adjust.com/skadnetwork/<sk_network_token>

본문:

{ "source-app-id" : 123456789, "app-id" : 987654321, "attribution-signature" : "xxxxxxxxxxxx", "campaign-id" : 1, "transaction-id" : "6aafb7a5-0170-41b5 -bbe4-fe71dedf1e28", "conversion-value" : 1, "fidelity-type": 1, "version" : "2.2", 
"ad-network-id" : "xxxxxxxxx.skadnetwork", 
"redownload" : true, "coarse-conversion-value": "high" "postback-sequence-index": 0 "source-identifier": "5239" "adjust-tracker": "abc123", "adjust-campaign" : "test_campaign_name", "adjust-campaign-id": "test_campaign_id", "adjust-adgroup": "test_adgroup_name", "adjust-adgroup-id": "test_adgroup_id", "adjust-creative": "test_creative_name", " adjust-creative-id": "test_creative_id", "timestamp": 1597151456, "country": "de", "ip-address": "10.10.10.10", 
"user-agent": "App Store" }

여기서 user_agent 는 SKAdNetwork 페이로드로부터의 사용자 에이전트입니다. 그러나, Adjust는 실제 브라우저의 사용자 에이전트를 전송하는 것을 권장합니다. 예: Mozilla/5.0 (iPod; U; CPU iPhone OS 4_3_3 like Mac OS X; ja-jp) AppleWebKit/533.17.9 (KHTML, like Gecko) Version/5.0.2 Mobile/8J2 Safari/6533.18.5