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

요약: 광고 네트워크는 앱스플라이어 SKAdNetworks(SKAN)와 연동하여 캠페인을 최적화하고 생성하는 트래픽에 어트리뷰트 할 수 있습니다.

광고 네트워크를 위한 앱스플라이어 오퍼링

광고주 용 앱스플라이어 SKAN 솔루션 자세히 알아보기:

SKAN 솔루션 가이드| SKAN 대시보드 

  • 캠페인 전환에 어트리뷰트됩니다.
    • 앱스플라이어와의 연동을 통해 광고 네트워크는 광고주를 대신하여 실행된 캠페인을 통해 발생한 모든 인스톨, 인앱이벤트 및 수익에 어트리뷰트됩니다.
    • 연동이 없으면 인스톨, 인앱이벤트, 수익은 광고 네트워크가 아닌 오가닉으로 어트리뷰트됩니다. 
  • 캠페인 최적화:
    • 포스트백의 전환 값이 인코딩됩니다.
    • 광고 네트워크는 앱스플라이어를 사용하여 각 포스트백의 전환 가치를 변환할 수 있으므로 광고 네트워크가 앱당 디코딩된 값을 기반으로 캠페인을 최적화할 수 있습니다.
  • 각 광고주와 직접 연동할 필요가 없습니다.SKAN 포스트백은 광고 네트워크로만 전송되며 광고주는 다음 중 하나를 사용하여 데이터를 사용할 수 있습니다.
    • 각 광고 네트워크와의 개별 연동. 광고 네트워크나 광고주에 대해 확장할 수 없는 솔루션입니다. 
    • 앱스플라이어와의 단일 연동. 광고주와 광고 네트워크 모두에 맞게 확장 가능합니다.
  • 앱스플라이어의 중요성 증가: 
    • SKAN 연동을 포함한 광고 네트워크는 앱스플라이어 대시보드에서 인증되고 식별됩니다. 
    • 이로부터 광고주는 이 어트리뷰션 모델을 통해 결정론적으로 측정할 수 있는 광고 네트워크로 작업하고 있음을 확신할 수 있습니다.

SKAN 데이터 흐름

5754_Postback_flow_for_SKAD__1_.png

전체 SKAN 포스트백 흐름은 다음과 같습니다.

  1. iOS는 어트리뷰트된 광고 네트워크에 SKAN 포스트백을 보냅니다.
  2. 광고 네트워크는 다음 기능 중 하나를 수행합니다.
    • 보강 및 전달: 광고 네트워크 캠페인 ID/소스 식별자, 캠페인 이름 및 iOS 디바이스 IP 주소로 SKAN 포스트백을 보강합니다. 
    • 리디렉트: 네트워크는 iOS 디바이스에 포스트백을 앱스플라이어로 직접 리디렉트하도록 요청합니다. 이 경우 캠페인 데이터 보강은 앱스플라이어와 광고 네트워크 간의 별도의 API를 통해 수행됩니다.
  3. 앱스플라이어 는 포스트백을 검증하고 디코드합니다. 그런 다음 디코드되고 보강된 포스트백을 광고 네트워크로 보냅니다 (또한 광고주와 공유함).

기본 연동 부분

앱스플라이어와 광고 네트워크 간의 SKAN 연동은 본 문서에 설명된 대로 다음과 같은 주요 부분으로 구성됩니다.

  • 광고 네트워크가 SKAN 데이터를 앱스플라이어로 전송
  • 광고 네트워크가 포스트백을 통해 앱스플라이어로부터 보강되고 디코드된 데이터 수신

앱스플라이어로 데이터 전송

광고 네트워크는 디바이스에서 SKAN 포스트백을 수신한 후 다음 방법 중 하나를 사용하여 이를 앱스플라이어로 전달합니다.

  • 보강 및 전달(POST)
  • 리디렉트(HTTP 307 리디렉트 메서드)

앱스플라이어는 SKAN 포스트백을 수신하면 다음을 수행합니다.

  • 포스트백 유효성 검증: 포스트백이 고유한지 확인합니다.
  • 전환 가치 디코드: 어트리뷰션 인스톨/인앱이벤트 기록을 생성합니다.
  • 디코딩한 포스트백을 광고 네트워크로 보냅니다.
  • 광고주가 대시보드와 리포트를 통해 어트리뷰션 데이터를 사용할 수 있도록 합니다.

보강 및 전달

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

광고 네트워크:

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

