광고 네트워크 뉴스에 대한 Advanced Privacy
이 문서에서 설명하는 Advanced Privacy 포스트백 메커니즘은 다음 사항이 모두 충족되는 경우에 작동합니다.
- 사용자 기기는 iOS 14.5 이상입니다.
- Advanced Privacy가 설정되어 있습니다.
본 문서에서는 다음을 논의합니다.
- 파트너에 대한 Advanced Privacy 데이터 공유의 영향
- 어트리뷰션 자격을 가지려면 URL 요구 사항을 클릭하십시오.
- 앱스플라이어 대시보드에서 Advanced Privacy 포스트백 설정
- Advanced Privacy 및 SKAdNetwork사이의 차이.
광고 네트워크 Advanced Privacy 데이터 공유 원칙
iOS 14.5 이상부터 앱스플라이어 집약형 프라이버시 강화 프레임워크(AAP)는 앱스플라이어 플랫폼을 통해 제공되는 사용자 수준 어트리뷰션 데이터의 가용성을 제어하는 기능을 광고주에게 제공합니다.
광고 네트워크의 맥락에서 AAP 프레임워크는 AP(Advanced Privacy)를 사용하여 구현됩니다. 쉽게 이해할 수 있도록, 이 문서에서는 Advanced Privacy 및 AP라는 용어가 상호 교환적으로 사용됩니다.
AP는 파트너 또는 광고 네트워크에 사용할 수 있는 집약형 데이터의 가용성에 영향을 주지 않습니다.
AP의 영향을 받는 데이터
AP가 켜져 있을 때, iOS 14.5 이상을 실행하는 비동의 사용자에 대한 사용자 수준 데이터는 포스트백 또는 Protect360 사기 관련 리포트를 포함한 다른 리포팅 방법에서는 이용할 수 없습니다.
포스트백의 경우, 이는 사용자의 ATT 동의 상태 및 다른 인자에 따라 상이한 유형의 포스트백이 사용된다는 것을 의미합니다.
앱별로 현재 AP 설정을 볼 수 있습니다. 앱스플라이어의 사이드 메뉴에서 콜라보레이트 > 활성 연동 > 광고 네트워크 > 연동 탭을 선택합니다. 기본 설정은 켜기입니다.
포스트백을 보내기 위한 템플릿의 종류
- 일반 템플릿: 유저 식별자 및 어트리뷰트-데이터 매크로를 포함해 앱스플라이어와 함께 제공되는 기존 연동 템플릿. 를 포함합니다. 이 템플릿은 유저 수준 어트리뷰션 데이터가 포함된 포스트백을 보내는 데 사용됩니다.
- 고급 개인정보 보호 템플릿: 유저 식별자 매크로가 없는 템플릿입니다. 이 템플릿은 집약된 어트리뷰션 데이터가 포함된 포스트백을 보내는 데 사용됩니다.
참고: AP 포스트백이 필요하고 AP 통합을 완료하지 않은 경우 포스트백이 전송되지 않습니다. 셀프 서비스 포스트백 관리 도구를 사용하여 AP 연동을 설정할 수 있습니다.
참고
- 사용자가 광고주와 퍼블리셔 모두의 앱에서 ATT 동의("이중 동의")를 제공하는 경우, 정기적인 포스트백은 어트리뷰션 광고 및 비어트리뷰션 광고 네트워크로 모두 전송됩니다.
-
예외: ASA(Apple Search Ads)에 어트리뷰션된 인스톨의 경우, ASA는 다음과 같은 조건에서 광고주에 대해 사전 개인 정보 보호가 켜져 있어도 광고 네트워크에 인스톨 포스트백을 보냅니다.
- 사용자가 동의하지 않는 경우
- 광고 네트워크에 포스트백 인스톨이 오가닉을 포함한 모든 미디어소스로 설정된 경우
- 광고 네트워크에서 Advanced Privacy를 지원하지 않는 경우
사용된 포스트백 유형
다음 표는 iOS 14.5 이상을 실행하는 사용자의 데이터에 적용할 수 있습니다.
일러두기! iOS 버전이 14.4 이하라면 아래 표는 해당되지 않습니다. 즉, 일반 템플릿을 사용한 포스트백은 어트리뷰션 광고 네트워크와 비어트리뷰션 광고 네트워크 모두 전송됩니다.
iOS 14.5 이상에 대한 포스트백 유형
AP 상태 |
ATT 상태 | AP를 지원하는 어트리뷰트 파트너*에 대한 백엔드 템플릿 유형 | AP를 지원하지 않는 어트리뷰트 파트너*에 대한 백엔드 템플릿 유형 | 어트리뷰트 해제된 포스트백 파트너* | |
---|---|---|---|---|---|
퍼블리셔 앱 |
광고주 앱 |
||||
켜기 |
승인됨 |
승인되지 않음 |
AP 템플릿(집약된 데이터) |
포스트백 없음 |
없음 |
켜기 |
승인되지 않음 |
승인됨 |
AP 템플릿(집약된 데이터) |
포스트백 없음 |
어트리뷰션 필드 를 사용할 수 없습니다.* |
켜기 |
승인됨 |
승인됨 |
일반 템플릿입니다. 여기에는 IDFA, IDFV, CUID, 클릭 ID 및 어트리뷰션 필드와 같은 사용 가능한 ID가 포함됩니다. |
일반 템플릿입니다. 여기에는 IDFA, IDFV, CUID, 클릭 ID 및 어트리뷰션 필드와 같은 사용 가능한 ID가 포함됩니다. | 사용 가능한 ID를 포함하는 일반 템플릿. 어트리뷰션 필드를 사용할 수 없습니다.* |
켜기 |
승인되지 않음 |
승인되지 않음 |
AP 템플릿(집약된 데이터) |
포스트백 없음 |
없음 |
끄기 |
고려 안 됨 |
고려 안 됨 |
일반 템플릿 |
일반 템플릿입니다. 어트리뷰션 필드 를 사용할 수 없습니다.* |
(*) 파트너와의 데이터 공유에 대한 원칙
지정된 임의의 이벤트에 대해, 다수의 광고 네트워크 파트너들은 포스트백을 가질 자격이 있습니다. 발송된 포스트백은 다음과 같습니다.
- 어트리뷰트 파트너: 이벤트에 기여한 광고 네트워크
- 어트리뷰트 해제 파트너: 인앱이벤트 포스트백 > 보내기 옵션이 오가닉을 포함한 모든 미디어소스로 설정된 경우 이벤트로 대변되지 않는 연동 파트너. 만약 광고주 앱이 ATT 동의를 갖는다면, 포스트백은 어트리뷰트 데이터가 없는 사용자 ID를 포함합니다. (이 옵션은 모든 광고 네트워크에서 지원되지 않습니다.)
웹 캠페인
광고 네트워크가 웹상에서 광고를 제공하는 경우, AP는 다른 방식으로 작동합니다.
웹 또는 앱에서 클릭이 발생했는지 여부를 표시하려면 클릭 URL에서 af_media_type=web
또는 af_media_type=app
파라미터를 전송해야 합니다.
af_media_type
을 보내지 않으면 기본 설정은 app
입니다.
AP가 켜져 있을 때 iOS 14.5 이상에 사용되는 포스트백 유형
ATT 상태 | 어트리뷰트 참여자에 대한 포스트백 유형* | 어트리뷰트 해제 참여자에 대한 포스트백 유형* | |
---|---|---|---|
퍼블리셔 앱 |
광고주 앱 |
||
N/A |
승인되지 않음 |
프라이버시 강화 모드 |
없음 |
N/A |
승인됨 |
일반. 다음 ID를 가진 사용자 수준: IDFA, IDFV, CUID, 클릭 ID. |
일반. 사용자 수준 ID 전용. |
연동
클릭 URL을 업데이트하고 Advanced Privacy 연동을 완료하십시오.
클릭 URL 요구 사항
많은 경우에, IDFA는 사용자 ATT 동의에 의존하여, 퍼블리셔 앱, 광고주 앱 또는 둘 다 모두에서 이용할 수 없을 것입니다. 이런 경우 앱스플라이어는 집약형 Advanced Privacy 및 확률적 모델링을 사용하여 어트리뷰션을 수행할 수 있습니다.
[모범 사례] 어트리뷰트를 최대화하기 위해 기재한 모든 파라미터를 전송합니다.
-
다음 파라미터를 클릭 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}
- 다음 필수 파라미터를 클릭 URL에 추가합니다.*
주의
클릭 URL이 필수 파라미터를 전달하지 않는 경우, 유도하는 대부분의 인스톨로 인정되지 않습니다.
- IP
- 사용자-에이전트
* 앱스플라이어로 경로를 리디렉트하는 단순 HTTP 리퍼러를 사용하여 클릭을 전송할 때 조치가 필요하지 않습니다.
다음 방법 중 하나를 사용할 때 클릭 URL에 파라미터를 추가하는 데 설명된 추출 방법을 사용하십시오.
- 인앱을 통한 리디렉트
- 서버 간 클릭(일명, S2S)
Advanced Privacy 어트리뷰션용 파라미터
파라미터
필수
추출 방법
기기 언어 및 로케일
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를 사용합니다.
클릭 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)
- 다음 파라미터는 프라이버시 강화 포스트백에서 사용할 수 없습니다. 클릭 ID, 고객 사용자 ID, 앱스플라이어 ID, IDFA, IDFV, 기기 모델, OS 버전, 및 캐리어.
연동할 광고 네트워크에 필요한 조치:
중요!
-
합법적인 이벤트에 대한 포스트백과 거부된 포스트백을 구분하려면 거부된 포스트백 매크로를 구성해야 합니다.
- 거부된 인스톨/이벤트 포스트백을 활성화하려면 Partner Assistant 위젯을 사용하여 문의하십시오.
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) 사용 가능한 타임스탬프 형식:
(2) 사용 가능한 부울 형식
|
Advanced Privacy 포스트백 설정
앱스플라이어 대시보드에서 포스트백 관리 옵션을 사용하여 AP 포스트백 설정.
선행 조건:
- Advanced Privacy 포스트백을 관리하려면 앱스플라이어와의 활성 연동이 있어야 합니다. 연동을 생성하려면 Partner Assistant 위젯 을 사용하여 당사에 문의하십시오.
-
포스트백 관리는 계정 관리자가 수행합니다. 팀 구성원은 액세스 권한이 없습니다.
포스트백 설정 방법:
- 상단 표시줄에서 계정 메뉴(이메일 주소 드롭다운) > 포스트백 관리를 엽니다.
- 포스트백 유형을 선택합니다. Advanced Privacy.
- 빌더를 활성화합니다.
- 엔드포인트 주소를 입력합니다. 앱스플라이어가 포스트백을 전송하는 엔드포인트 URL. 설치 및/또는 인앱이벤트에 대한 해당 URL을 입력합니다.
- 다음과 같이 포스트백에 포함할 파라미터를 입력합니다.
- 파라미터 이름: 앱스플라이어 파라미터 화면 이름
- 수신 파라미터: 사용자가 받는 각각의 수신 파라미터
- 파라미터 값(일부 파라미터에 사용 가능): 값 형식을 선택합니다. 예를 들어, 부울 값의 경우 "true"/"false" 또는 1/0으로 값을 수신할지 여부를 선택합니다.
- 인스톨: 인스톨 포스트백에 파라미터를 포함하도록 상자를 선택합니다.
- 인앱이벤트: 인앱이벤트 포스트백에 파라미터를 포함하도록 상자를 선택합니다.
Advanced Privacy 포스트백 매크로의 전체 목록.
-
[선택사항] 앱스플라이어에서 제공하지 않는 사용자정의 파라미터를 추가합니다.
- 최종 포스트백 템플릿 미리보기를 확인하여 모든 것이 올바른지 확인하십시오.
- 저장을 클릭합니다. 포스트백을 저장하면 변경사항이 즉시 적용된다는 점을 알아두십시오.
문제가 있는 경우 Partner Assistant 위젯을 사용하여 당사에 문의하십시오.
추가 정보
분석 파트너용 AP
다음과 같이 포스트백이 분석 파트너에게 전송됩니다.
- AP 끄기: 제한 없는 사용자 수준 포스트백.
- AP 켜기: 이 테이블에 자세히 설명한 것처럼 사용자 소스 및 ATT 상태에 따름.
ATT 상태 및 사용자 소스에 따른 분석 파트너 포스트백 유형
사용자 소스 |
ATT 상태 | 분석 파트너에 대한 포스트백 유형 | |
---|---|---|---|
퍼블리셔 앱 |
광고주 앱 |
||
논오가닉
|
승인됨 |
승인됨 |
일반 |
승인되지 않음 |
승인됨 |
없음 |
|
모든 값 |
승인되지 않음 |
없음 | |
오가닉 또는 웹 |
N/A |
승인됨 |
일반 |
오가닉 또는 웹 |
N/A |
승인되지 않음 |
없음 |
AP 대 SKAdNetwork
SKAdNetwork는 iOS 기기에 대해 Apple에서 제공하는 어트리뷰션 기술입니다. Advanced Privacy는 앱스플라이어의 집계된 Advanced Privacy(AAP) 프레임워크의 일부이며 앱스플라이어가 수행한 어트리뷰션과 관련되어 있습니다. AAP는 앱스플라이어 플랫폼을 통해 사용자 수준 어트리뷰션 데이터의 가용성을 제어하는 기능을 광고주에게 제공합니다. 전형적으로, 광고 네트워크들은 AP 및 SKAdNewtork 통합을 모두 지원합니다.