광고 네트워크를 위한 SKAN 연동 가이드

광고 네트워크는 이 메서드를 사용하여 디바이스에서 수신한 각 포스트백을 앱스플라이어로 전달합니다.

광고 네트워크:

• iOS 기기에서 포스트백을 수신합니다.
• [선택 사항] 다음 항목으로 포스트백을 보강합니다.
  • 광고 네트워크 캠페인 ID 및 캠페인 이름.
  • 디바이스에서 받은 IP 주소로, 주로 지역 확인을 위해 필요합니다. 
  • iOS 디바이스에서 보낸 포스트백의 타임 스탬프.
• [선택 사항] 다음 항목으로 포스트백을 보강합니다.
  • 광고 세트 ID 및 이름
  • 광고 ID 및 이름
  • 광고 네트워크 이름
  • 국가 코드
  • 소스 앱 ID
  • 광고 소재
  • 채널
• 포스트백을 앱스플라이어에 전송
• 참고! 앱스플라이어에 포스트백을 보내기 전에 발신 포스트백의 콘텐츠를 사용하여 Apple 어트리뷰션 서명을 검증하여 실수로 데이터가 손상되지 않도록 합니다.

SKAN 강화 포스트백 프로토콜

SKAN 보강 포스트백 JSON 파라미터

Curl 예제 - 강화된 SKAN 3 포스트백

curl --location --request POST 'https://skadpostbacks.appsflyer.com/api/postbacks?app_id=id888707074' \
  --header 'Content-type: application/json' \
  --data-raw '{
      "version":"3.0",
      "app-id": 888707086,
      "ip": "192.0.2.0",
      "ad-network-campaign-name": "skadnetwork_abc_campaign",
      "source-app-id": 888707074,
      "ad-network-id": "abcabcabc.skadnetwork",
      "transaction-id": "68eb3d91-15f5-44ee-9267-25c7655c20b6",
      "redownload": false,
      "attribution-signature": "MDYCGQCsQ4y8d4BlYU9b8Qb9BPWPi+ixk/OiRysCGQDZZ8fpJnuqs9my8iSQVbJO/oU1AXUROYU=",
      "timestamp": "1596525944",
      "ad-network-campaign-id": "222222",
      "conversion-value": 63,
      "campaign-id": 99
  }'

curl 예제 - 미세 변환 값으로 강화된 SKAN 4 포스트백

curl --location --request POST 'https://skadpostbacks.appsflyer.com/api/postbacks?app_id=id888707074' \
  --header 'Content-type: application/json' \
  --data-raw '{
      "version": "4.0"
      "ad-network-id": "example123.skadnetwork",
      "ad-network-campaign-name": "skadnetwork_abc_campaign",
      "ad-network-campaign-id": "222222",
      "source-identifer": "5239",
      "app-id": 525463029,
      "transaction-id": "6aafb7a5-0170-41b5-bbe4-fe71dedf1e30",
      "redownload": false,
      "source-app-id": 1234567891,
      "fidelity-type": 1, 
      "did-win": true,
      "conversion-value": 63
      "postback-sequence-index": 0
      "attribution-signature": "MEUCIGRmSMrqedNu6uaHyhVcifs118R5z/AB6cvRaKrRRHWRAiEAv96ne3dKQ5kJpbsfk4eYiePmrZUU6sQmo+7zfP/1Bxo="
  }'

curl 예제 - 코스 변환 값으로 강화된 SKAN 4 포스트백

curl --location --request POST 'https://skadpostbacks.appsflyer.com/api/postbacks?app_id=id888707074' \
  --header 'Content-type: application/json' \
  --data-raw '{
      "version": "4.0"
      "ad-network-id": "example123.skadnetwork",
      "ad-network-campaign-name": "skadnetwork_abc_campaign",
      "ad-network-campaign-id": "222222",
      "source-identifer": "39",
      "app-id": 525463029,
      "transaction-id": "6aafb7a5-0170-41b5-bbe4-fe71dedf1e31",
      "redownload": false,
      "source-app-id": 1234567891,
      "fidelity-type": 1, 
      "did-win": true,
      "coarse-conversion-value": "high"
      "postback-sequence-index": 0
      "attribution-signature": "MEUCIQD4rX6eh38qEhuUKHdap345UbmlzA7KEZ1bhWZuYM8MJwIgMnyiiZe6heabDkGwOaKBYrUXQhKtF3P/ERHqkR/XpuA="
  }'