SKAN 강화 포스트백 프로토콜

앤드 포인트

https://skadpostbacks.appsflyer.com/api/postbacks

HTTP 메서드 POST
허용된 콘텐츠 유형 application/json
리턴 코드

200 OK: 수신한 포스트백의 형식이 잘못되었습니다. 

400: 잘못된 요청: 잘못된 형식의 JSON, 비어 있는 값, JSON, 필수 필드 누락.

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

파라미터

형식

설명

미디어 소스

버전 문자열

SKAdNetwork 버전

예시: "version":"2.0"

SKAN 포스트백
ad-network-id 문자열

광고 네트워크 ID

예시: "ad-network-id":" abc123defg.SKAdnetwork"

SKAN 포스트백
ad-network-name 문자열
  • 광고 네트워크의 이름
  • 예시: ad_network_name=your_network
애드 네트워크
ad-network-country-code 문자열
  • 광고 네트워크에서 산생한 사용자 위치(지역)입니다.
  •  ISO 3166(알파-2) 코드를 사용하여 채웁니다.
  • 예시: CN, ZA
  • 광고 네트워크는 종종 특정 캠페인의 타겟 지역에 따라 지역을 산생합니다.  
  • 앱스플라이어는 리포트 및 대시보드의 지역 관련 필드를 국가 코드로 채웁니다.
애드 네트워크
campaign-id 정수
  • SKAN 3 이하에만 해당
  • SKAdNetwork 캠페인 ID
  • 예시: "campaign-id":23
SKAN 포스트백
transaction-id 문자열

SKAdNetwork 포스트백 트랜젝션 ID

SKAN 포스트백
app-id 정수
  • 앱스플라이어에 나타나는 타겟 앱 ID입니다. 항상 접두사 id가 있습니다.
  • 예시:app_id=id123456789
SKAN 포스트백
attribution-signature 문자열 어트리뷰션 서명 SKAN 포스트백 
재다운로드 Boolean redownload = true이면 사용자가 앱 스토어에서 앱을 다시 다운로드했음을 의미합니다. SKAN 포스트백
source-app-id 정수
  • 소스 앱 ID(퍼블리셔)
  • SKAN 4의 경우 계층 3에 대해 첫 번째 포스트백에서만 사용할 수 있습니다. 애플 문서참조
SKAN 포스트백
conversion-value 정수

앱스플라이어 SDK는 광고주 설정에 따라 전환 가치를 설정합니다.

참고!

  • iOS 프라이버시 보호 임계값으로 인해 iOS는 포스트백의 파라미터를 채우지 못할 수 있으며 이 때 값은 null이 됩니다.
  • Null과 0은 서로 다른 의미를 가집니다.
    • Null: iOS에서 전환 가치를 보류
    • 0: 사용자가 앱을 인스톨했지만 측정된 작업을 수행하지 않았습니다.  
SKAN 포스트백 
ad-network-campaign-id 문자열

광고 네트워크와 광고주, 앱스플라이어 간에 공통 언어를 활성화하려면 캠페인 ID를 제공해야 합니다.

애드 네트워크
ad-network-campaign-name 문자열 광고 네트워크 캠페인 ID와 연결된 광고 네트워크 캠페인 이름입니다. 이 이름은 대시보드와 리포트에 표시됩니다.  애드 네트워크
ad-network-adset-id 문자열

광고 네트워크 광고 세트 ID

애드 네트워크
ad-network-adset-name 문자열

광고 네트워크 광고 세트 이름

애드 네트워크
ad-network-ad-name 문자열

Ad network ad name

애드 네트워크
ad-network-ad-id 문자열

광고 네트워크 광고 ID

애드 네트워크
ip 문자열
  • 포스트백을 보내는 장치의 IP 주소입니다.
  • iPv4 및 IPv6 주소가 지원됩니다.
  • 예:"ip":"198.51.100.1"
애드 네트워크
타임 스탬프 문자열
  • 광고 네트워크가 SKAN 포스트백을 수신한 시간입니다. 10자리 에포크 UNIX 타임스탬프입니다. [선택 사항] 13자리 에포크 타임스탬프가 허용됩니다.
  • 예:  2020년 8월 4일 07:25 UTC는 다음과 같이 변환됩니다. "timestamp": "1596525944"
