알립니다
아래 가이드는 광고 채널을 위한 가이드입니다.
SKAdNetwork(SKAN)으로 iOS 성과를 확인하기 위해서는 광고 채널별로 SKAN 연동이 필요합니다. SKAN 연동은 트래킹 링크를 활용한 연동 방식과 다른 연동입니다.
연동 데이터는 일반적으로 SKAdNetwork(SKAN)으로 아래 순서로 이동합니다.
1. iOS 디바이스에서 기록된 전환값(Conversion Value)을 광고 채널에 제공합니다. 광고주가 작업해야 합니다.
2. 광고 채널에서 에어브릿지로 전환값을 전달합니다.
3. 전환값을 매핑한 이벤트 정보가 에어브릿지에서 광고 채널로 전달됩니다.
SKAN 연동은 2번 단계와 3번 단계를 위한 연동입니다.
광고 채널이 받은 SKAN 포스트백을 에어브릿지 SKAN Postback API로 전달합니다. 아래 방식 중에서 1가지 방식으로 전달해 주세요.
파라미터별로 전송하는 방식에 차이가 있습니다. 소스가 SKAdNetwork Postback이면 별도 가공없이 그대로 전송해야 하는 파라미터입니다. 소스가 Ad Network이면 해당 정보를 광고 채널에서 복호화(decode)하거나 필요한 정보를 추가해 전송하는 파라미터입니다.
POST 메소드를 활용해 SKAN 포스트백을 에어브릿지로 전송하는 방식입니다.
Method | POST |
|---|---|
Endpoint |
|
Content-Type | application/json |
Response | 200: OK |
아래 정보가 Body에 반드시 포함되어야 합니다. 캠페인 파라미터는 선택적으로 전송합니다.
SKAN 포스트백에 포함된 모든 정보
기여한 채널 이름(attributed-channel)
iOS 디바이스가 제공한 IP 주소와 포스트백 타임스탬프
필수 파라미터는 자세한 내용은 아래 테이블에서 확인해 주세요.
파라미터 | 필수 여부 | 설명 | 소스 | 유형 |
|---|---|---|---|---|
version | true | SKAdNetwork Documentation(* version 2.0 미만의 경우, | SKAdNetwork Postback | string (nullable) |
ad-network-id | true | SKAdNetwork Postback | string | |
campaign-id | true | SKAdNetwork Postback | integer | |
source-identifier | true | SKAdNetwork(* version 4.0 미만의 경우, NULL 로 전송) | SKAdNetwork Postback | string |
transaction-id | true | SKAdNetwork Postback | string | |
app-id | true | SKAdNetwork Postback | integer | |
attribution-signature | true | SKAdNetwork Postback | string | |
redownload | true | SKAdNetwork Documentation(* version 2.0 미만의 경우, | SKAdNetwork Postback | boolean |
fidelity-type | true | SKAdNetwork Documentation(* version 2.2 미만의 경우, | SKAdNetwork Postback | Integer |
did-win | true | SKAdNetwork Documentation(* version 3.0 미만의 경우, | SKAdNetwork Postback | boolean |
postback-sequence-index | true | SKAdNetwork(* version 4.0 미만의 경우, NULL 로 전송) | SKAdNetwork Postback | integer |
source-app-id | false | SKAdNetwork Postback | integer | |
conversion-value | false | SKAdNetwork Postback | integer | |
coarse-conversion-value | false | SKAdNetwork Postback | string | |
attributed-channel | true | Attributed Channel (Airbridge 내 등록 된 채널명) | Ad Network | string |
attributed-campaign | false | Attributed Campaign | Ad Network | string |
attributed-campaign-id | false | Attributed Campaign ID | Ad Network | string |
attributed-ad-group | false | Attributed Ad Group | Ad Network | string |
attributed-ad-group-id | false | Attributed Ad Group ID | Ad Network | string |
attributed-ad-creative | false | Attributed Ad Creative | Ad Network | string |
attributed-ad-creative-id | false | Attributed Ad Creative ID | Ad Network | string |
attributed-sub-publisher | false | Attributed Sub Publisher | Ad Network | string |
attributed-sub-sub-publisher-1 | false | Attributed Sub Sub Publisher 1 | Ad Network | string |
attributed-sub-sub-publisher-2 | false | Attributed Sub Sub Publisher 2 | Ad Network | string |
attributed-sub-sub-publisher-3 | false | Attributed Sub Sub Publisher 3 | Ad Network | string |
ip | false | Device Public IP | Ad Network | string |
timestamp | true | iOS 기기에서 ad network가 포스트백을 수신한 시간. 13자리 UNIX 타임스탬프로 제공. | Ad Network | integer |
curl --location --request POST 'https://postback.airbridge.io/skadnetwork/v1' \
--header 'Content-type: application/json' \
--data-raw '{
"version":"2.0",
"ad-network-id": "abcabcabc.skadnetwork",
"campaign-id": 99,
"transaction-id": "68eb3d91-15f5-44ee-9267-25c7655c20b6",
"app-id": 888707086,
"attribution-signature": "MDYCGQCsQ4y8d4BlYU9b8Qb9BPWPi+ixk/OiRysCGQDZZ8fpJnuqs9my8iSQVbJO/oU1AXUROYU=",
"redownload": false,
"source-app-id": 888707074,
"conversion-value": 63,
"attributed-channel": "adnetwork_abc",
"attributed-campaign": "test_campaign",
"attributed-campaign-id": "test_campaign_id",
"ip": "192.0.2.0",
"timestamp": 1607678183995
}'SKAN 포스트백을 받은 광고 채널의 서버가 307 Redirect로 에어브릿지에 데이터를 전송하는 방식입니다.
알립니다
반드시 전송해야 하는 파라미터와 기여된 광고 캠페인 관련 파라미터를 페이로드(Payload)에 입력한 후에 에어브릿지 포스트백 서버(
postback.airbridge.io)로 전송하면 200 response가 나와야 합니다.
Method | 307 Redirect |
|---|---|
Endpoint |
|
Response | 200: OK |
아래 테이블을 참고해 Redirect URL의 GET 파라미터에 필요한 정보를 추가해 주세요. Attributed channel name (attributed-channel)는 필수 정보입니다. 캠페인 파라미터는 선택적으로 추가합니다.
파라미터 | 필수 여부 | 설명 | 소스 |
|---|---|---|---|
attributed-channel | true | Attributed Channel (Airbridge 내 등록 된 채널명) | Ad Network |
attributed-campaign | false | Attributed Campaign | Ad Network |
attributed-campaign-id | false | Attributed Campaign ID | Ad Network |
attributed-ad-group | false | Attributed Ad Group | Ad Network |
attributed-ad-group-id | false | Attributed Ad Group ID | Ad Network |
attributed-ad-creative | false | Attributed Ad Creative | Ad Network |
attributed-ad-creative-id | false | Attributed Ad Creative ID | Ad Network |
attributed-sub-publisher | false | Attributed Sub Publisher | Ad Network |
attributed-sub-sub-publisher-1 | false | Attributed Sub Sub Publisher 1 | Ad Network |
attributed-sub-sub-publisher-2 | false | Attributed Sub Sub Publisher 2 | Ad Network |
attributed-sub-sub-publisher-3 | false | Attributed Sub Sub Publisher 3 | Ad Network |
https://postback.airbridge.io/skadnetwork/v1?attributed-channel=adnetwork_abc&attributed-campaign=test_campaign&attributed-campaign-id=test_campaign_id
광고 채널이 SKAdNetwork Conversion Value Config API로 고객사의 전환값 설정을 확인한 후에 해당 정보로 전환값을 직접 복호화(Decode)합니다.
도움이 되었나요?