광고 네트워크에 대한 Advanced Privacy 안내서 및 포스트백 매크로

요약: Advanced Privacy가 활성화된 경우 파트너와 데이터 공유를 수행할 수 있습니다. Advanced Privacy 포스트백 설정에 대한 광고 네트워크의 지침. 일러두기! 이 문서는 SKAdNetwork 포스트백과 관련이 없으며 광고주들이 사용하기 위한 것도 아닙니다. 

광고 네트워크 뉴스에 대한 Advanced Privacy

이 문서에서 설명하는 Advanced Privacy 포스트백 메커니즘은 다음 사항이 모두 충족되는 경우에 작동합니다.

  • 사용자 기기는 iOS 14.5 이상입니다.
  • Advanced Privacy가 설정되어 있습니다.

AdvancedPrivacy.png

본 문서에서는 다음을 논의합니다. 

광고 네트워크 Advanced Privacy 데이터 공유 원칙

iOS 14.5 이상에서 시작하여 앱스플라이어 집약형 프라이버시 강화 프레임워크(AAP)는 앱스플라이어 플랫폼을 통해 제공되는 사용자 수준 어트리뷰션 데이터의 가용성을 제어하는 기능을 광고주에게 제공합니다. 

광고 네트워크의 맥락에서 AAP 프레임워크는 AP(Advanced Privacy)를 사용하여 구현됩니다. 쉽게 이해할 수 있도록, 이 문서에서는 Advanced Privacy 및 AP라는 용어가 상호 교환적으로 사용됩니다. 

AP는 파트너 또는 광고 네트워크에 사용할 수 있는 집약형 데이터의 가용성에 영향을 주지 않습니다.  

AP의 영향을 받는 데이터

AP가 켜져 있을 때, iOS 14.5 이상을 실행하는 비동의 사용자에 대한 사용자 수준 데이터는 포스트백 또는 Protect360 사기 관련 리포트를 포함한 다른 리포팅 방법에서는 이용할 수 없습니다.

포스트백의 경우, 이는 사용자의 ATT 동의 상태 및 다른 인자에 따라 상이한 유형의 포스트백이 사용된다는 것을 의미합니다. 

앱스플라이어 대시보드에서 앱별로 현재 AP 설정을 볼 수 있습니다. 설정 > 연동 파트너 > 광고 네트워크 선택 > 연동 탭으로 이동하십시오. 기본 설정은 켜기입니다. 

APforPartners2.png

Advanced Privacy 연동에 필요한 포스트백 유형은 다음과 같습니다.

  • 일반: 앱스플라이어를 통한 기존 연동 템플릿. 사용자 식별자 및 어트리뷰트-데이터 매크로를 포함합니다.
  • Advanced Privacy: 사용자 식별자 매크로가 없는 템플릿. AP 포스트백이 필요하고 AP 연동을 완료하지 않은 경우에는 포스트백이 전송되지 않습니다. 셀프 서비스 포스트백 관리 도구를 사용하여 AP 연동을 설정할 수 있습니다.

일러두기! 사용자가 광고주 및 퍼블리셔("이중 동의") 모두의 앱에서 ATT 동의를 제공하는 경우, 일반 포스트백이 사용됩니다.

사용된 포스트백 유형 

다음 표는 iOS 14.5 이상을 실행하는 사용자의 데이터에 적용할 수 있습니다.

일러두기! 사용자의 iOS 버전이 14.4 또는 그 이전 버전인 경우에는 이 테이블을 적용할 수 없으며 일반 포스트백이 전송됩니다. 

AP 상태

ATT 상태 AP를 지원하는 어트리뷰트 파트너*에 대한 백엔드 템플릿 유형  AP를 지원하지 않는 어트리뷰트 파트너*에 대한 백엔드 템플릿 유형   어트리뷰트 해제된 포스트백 파트너*

퍼블리셔 앱

광고주 앱

켜기

승인됨

승인되지 않음

AP 템플릿

포스트백 없음

없음

켜기

승인되지 않음

승인됨

AP 템플릿

포스트백 없음

일반 템플릿. 어트리뷰션 필드 를 사용할 수 없습니다.*

켜기

승인됨

승인됨