애드 네트워크
fidelity-type 정수
  • 어트리뷰션에 영향을 주는 광고 프레젠테이션 옵션 차이를 식별합니다. 다음과 같이 값 0과 1을 사용하여 표시됩니다: 
    • 뷰-쓰루 광고(0)
    • 스토어킷 렌더링 광고 (1)
  • SKAN V2.2부터 필수 필드
SKAN 포스트백(V2.2+)
did-win Boolean
  • 설치에 기여하거나 기여 한 캠페인을 구별하는 데 사용됩니다 .
  • true인 경우 인스톨을 가져오기 위해 캠페인이 어트리뷰트됩니다.
  • false이면 캠페인은 인스톨을 기여하는 것으로 인식됩니다.
SKAN 포스트백(V3.0+)
ad-network-source-app-id 문자열

광고를 게시하는 앱과 연결하는 게시자 ID 로 채웁니다. 일반적으로 Apple에서 생성한 ID가 아니라 게시자에게 할당한 ID입니다. 

애드 네트워크

postback-sequence-index

정수
  • 스칸 4+ 전용
  • 값은 시퀀스 번호(SKAN 창) 중0,12 중 하나를 나타냅니다.
SKAN 4.0 포스트백(iOS 16.2)

coarse-conversion-value

문자열
  • 스칸 4+ 전용
  • 값은 low, medium 또는 high일 수 있습니다.
  • 첫 번째 포스트백의 경우 계층 1에만 사용할 수 있습니다. 두 번째 및 세 번째 포스트백의 경우 계층 1-3에 사용할 수 있습니다. 애플 문서참조
SKAN 4.0 포스트백(iOS 16.2)

source-identifier

문자열
  • 스칸 4+ 전용
  • campaign-id 대체
  • 값은 최대 4자리일 수 있습니다.
  • 첫 번째 포스트백의 경우 계층 2-3에 대해 최대 4자리, 계층 0-1에 대해 2자리를 사용할 수 있습니다. 두 번째 및 세 번째 포스트백의 경우 계층 1-3에 대해 2자리 숫자를 사용할 수 있습니다. 계층 0의 경우 포스트백이 없습니다. 애플 문서참조

SKAN 4.0 포스트백(iOS 16.2)

source-domain

문자열
  • 스칸 4+ 전용
  • 값은 어트리뷰션 가능한 웹 광고의 소스를 나타냅니다. 예: example.com 
  • 웹 광고에서만 사용할 수 있으며, 첫 번째 포스트백에서는 계층 3에 사용할 수 있습니다. 애플 문서참조
SKAN 4.0 포스트백(iOS 16.2)

광고 소재

문자열
  • SKAN 4+에만 해당됩니다.
  • 추가 캠페인 세분성을 위해 source_identifier 에서 추가 숫자를 사용할 때 사용할 수 있습니다.
애드 네트워크

채널

문자열
  • SKAN 4+에만 해당됩니다.
  • 추가 캠페인 세분성을 위해 source_identifier 에서 추가 숫자를 사용할 때 사용할 수 있습니다.
애드 네트워크

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="
  }'

리다이렉트

Redirect_us-en__2_.png

이 방법을 사용하여 광고 네트워크는 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

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

Query param

설명

ad-network-name
  • 광고 네트워크의 이름
  • 예시: ad_network_name=your_network
ad-network-campaign-id 캠페인 ID
ad-network-campaign-name Campaign name
ad-network-adset-id 광고세트 ID
ad-network-adset-name 광고 세트 이름
ad-network-ad-id 광고 아이디
ad-network-ad-name 광고 이름
ad-network-country-code
  • 광고 네트워크에서 산생한 사용자 위치(지역)입니다.
  •  ISO 3166(알파-2) 코드를 사용하여 채웁니다.
  • 예시: CN, ZA
  • 광고 네트워크는 종종 특정 캠페인의 타겟 지역에 따라 지역을 산생합니다.  
  • 앱스플라이어는 리포트 및 대시보드의 지역 관련 필드를 국가 코드로 채웁니다.
ad-network-source-app-id 광고를 게시하는 앱과 연결하는 게시자 ID 로 채웁니다. 일반적으로 Apple에서 생성한 ID가 아니라 게시자에게 할당한 ID입니다. 
ip
  • 포스트백을 보내는 장치의 IP 주소입니다.
  • iPv4 및 IPv6 주소가 지원됩니다.
  • 예:"ip":"198.51.100.1"
