Adjust 페이로드 구조

Adjust 페이로드 구조를 사용하여 SKAdNetwork 페이로드로부터의 정보 및 모든 추가 정보를 Adjust로 전송합니다.

시작에 앞서

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

필수 여부

아래의 파라미터와 함께 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"
}

Adjust 페이로드 구조 생성하기

귀사와 Adjust 간의 데이터 매핑을 단순화하려면 지원되는 Adjust 캠페인 파라미터를 SKAdNetwork 엔드포인트에 추가하고 SKAdNetwork 설치 포스트백을 Adjust로 보내야 합니다.

아래의 단계를 참조하여 Adjust 페이로드 구조를 생성하세요:

  1. 엔드포인트에 sk_network_token 값을 추가한 후, 지원되는 Adjust 캠페인 파라미터를 추가합니다. SKAdnetwork 설치 포스트백 요청의 모든 파라미터가 입력되었는지 확인하시기 바랍니다.

  2. Adjust로 정보를 전송하기 위해 HTTP GET 매서드를 사용하시기 바랍니다.

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

예시:

https://app.adjust.com/skadnetwork/?tracker=abc123&campaign={your_campaign_name}&campaign_id={your_campaign_id}&adgroup={your_adgroup_name}&adgroup_id={your_adgroup_id}&creative={your_creative_name}&creative_id={your_creative_id}&sk_ts=1597151456&ip_address=10.10.10.10&user_agent=App+Store&sk_payload=%7B%0A%20%20%22version%22%20%3A%20%222.2%22%2C%0A%20%20%22ad-network-id%22%20%3A%20%22com.example%22%2C%0A%20%20%22campaign-id%22%20%3A%2042%2C%0A%20%20%22transaction-id%22%20%3A%20%226aafb7a5-0170-41b5-bbe4-fe71dedf1e28%22%2C%0A%20%20%22app-id%22%20%3A%20525463029%2C%0A%20%20%22attribution-signature%22%20%3A%20%22MEYCIQDTuQ1Z4Tpy9D3aEKbxLl5J5iKiTumcqZikuY%2FAOD2U7QIhAJAaiAv89AoquHXJffcieEQXdWHpcV8ZgbKN0EwV9%2FsY%22%2C%0A%20%20%22redownload%22%3A%20true%2C%0A%20%20%22source-app-id%22%3A%201234567891%2C%0A%20%20%22fidelity-type%22%3A%201%0A%20%20%22conversion-value%22%3A%2020%0A%20%20%22coarse-conversion-value%22%3A%20%22high%22%20%0A%20%20%22postback-sequence-index%22%3A%200%0A%20%20%22source-identifer%22%3A%20%225239%22%0A%7D

여기에서 sk_payload은 Apple로부터 수신한 암호화된 완전한 SKAdNetwork 페이로드입니다.

sk_ts은 Apple로부터 포스트백을 받은 시점의 UNIX 타임스탬프(초 단위)입니다. sk_ts값이 공란인 경우, Adjust는 사용자로부터 포스트백을 수신한 시점으로 폴백합니다.

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