일반 템플릿. 여기에는 IDFA, IDFV, CUID, 클릭 ID 및 어트리뷰션 필드와 같은 사용 가능한 ID가 포함됩니다. 

일반 템플릿. 여기에는 IDFA, IDFV, CUID, 클릭 ID 및 어트리뷰션 필드와 같은 사용 가능한 ID가 포함됩니다.  사용 가능한 ID를 포함하는 일반 템플릿. 어트리뷰션 필드를 사용할 수 없습니다.*

켜기

승인되지 않음

승인되지 않음

AP 템플릿

포스트백 없음

없음

끄기

고려 안 됨

고려 안 됨

일반

일반

일반 템플릿. 어트리뷰션 필드 를 사용할 수 없습니다.*

iOS 14.5 이상에 대한 포스트백 유형

(*) 파트너와의 데이터 공유에 대한 원칙

지정된 임의의 이벤트에 대해, 다수의 광고 네트워크 파트너들은 포스트백을 가질 자격이 있습니다. 발송된 포스트백은 다음과 같습니다.

  • 어트리뷰트 파트너: 이벤트에 기여한 광고 네트워크
  • 어트리뷰트 해제 파트너: 인앱이벤트 포스트백 > 보내기 옵션오가닉을 포함한 모든 미디어소스로 설정된 경우 이벤트로 대변되지 않는 연동 파트너. 만약 광고주 앱이 ATT 동의를 갖는다면, 포스트백은 어트리뷰트 데이터가 없는 사용자 ID를 포함합니다. (이 옵션은 모든 광고 네트워크에서 지원되지 않습니다.)

    InAppEventAll.png

웹 캠페인

광고 네트워크가 웹상에서 광고를 제공하는 경우, AP는 다른 방식으로 작동합니다.

웹 또는 앱에서 클릭이 발생했는지 여부를 표시하려면 클릭 URL에서 af_media_type=web 또는 af_media_type=app 파라미터를 전송해야 합니다.

af_media_type을 보내지 않으면 기본 설정은 app입니다.

ATT 상태 어트리뷰트 참여자에 대한 포스트백 유형* 어트리뷰트 해제 참여자에 대한 포스트백 유형*

퍼블리셔 앱

광고주 앱

N/A

승인되지 않음

프라이버시 강화 모드

없음

N/A

승인됨

일반. 다음 ID를 가진 사용자 수준: IDFA, IDFV, CUID, 클릭 ID.

일반. 사용자 수준 ID 전용.

AP가 켜져 있을 때 iOS 14.5 이상에 사용되는 포스트백 유형

연동

클릭 URL을 업데이트하고 Advanced Privacy 연동을 완료하십시오.

클릭 URL 요구 사항

많은 경우에, IDFA는 사용자 ATT 동의에 의존하여, 퍼블리셔 앱, 광고주 앱 또는 둘 다 모두에서 이용할 수 없을 것입니다. 이런 경우 앱스플라이어는 집약형 Advanced Privacy확률적 모델링을 사용하여 어트리뷰션을 수행할 수 있습니다.