타임 스탬프
  • 광고 네트워크가 SKAN 포스트백을 수신한 시간입니다. 10자리 에포크 UNIX 타임스탬프입니다. [선택 사항] 13자리 에포크 타임스탬프가 허용됩니다.
  • 예:  2020년 8월 4일 07:25 UTC는 다음과 같이 변환됩니다. "timestamp": "1596525944"
광고 소재
  • SKAN 4+에만 해당됩니다.
  • 추가 캠페인 세분성을 위해 source_identifier 에서 추가 숫자를 사용할 때 사용할 수 있습니다.
채널
  • SKAN 4+에만 해당됩니다.
  • 추가 캠페인 세분성을 위해 source_identifier 에서 추가 숫자를 사용할 때 사용할 수 있습니다.

앱스플라이어에서 데이터 수신

첫 번째 포스트백을 받기 전에 다음 사항을 고려하십시오. 

  • 광고 네트워크는 포스트백 엔드포인트와 템플릿을 정의해야 합니다(  파트너 어시스턴트 위젯을 사용하여 앱스플라이어 파트너 개발 매니저에게 연락하여 이를 제대로 구현 해야 함).
  • 앱스플라이어는 사용자에게 전송된 기존 포스트백과 동일한 메커니즘을 사용하여 SKAN 포스트백을 전송합니다.

원리

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

광고 네트워크 파트너가 사용할 수 있는 포스트백 매크로

포스트백 매크로(이름)

설명

형식 및 예 인앱 이벤트에만 해당

site_id

광고를 게시하는 앱(원본 앱 ID)

String: 876534

 

install_time

앱스플라이어가 업데이트 전환 창을 기준으로 추정합니다. 10자리 UNIX epoch 타임스탬프 또는 사람이 읽을 수 있는 타임스탬프로 제공

  • String: 1596119460 
  • 2020년 7월 30일 14:31 UTC로 변환됩니다.
 

skadnetwork_ad_network_time

iOS 기기에서 광고 네트워크에 포스트백을 수신한 시간입니다. 광고 네트워크에서 보고합니다. 10자리 UNIX epoch 타임스탬프 또는 사람이 읽을 수 있는 타임스탬프로 제공

  • String: 1596119460 
  • 2020년 7월 30일 14:31 UTC로 변환



 


skadnetwork_received_time

Time AppsFlyer는 광고 네트워크로부터 포스트백을 수신했습니다. 10자리 UNIX epoch 타임스탬프 또는 사람이 읽을 수 있는 타임스탬프로 제공

 

  • String: 1596119460 
  • 2020년 7월 30일 14:31 UTC로 변환

 

event_name

이벤트 이름 

  • af_skadnetwork_revenue
  • af_login
  • af_skadnetwork_revenue
  • 또는 광고주가 설정한 대로 

String: af_skadnetwork_revenue, abc123

 

수익

지정된 통화 코드를 사용한 수익 금액

번호: 5, 20, 0.4

currency

통화 코드는 광고주가 설정한 앱별 통화입니다.

문자열: 유로, 달러, 자르

attribution_source

어트리뷰션 데이터의 출처:

SKAdNetwork: SKAdNetwork

String: SKAdNetwork

 

app_id

앱 ID(광고주 앱)

문자열: ID123456790

 

국가

광고 네트워크에 의해 결정된 설치 지역(국가)

문자열: 미국, 영국, ZA 

 

campaign

광고 네트워크에서 포스트백으로 전송된d-network-campaign-name 을 사용하여 채워진 캠페인 이름

문자열: UA_US_23+

 

campaign_id

광고 네트워크에서 포스트백으로 전송된 광고 네트워크 캠페인 ID를 사용하여 채워진 광고 네트워크 캠페인 ID. 참고: SKAN 4의 경우 이 값은 항상 null입니다.

문자열: 3456745

 

재다운로드

가능한 값: 참, 거짓

다시 다운로드 = true이면 사용자가 앱 스토어에서 앱을 다시 다운로드했음을 의미합니다.

불 값: 참/거짓

 

skadnetwork_ambiguous_event

광고주가 대시보드에서 SKAN 설정을 변경한 후 처음 72시간 동안 수신된 이벤트입니다. SKAN 앱스플라이어에서 사용하는 다양한 타이머로 인해 이벤트를 정확하게 매핑할 수 없습니다.

불 값: 참/거짓

 

skadnetwork_campaign_id

오리지널 SKAN 포스트백에서 제공한 SKAN 캠페인 ID

56, 23

 

