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 페이로드 구조를 생성하시기 바랍니다.
- 추가 정보를 Apple SKAdNetwork 페이로드에 첨부합니다.
파라미터 | 설명 |
---|---|
adjust-tracker | 6/7자로 이루어진 Adjust 링크 토큰 |
adjust-campaign | Adjust 캠페인 이름 |
adjust-campaign-id | Adjust 캠페인 ID |
adjust-adgroup | Adjust 광고 그룹 이름 |
adjust-adgroup-id | Adjust 광고 그룹 ID |
adjust-creative | Adjust 크리에이티브 이름 |
adjust-creative-id | Adjust 크리에이티브 ID |
timestamp | Apple로부터의 오리지널 포스트백을 받은 시점의 UNIX 타임스탬프(초 단위). 이 값이 공란인 경우, Adjust는 이를 고객사로부터 포스트백을 수신한 시간으로 대체합니다. |
country | 설치 위치를 나타내는 2자리 국가 코드. 이 값이 공란인 경우, Adjust는 해당 값을 "ZZ"(또는 집계된 리포트에서는 "Unknown")로 보고합니다. |
- 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