[모범 사례] 어트리뷰트를 최대화하기 위해 기재한 모든 파라미터를 전송합니다.

  1. 다음 파라미터를 클릭 URL에 추가합니다.
    식별자 클릭 파라미터

    캠페인

    c

    US_20_30

    캠페인 ID

    af_c_id

    12345

    광고세트

    af_adset

    ADSET_1

    광고세트 ID

    af_adset_id

    56789

    광고 

    af_ad

    creative_name

    광고 아이디

    af_ad_id

    34567

    사이트 ID

    af_siteid

    abcdefgh12345678

    하위 사이트 ID

    af_sub_siteid

    abcdefgh12345678

    채널

    af_channel

    channel_name

    광고 유형

    af_ad_type

    video

    iOS 기기 모델*

    af_model

    기기 모델. 허용된 값:

    • 아이폰(모든 소문자)
    • ipad(모든 소문자)

    운영 체제*

    af_os

    운영 체제 버전

    * 일부 정보는 사용자 에이전트를 통해 제공될 수도 있습니다. 이 경우 특정 식별자를 사용하여 전송된 값이 우선합니다.


    클릭 URL에 캠페인 세부사항 추가

    다음 예제는 클릭 URL에 캠페인 상세 정보를 추가하는 방법을 보여줍니다.

    https://app.appsflyer.com/id123456789?pid=YOUR_NETWORK_ID&c={CampaignName}&af_c_id={CampaignID}&af_adset={adset name}&af_adset_id={adset ID}&af_ad={ad name}&af_ad_id={ad ID}&af_ad_type={Ad type}&af_siteid={PublisherId}
  2. 다음 필수 파라미터를 클릭 URL에 추가합니다.*

     주의

    클릭 URL이 필수 파라미터를 전달하지 않는 경우, 유도하는 대부분의 인스톨로 인정되지 않습니다.

    • IP 
    • 사용자-에이전트 

    * 앱스플라이어로 경로를 리디렉트하는 단순 HTTP 리퍼러를 사용하여 클릭을 전송할 때 조치가 필요하지 않습니다. 

    다음 방법 중 하나를 사용할 때 클릭 URL에 파라미터를 추가하는 데 설명된 추출 방법을 사용하십시오. 

    • 인앱을 통한 리디렉트 
    • 서버 간 클릭(일명, S2S) 

    파라미터

    필수

    추출 방법

    기기 언어 및 로케일

    af_lang

    아니오.

    NSString *language = [[NSLocale preferredLanguages] objectAtIndex:0];

    [권장] 언어 및 로케일을 제공하십시오. 예: en-US).

    사용자-에이전트

    af_ua

    다음 형식으로 사용자-에이전트를 추출합니다.

    Mozilla%2F5.0+%28iPhone%3B+CPU+iPhone+OS+13_3_1
    +like+Mac+OS+X%29 AppleWebKit%2F605.1.15+%28KHTML%2C
    +like+Gecko%29+Mobile%2F15E148
    • CFNetwork 사용자 에이전트를 추출하지 마십시오. 다른 사용자 에이전트를 추출하십시오.  
    • 사용자 에이전트는 URL로 인코딩되어야 합니다.

    기기 IP 주소

    af_ip

    최상의 옵션: 사용 가능한 경우, 기기 IP를 af_ip 파라미터 아래에 제공하십시오.

    다음 옵션: 사용 가능한 경우, 앱스플라이어는 X-Forwarded-For의 IP를 사용합니다.

     Advanced Privacy 어트리뷰션용 파라미터


    클릭 URL에 파라미터 추가

    이러한 필수 파라미터를 클릭 어트리뷰션 링크에 전달하려면 다음 참조를 사용하십시오. 

    https://app.appsflyer.com/id123456789?pid=YOUR_NETWORK_ID&c={CampaignName}&af_c_id={CampaignID}&af_adset={adset name}&af_adset_id={adset ID}&af_ad={ad name}&af_ad_id={ad ID}&af_ad_type={Ad-type}&af_siteid={PublisherId}&af_ua={USER-AGENT}&af_lang={LANGUAGE}&af_ip={IP}

    GET https://app.appsflyer.com/id123456789?pid=YOUR_NETWORK_ID&c={CampaignName}&af_c_id={CampaignID}&af_adset={adset name}&af_adset_id={adset ID}&af_ad={ad name}&af_ad_id={ad ID}
    &af_ad_type={Ad type}&af_siteid={PublisherId}

    &af_ua=Mozilla%2F5.0%20%28iPhone%3B%20CPU%20iPhone%20OS%2012_1_4%20
    like%20Mac%20OS%20X%29%20AppleWebKit%

    2F605.1.15%20%28KHTML%2C%20like%20Gecko%29%20Mobile%2F16D57&af_lang=en-US&af_ip=11.11.1.11

    * 쿼리 파라미터는 URL로 인코딩되어야 합니다.

    데이터를 클릭 URL 헤더에 전달하기

    클릭 URL 헤더의 필드를 전달하려면 다음 참조를 사용하십시오.

    GET https://app.appsflyer.com/id123456789?pid=YOUR_NETWORK_ID&c={CampaignName}&af_c_id={CampaignID}&af_adset={adset name}&af_adset_id={adset ID}&af_ad={ad name}&af_ad_id={ad ID}&af_ad_type={Ad type}&af_siteid={PublisherId}

    accept-language: en-US,en;q=0.

    사용자-에이전트: Mozilla/5.0 (iPhone; Mac OS X와 같은 CPU iPhone OS 13_5_1)

    AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148

    X-Forwarded-For: 11.11.1.11, 222.222.2.222