af_skadnetwork_nonce

파트너가 중복 포스트백을 식별할 수 있게 하는 고유한 랜덤 식별자

 

 

event_id

광고 네트워크 플랫폼에서 해당 이벤트 의 이름/ID

 

transaction_id

SKAN 포스트백 트랜잭션 ID

참고: 광고주는 transaction_id 공유할 수 있도록 명시적으로 허용해야 합니다. 광고주에게 통합 탭에서 그렇게 하도록 요청합니다.

 

 

ad_network_adset_id 광고 네트워크에 의해 iOS 포스트백에 추가됨 문자열  
ad_network_adset_name 광고 네트워크에 의해 iOS 포스트백에 추가됨 문자열  
ad_network_ad_name 광고 네트워크에 의해 iOS 포스트백에 추가됨 문자열  
ad_network_ad_id 광고 네트워크에 의해 iOS 포스트백에 추가됨 문자열  
SKAN_min_event_counter 참고 (1) 참조

정수

SKAN_max_event_counter 참고 (1) 참조

정수

SKAN_min_time_post-install 참고 (2) 참조

정수

SKAN_max_time_post-install 참고 (2) 참조

정수

SKAN_min_event_revenue 일러두기 (3)을 참조하십시오. 실제 번호
SKAN_max_event_revenue 일러두기 (3)을 참조하십시오.

실제 번호 

fidelity-type

어트리뷰션에 영향을 주는 광고 프레젠테이션 옵션 차이를 식별합니다. 다음과 같이 값 0과 1을 사용하여 표시됩니다: 

  • 뷰-쓰루 광고(0)
  • 스토어킷 렌더링 광고 (1)
정수  
skad_af_attribution_flag

사용자가 단일 진성원 메커니즘을 사용하는 앱스플라이어에 의해 어트리뷰트되었음을 표시하는 데 사용됩니다. 

Boolean  
skad_postback_sequence_index
  • 값은 SKAN 기간을 0, 1 또는 2로 나타냅니다.
  • SKAN 3의 경우 값은 0입니다.
정수  
skad_coarse_conversion_value
  • 값은 low, medium 또는 high일 수 있습니다.
  • SKAN 3의 경우 값은 null입니다.
문자열  
skad_source_identifier
  • 값은 최대 4자리일 수 있습니다.
  • SKAN 3의 경우 값은 null입니다. 
문자열  
skad_source_domain
  • 값은 어트리뷰션 가능한 웹 광고의 소스를 나타냅니다.
  • SKAN 3의 경우 값은 null입니다.
문자열  
ad_network_creative
  • 값은 광고 네트워크에서 수신된 데이터 보강을 기반으로 합니다.
  • SKAN 3의 경우 값은 null입니다.
문자열  
ad_network_channel
  • SKAN 4+에만 해당됩니다.
  • 추가 캠페인 세분성을 위해 source_identifier 에서 추가 숫자를 사용할 때 사용할 수 있습니다.
문자열  

일러두기:

  1. 이벤트 발생:이벤트 발생 횟수는 다음 공식을 사용하여 계산됩니다.
    [round up (SKAN_min_event_counter+SKAN_max_event_counter) / 2]
    참고! 값은 가장 가까운 정수로 반올림되게 됩니다.
  • 예:
    • A. min=0이고 max=1이면 이벤트 수는 1입니다.
    • B. min=0이고 max=10이면 이벤트 수는 5입니다.
  • 인스톨 시간 결정: 터스텀 전환을 구현하는 광고주의 경우 앱스플라이어는 인스톨 시간을 포스트백 도착 시간 - 48시간- 평균(min_time_post_install + max_time_post_install)으로 계산합니다. 광고 네트워크는 이러한 매크로를 사용할 필요가 없습니다.  
  • 수익 결정: 앱스플라이어는 이 값을 사용하여 최소 및 최대의 평균을 계산하여 이벤트의 수익을 결정합니다. 광고 네트워크는 이러한 매크로를 사용할 필요가 없습니다. 

SKAN 포스트백 예시

앱스플라이어에서 보낸 인스톨 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 포스트백: 네트워크에서 수신한 실제 SKAN 트래픽에 기반
  • 시뮬레이션된 포스트백: 앱스플라이어 테스트 앱 기반

iOS 디바이스에서 실제 SKAN 포스트백을 수신하기 위해 광고 네트워크는 다음 처리를 완료합니다.

시뮬레이션된 포스트백을 받으려면:

실제 환경

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

테스트 통합

담당자 액션
애드 네트워크 Apple에서 제공하는 SKAN 네트워크 ID에 관해 파트너 개발 관리자를 통해(또는 파트너 지원 위젯을 사용하여) 앱스플라이어에 알립니다.
광고 네트워크 및 앱스플라이어 포스트백 통합 인증에 사용할 상호 고객(최신 AppsFlyer SDK를 통합)에 동의합니다.
애드 네트워크 본 기사에서 설명한 방법 중 하나를 사용하여 앱 SKAN 포스트백을 앱스플라이어로 보냅니다.
앱스플라이어 광고주에 의해 설정된 변환 값 매핑에 따라 디코딩된 포스트백을 광고 네트워크로 보냅니다.

테스트 기준

담당자 액션
애드 네트워크 합의된 상호 고객에 대해 지정된 기간 동안 전송된 SKAN 포스트백의 수량에 대해 앱스플라이어에 알립니다.
앱스플라이어 수신된 포스트백 수와 광고 네트워크에서 보낸 포스트백 수를 확인합니다.
앱스플라이어

광고 네트워크와 특정 앱에 대해 네트워크로 전송된 포스트백 수를 유형별로 분류하여 공유합니다:

  • 포스트백 설치/다시 다운로드
  • 인앱 포스트백.
참고: 확률적 포스트백에 동일한 엔드포인트를 사용하는 경우 attribution_source=skad network를 사용하여 SKAN 네트워크 포스트백을 다른 포스트백과 구별하여 필터링해야 합니다.

시뮬레이션된 포스트백

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

수익, $1 단위

예상 결과: 

  1. 통합 탭에서 in-app 이벤트 포스트백을 활성화합니다
  2. 이벤트 이름 af_SKAN_revenue을 선택하고 이벤트 식별자에 매핑합니다.
  3. 구성을 저장합니다.
  4. 포스트백에서 전송 전환 가치 = 7.
  5. 앱스플라이어는 다음과 같이 응답합니다:
    • 인스톨 포스트백
    • $7 가치의 af_SKAN_revenue 포스트백
id888707086 인앱 이벤트를 포함한 전환:
  • af_레벨_완성
  • af_login
  • af_SKAN_revenue
  • af_등록
  • af_구독
  • af_고객_이벤트
  1. 통합 탭에서 in-app 이벤트 포스트백을 활성화합니다
  2. 나열된 각 인앱 이벤트를 선택하고 이벤트 식별자에 매핑합니다. 
  3. 구성을 저장합니다.
  4. 포스트백에서 전송 전환 가치 = 7.
  5. 앱스플라이어는 다음과 같이 응답합니다:
    • 인스톨 포스트백
    • af_레벨_완성 포스트백
    • af_로그인 포스트백
    • af_SKAN_revenue 포스트백
    • af_등록 포스트백
    • af_구독 포스트백
    • af_고객_이밴트 포스트백
id888707087 af_SKAN_revenue 이벤트를 사용하여 측정한 인게이지먼트
  1. 통합 탭에서 in-app 이벤트 포스트백을 활성화합니다
  2. 이벤트 이름 af_SKAN_revenue을 매핑하고 이벤트 식별자에 보냅니다.
  3. 설정 저장
  4. 포스트백에서 전송 전환 가치 = 7.
  5. 앱스플라이어는 다음과 같이 응답합니다:
    • 인스톨 포스트백
    • af_SKAN_revenue 이벤트의 3개 포스트백

통합 단계

담당자 액션
애드 네트워크 SKAN 네트워크 ID(Apple에서 제공) 및 SKAN 포스트백 템플릿을 포스트백 관리 플랫폼에 설정합니다. 문의사항이 있거나 지원이 필요한 경우 파트너 지원 위젯을 사용하여 문의하십시오.
애드 네트워크
  1. 테스트 앱을 활성화합니다.
  2. 각 앱에 대해 이전 표의 지침 열을 완료합니다. 
  3. 앞의 표에 나열된 테스트 앱을 사용하여 시뮬레이션된 포스트백을 보냅니다. 시뮬레이션된 포스트백을 보낼 때의 고려 사항:
    • app_id 및 변환 값을 앞의 표에 나열된 대로 설정합니다. 
    • 광고 네트워크는 Apple 호환 서명을 생성할 수 없으므로 시뮬레이션된 포스트백에 서명 필드를 포함할 필요가 없습니다. 앱스플라이어는 시뮬레이션된 포스트백에 대해 이를 확인하지 않습니다.
    • 광고 네트워크는 포스트 또는 리디렉션 접근 방식을 사용하여 포스트백을 보냅니다.
