광고 채널 SKAdNetwork(SKAN) 연동하기

알립니다

이 가이드는 미디어 파트너를 대상으로 합니다.

SKAdNetwork(SKAN)으로 iOS 성과를 확인하기 위해서는 광고 채널별로 SKAN 연동이 필요합니다. 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 포스트백을 에어브릿지로 전송하는 방식입니다.

HTTP Protocol

Body

아래 정보가 Body에 반드시 포함되어야 합니다. 캠페인 파라미터는 선택적으로 전송합니다.

  • SKAN 포스트백에 포함된 모든 정보

  • 기여한 채널 이름(attributed-channel)

  • iOS 디바이스가 제공한 IP 주소와 포스트백 타임스탬프

필수 파라미터는 자세한 내용은 아래 테이블에서 확인해 주세요.

예시

cURL
123456789101112131415161718
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가 나와야 합니다.

HTTP Protocol

Redirect URL

아래 테이블을 참고해 Redirect URL의 GET 파라미터에 필요한 정보를 추가해 주세요. Attributed channel name (attributed-channel)는 필수 정보입니다. 캠페인 파라미터는 선택적으로 추가합니다.

예시

https://postback.airbridge.io/skadnetwork/v1?attributed-channel=adnetwork_abc&attributed-campaign=test_campaign&attributed-campaign-id=test_campaign_id

에어브릿지에서 광고 채널로 전달

광고 채널이 SKAdNetwork Configuration API로 고객사의 전환값 설정을 확인한 후에 해당 정보로 전환값을 직접 복호화(Decode)합니다.