Advanced Privacy 포스트백 사양

Advanced Privacy 포스트백을 수신하려면 일반 포스트백 연동 외에 Advanced Privacy 연동을 설정해야 합니다. 앱스플라이어 대시보드에서 Advanced Privacy 포스트백을 직접 설정할 수 있습니다.

일반 템플릿과 Advanced Privacy 템플릿 간의 차이

  • 포스트백은 시간당 배치 형태로 전송됩니다.
    • 배치에는 모든 이벤트 유형이 포함됩니다.
    • 포스트백의 0.001%는 다음 배치로 전송될 수 있으며 최대 24시간까지 지연될 수 있습니다.
  • 포스트백 시간은 실제 이벤트 시간과 상관관계가 없습니다.
  • 타임스탬프 매크로:
    • 인스톨 및 인앱이벤트의 경우 타임스탬프는 발생한 시간으로 반올림됩니다. 예를 들어, 22:55:30은 22:00:00으로 리포트됩니다.
    • UTC 시간대를 사용하여 리포트됩니다. 예제 타임스탬프: (2020-07-20 20:00:00)
  • 다음 파라미터는 Advanced Privacy 포스트백에서 사용할 수 없습니다. 클릭 ID, 고객 사용자 ID, 앱스플라이어 ID, IDFA, IDFV, 기기 모델, OS 버전, 캐리어.

연동할 광고 네트워크에 필요한 조치:

  1. 앱스플라이어 대시보드에서 Advanced Privacy 포스트백을 설정합니다. 
  2. Advanced Privacy 연동 테스트.
포스트백 유형
인스톨
인앱
Advanced Privacy 포스트백 엔드포인트 [필요에 따라 완료]

포스트백 매크로(이름)

설명 모든 포스트백의 기본 파라미터 인앱이벤트에 대한 선택적 파라미터  거부된 어트리뷰션에 대한 선택적 파라미터
af_ad 광고소재 이름    
af_ad_id 34567    
af_ad_type 예를 들면: 배너, 바닥글, 비디오    
af_adset ADSET_1    
af_adset_id 56789    
app_id -    
app_name -    
attributed_touch_hour

가장 가까운 시간으로 반내림. 

형식 보기(1)

   
attributed_touch_type 예: 클릭, 노출    
blocked_reason 유효성 검증 규칙/Protect360과 관련됨    
blocked_reason_value 유효성 검증 규칙/Protect360과 관련됨    
blocked_sub_reason 유효성 검증 규칙/Protect360과 관련됨    
bundle_id 광고주에 의해 설정된 것과 같음    
c 캠페인 이름, 예를 들면 US_20_30    
af_c_id 캠페인 ID, 예를 들면 12345    
af_channel 채널명    
country_code 전환 시에 기록된 ISO 국가 코드    
event_hour

가장 가까운 시간으로 반내림. 

형식 보기(1)

   
event_name 앱에 의해 리포트된 바와 같음    
event_revenue 이벤트 통화 단위 수익 금액    
event_revenue_
currency
수익 통화 코드    
event_revenue_usd USD로 전환된 수익    
install_hour

가장 가까운 시간으로 반내림. 

형식: 일러두기 (1) 참조

   
is_first 특정 말단 사용자가 이 앱에서 처음으로 이 이벤트를 트리거한 경우 참    
is_primary

중복 제거에 사용

부울: 0, 1

   
is_retargeting

중복 제거에 사용 

형식: 일러두기 (2) 참조

   
is_reengagement

형식: 일러두기 (2) 참조

   
is_reattribution

중복 제거에 사용 

형식: 일러두기 (2) 참조

   
match_type 예: id_matching, probabilistic    
event_id 광고 네트워크 플랫폼에서 해당 이벤트의 이름/ID    
platform 예: iOS, 안드로이드    
postback_id 고유한 포스트백 ID    
retargeting_
conversion_type
예: 리인게이지먼트, 리어트리뷰션    
af_siteid abcdefgh12345678    
af_sub_siteid abcdefgh12345678    

일러두기:

(1) 사용 가능한 타임스탬프 형식:

  • [기본 설정] 문자열: YYYY-MM-DD HH:MM: SS
  • 에포크 시간: 10자리 Unix 타임스탬프 

(2) 사용 가능한 부울 형식

  • [기본값] 숫자: 0, 1 
  • 문자열: false, true
사용 가능한 Advanced Privacy 어트리뷰션 매크로

Advanced Privacy 포스트백 설정

앱스플라이어 대시보드에서 포스트백 관리 옵션을 사용하여 AP 포스트백 설정.

선행 조건:

  • Advanced Privacy 포스트백을 관리하려면 앱스플라이어와의 활성 연동이 있어야 합니다. integrations@appsflyer.com에 문의하여 연동을 작성하십시오.
  • AppsFlyerAdmin_us-en.png 포스트백 관리는 계정 관리자가 수행합니다. 팀 구성원은 액세스 권한이 없습니다.

포스트백 설정 방법:

  1. 오른쪽 맨 위 드롭다운 메뉴 > 포스트백 관리를 클릭합니다.
  2. 포스트백 유형을 선택합니다. Advanced Privacy. 
  3. 빌더를 활성화합니다.

    postback-management-enter-endpoint_en-us.png

  4. 엔드포인트 주소를 입력합니다. 앱스플라이어가 포스트백을 전송하는 엔드포인트 URL. 설치 및/또는 인앱이벤트에 대한 해당 URL을 입력합니다.
  5. 다음과 같이 포스트백에 포함할 파라미터를 입력합니다.
    • 파라미터 이름: 앱스플라이어 파라미터 화면 이름
    • 수신 파라미터: 사용자가 받는 각각의 수신 파라미터
    • 파라미터 값(일부 파라미터에 사용 가능): 값 형식을 선택합니다. 예를 들어, 부울 값의 경우 "true"/"false" 또는 1/0으로 값을 수신할지 여부를 선택합니다.
    • 인스톨: 인스톨 포스트백에 파라미터를 포함하도록 상자를 선택합니다.
    • 인앱이벤트: 인앱이벤트 포스트백에 파라미터를 포함하도록 상자를 선택합니다.

    postback-management-parameters_en-us.png

    Advanced Privacy 포스트백 매크로의 전체 목록.

  6. [선택사항] 앱스플라이어에서 제공하지 않는 사용자정의 파라미터를 추가합니다.

    postback-management-custom-parameters_en-us.png

  7. 최종 포스트백 템플릿 미리보기를 확인하여 모든 것이 올바른지 확인하십시오.

    postback-management-template_en-us.png

  8. 저장을 클릭합니다. 포스트백을 저장하면 변경사항이 즉시 적용된다는 점을 알아두십시오.

문제가 발생한 경우 integrations@appsflyer.com으로 문의하십시오.

추가 정보

분석 파트너용 AP

다음과 같이 포스트백이 분석 파트너에게 전송됩니다.

  • AP 끄기: 제한 없는 사용자 수준 포스트백.
  • AP 켜기: 이 테이블에 자세히 설명한 것처럼 사용자 소스 및 ATT 상태에 따름. 

사용자 소스

ATT 상태 분석 파트너에 대한 포스트백 유형

퍼블리셔 앱

 광고주 앱

논오가닉 


 


 

승인됨

승인됨

일반

승인되지 않음

승인됨

없음

모든 값

승인되지 않음

없음

오가닉 또는 웹

N/A

승인됨

일반

오가닉 또는 웹

N/A

승인되지 않음

없음
ATT 상태 및 사용자 소스에 따른 분석 파트너 포스트백 유형

AP 대 SKAdNetwork

SKAdNetwork는 iOS 기기에 대해 Apple에서 제공하는 어트리뷰션 기술입니다. Advanced Privacy는 앱스플라이어의 집계된 Advanced Privacy(AAP) 프레임워크의 일부이며 앱스플라이어가 수행한 어트리뷰션과 관련되어 있습니다. AAP는 앱스플라이어 플랫폼을 통해 사용자 수준 어트리뷰션 데이터의 가용성을 제어하는 기능을 광고주에게 제공합니다. 전형적으로, 광고 네트워크들은 AP 및 SKAdNewtork 통합을 모두 지원합니다. 

도움이 되었습니까?