앱스플라이어 통합 중에 광고 네트워크에서 지정한 엔드포인트에 대한 디코딩된 포스트백으로 응답합니다.

테스트 기준

담당자 액션
앱스플라이어 포스트백을 처리하고 광고 네트워크에 포스트백을 보냅니다.
애드 네트워크
  • 광고 네트워크는 번역된 포스트백을 수신하고 디코딩합니다.
  • 앱스플라이어에서 보낸 인앱 포스트백은 예상 흐름과 일치합니다. 예를 들어 앱 ID888707087의 전환 값이 3인 경우 광고 네트워크는af_SKAN_revenue 이벤트의 포스트백을 3회 수신합니다. 

규명

필수 필드, 강화, 인증 등과 관련된 설명.

자주 하는 질문

포스트백에 대한 질문과 대답

보강 필드는 필수인가요? 

현재로서는 다음 보강 매개 변수 중 하나 이상이 누락된 경우에도 포스트백을 처리합니다. 다음과 같은 이유로 정보가 필요합니다. 

  • 광고 네트워크 캠페인ID: 비용 통합이 있는 경우 캠페인 ID를 사용하여 보고됩니다.  
  • 광고 네트워크 캠페인 이름: 많은 광고주가 캠페인 번호가 아닌 캠페인 이름과 관련이 있습니다. 
  • IP 주소: 지역 확인에 필요합니다. 
  • 타임스탬프: 설치를 올바른 날짜로 표시하는 데 도움이 됩니다. 

캠페인 ID 또는 캠페인 이름 중 하나만 보낼 수 있습니까?

이전 답변을 참조하십시오. ID와 이름을 모두 동일한 값으로 채우는 것이 좋습니다. 

우리는 보강 및 전달을 사용하고 있습니다. 앱스플라이어 사양에 없는 키-값 페어를 추가할 수 있나요? 

예, 가능합니다. 당사는 포스트백을 처리하고 저작자 표시 서명이 유효한 경우 추가 정보를 무시합니다.

SKAN 포스트백 템플릿은 기존 포스트백 템플릿과 다릅니까?

네. 흐름과 구조가 다릅니다.

동일한 인스톨과 관련된 SKAN 포스트백 및 확률적/결정론적 모델링 포스트백을 받게 되면 이는 동일한 인스톨에 대한 중복 리포트를 의미합니까?

네. 각각의 경우에 대해 방법에 관계없이 귀하에게 귀속된 설치를 기록하고 포스트백을 보내드립니다.

attribution_source를 사용하여 SKAN 포스트백을 구분합니다.

앱스플라이어의 포스트백을 처리해야 하나요?

아니요. 모범 사례는 포스트백을 통해 보고된 사용자 품질에 따라 캠페인을 최적화하는 것입니다. 

앱스플라이어 어트리뷰션 링크를 호출해야 합니까, 아니면 SKAN 페이로드 및 보강된 데이터와 함께 포스트백을 전송하는 것으로 충분합니까?

SKAN 페이로드와 보강된 데이터를 보내는 것으로 충분합니다.

앱스플라이어 대시보드에서 SKAN 연동 파트너로 인증을 받기 위해 필요한 것은 무엇입니까?

  • 이 문서에 나열된 방법 중 하나를 사용하여 완전한 통합
  • 앱스플라이어를 어트리뷰션 파트너로 사용하는 앱의 포스트백 보내기

100개의 SKAN 캠페인 ID 제한은 어떤 영향을 미칩니까

1-100까지 제한은 Apple에서 캠페인에 서명하고 번호를 매기는 방법과 관련됩니다. 즉, 언제든지 100개의 동시 고유 캠페인을 가질 수 있습니다. 실제 캠페인 이름과 ID로 포스트백을 보강할 수 있습니다. 즉, SKAN 캠페인 ID를 포스트백이 수신되는 시점에 사용 중인 실제 캠페인 ID에 매핑합니다. 이렇게 하는 것은 물론 특정 앱에 대해 동시에 100개 이상의 캠페인을 수행하지 않는 한 앱플라이어에서 측정하는 캠페인의 수를 제한하지 않는다는 것을 의미합니다.