이 방법을 사용하여 광고 네트워크는 HTTP 리디렉션 명령(307)으로 디바이스에 응답하여 디바이스에 앱스플라이어에 직접 포스트백을 전송하도록 요청합니다. 

리디렉션 방법에는 다음과 같은 장점이 있습니다:

• 광고주 신뢰 향상: MMP는 광고주를 대신합니다. 앱스플라이어가 포스트백에 직접 액세스할 수 있도록 함으로써 광고주는 포스트백이 전송 중에 조작되지 않는다는 확신을 가질 수 있습니다.
  
• 광고네트워크에서 처리 필요 없음: 광고 네트워크는 리디렉션 명령(장치로)으로 응답하므로 포스트백을 처리할 필요가 없습니다. 이에 비해 인리치 앤 포워드 방법을 사용하려면 광고 네트워크가 포스트백을 소비하고 추가 파라미터로 보강한 다음 마지막으로 앱스플라이어로 전달해야 합니다.

구현하기

1. 포스트백을 https://skadredirect.appsflyer.com/api/redirects로 리디렉션하는 HTTP 307 응답으로 응답하도록 서버를 구성합니다.
2. 다음 표에 나열된 쿼리 매개 변수를 사용하여 캠페인 세부 정보가 포함된 쿼리 매개 변수를 추가합니다. 캠페인 세부 정보 전송을 필수로 간주하십시오. 캠페인 세부 정보를 통해 비용 및 기타 캠페인 데이터로 SKAN 데이터를 보강하고 광고주가 캠페인을 효과적으로 최적화할 수 있습니다.

리디렉션 URL 예

https://skadredirect.appsflyer.com/api/redirects?
  &ad-network-campaign-id=243232&ad-network-campaign-name=yarg_campaign_name
  &ad-network-adset-name=dsdsa&creative=examplecreative&channel=channelexample

캠페인 세부 정보에 대한 쿼리 매개 변수(필수 아님)

• 광고 네트워크에서 앱스플라이어로 전송된 각 포스트백에 대해 앱스플라이어는 다음을 전송합니다:
  • 한 번의 설치 포스트백. 다시 다운로드는 다시 다운로드 파라미터에 의해 신호를 받습니다. 
  • 인앱 이벤트 포스트백이 0개에서 여러 개입니다. 정확한 숫자는 전환 값의 변환에 따라 다릅니다. 시뮬레이션된 포스트백을 참조하십시오.
• 포스트백을 사용할 때 동일한 설치 또는 이벤트가 둘 이상의 AppsFlyer 어트리뷰션 솔루션에 의해 어트리뷰션될 수 있습니다. attribution_source 매개 변수를 사용하여 포스트백 형식을 구분합니다. 

앱스플라이어에서 보낸 인스톨 SKAN 포스트백의 예시

http://YourCompanyDomain.com/event?site_id=(publisher-id)&install_time=(timestamp)
  &skan_ad_network_time=(timestamp)
  &skan_af_received_time=(timestamp)
  &attribution_source=skadnetwork
  &app_id=(id123456789)&country=(ZA)&campaign=(campaign-name)
  &campaign_id=(campaign-id)&SKAN_ambiguous_event=(boolean)
&redownload=(boolean)
&af_SKAN_nonce=(uuid)

앱스플라이어에서 보낸 인앱 SKAN 포스트백의 예시

http://YourCompanyDomain.com/event?site_id=(publisher-id)&install_time=(timestamp)
  &skan_ad_network_time=(timestamp)
  &skan_af_received_time=(timestamp)&revenue=(value)
  &currency=(code)&event_name=(event-name)&attribution_source=skadnetwork
  &app_id=(id123456789)&country=(ZA)&campaign=(campaign-name)
  &campaign_id=(campaign-id)&SKAN_ambiguous_event=(boolean)
&redownload=(boolean)
&af_SKAN_nonce=(uuid)

광고 네트워크는 이 방법을 사용하여 라이브 앱에서 앱스플라이어에 실제 SKAN 포스트백을 전송합니다. 

테스트 통합

테스트 기준

• 이 방법을 사용하여 광고 네트워크는 아래 표에 설명된 대로 앱스플라이어에 미리 준비된 포스트백을 앱스플라이어 테스트 앱으로 전송합니다. 앱스플라이어는 디코딩된 포스트백으로 광고 네트워크에 응답합니다.
• 각 테스트 앱에는 표에 설명된 대로 서로 다른 전환 값 매핑이 있습니다.

통합 단계

테스트 기준