Adjust 어트리뷰션 채널 이름이 Unattributed로 표시되는 문제
배경
2025년 6월 17일 Meta가 AMM을 다시 활성화하여, Meta의 AMM 약관에 동의하고 서명해야 meta 원본 데이터를 가져올 수 있습니다. AMM 약관에 서명하지 않으면 Adjust 원본 데이터의 meta 채널 정보가 Unattributed로 반환되며, campaign 등 광고 상세 데이터도 포함되지 않습니다.
Android에서 Facebook 광고를 클릭하여 설치한 일부 유저의 원본 어트리뷰션 정보를 계속 가져오려면 새로운 플레이스홀더 세트를 사용해야 합니다. 이는 Facebook이 새로 도입한 데이터 전송 메커니즘입니다.
해결 단계
1. Adjust 측 설정
1. 클라이언트 설정
GPIR
GPIR을 활성화하려면 Google Play Install Referrer를 설정해야 합니다.
MIR
MIR 플러그인을 활성화하려면 Adjust Android SDK를 v5로 업데이트하고 Meta install referrer 플러그인을 설정해야 합니다.
2. Adjust Facebook 모듈에 Facebook의 Decryption Key 추가
이제 Facebook developer account (https://developers.facebook.com/) (Dashboard > Settings > Basic > Android (Google Play) Install Referrer Decryption Key)에서 Decryption Key를 가져올 수 있습니다. 각 Decryption Key는 하나의 고유한 Facebook App ID에 대응합니다. 이 값은 앱 데이터의 출처를 가져오는 데 핵심이므로 Adjust 대시보드(해당 Android 앱의 App settings > Partner setup > Facebook)에 추가하십시오
3. 콜백 주소에 플레이스홀더 추가
다음은 이 해결 방법에서 앱 데이터를 가져오는 데 사용하는 새 플레이스홀더입니다. 현재 설치 활동 콜백에 이러한 플레이스홀더를 추가하는 것을 지원하며, 향후 다른 활동으로 확대할 예정입니다. 현재로서는 {adid} 또는 기타 내부 ID로 설치 및 설치 후 이벤트 데이터를 매핑하는 것을 권장합니다.
| 플레이스홀더 | 설명 |
|---|---|
| {fb_install_referrer} | fb Install Referrer의 디코딩된 전체 내용. |
| {fb_install_referrer_campaign_group_name} | fb Install Referrer 전체 내용의 "campaign_group_name" 값. |
| {fb_install_referrer_campaign_group_id} | fb Install Referrer 전체 내용의 "campaign_group_id" 값. |
| {fb_install_referrer_campaign_name} | fb Install Referrer 전체 내용의 "campaign_name" 값. |
| {fb_install_referrer_campaign_id} | fb Install Referrer 전체 내용의 "campaign_id" 값. |
| {fb_install_referrer_adgroup_id} | fb Install Referrer 전체 내용의 "adgroup_id" 값. |
| {fb_install_referrer_adgroup_name} | fb Install Referrer 전체 내용의 "adgroup_name" 값. |
| {fb_install_referrer_ad_id} | fb Install Referrer 전체 내용의 "ad_id" 값. |
| {fb_install_referrer_account_id} | fb Install Referrer 전체 내용의 "account_id" 값. |
| {fb_install_referrer_ad_objective_name} | fb Install Referrer 전체 내용의 "ad_objective_name" 값. |
| {fb_install_referrer_publisher_platform} | fb Install Referrer 전체 내용의 "publisher_platform" 값. |
| 플레이스홀더 | 설명 |
|---|---|
| {meta_install_referrer} | Meta Install Referrer의 디코딩된 전체 내용. |
| {meta_install_referrer_campaign_group_name} | Meta Install Referrer 전체 내용의 "campaign_group_name" 값. |
| {meta_install_referrer_campaign_group_id} | Meta Install Referrer 전체 내용의 "campaign_group_id" 값. |
| {meta_install_referrer_campaign_name} | Meta Install Referrer 전체 내용의 "campaign_name" 값. |
| {meta_install_referrer_campaign_id} | Meta Install Referrer 전체 내용의 "campaign_id" 값. |
| {meta_install_referrer_adgroup_id} | Meta Install Referrer 전체 내용의 "adgroup_id" 값. |
| {meta_install_referrer_adgroup_name} | Meta Install Referrer 전체 내용의 "adgroup_name" 값. |
| {meta_install_referrer_ad_id} | Meta Install Referrer 전체 내용의 "ad_id" 값. |
| {meta_install_referrer_account_id} | Meta Install Referrer 전체 내용의 "account_id" 값. |
| {meta_install_referrer_ad_objective_name} | Meta Install Referrer 전체 내용의 "ad_objective_name" 값. |
| {meta_install_referrer_publisher_platform} | Meta Install Referrer 전체 내용의 "publisher_platform" 값. |
| {meta_install_referrer_is_click} | 상호작용 유형이 클릭인지 여부. 상호작용이 클릭이면 값은 1이고, 그렇지 않으면 0입니다. |
| {meta_install_referrer_actual_timestamp} | Meta install referrer 전체 내용에서 가져온 Unix 타임스탬프 형식의 "actual_timestamp" 값. |
#AE로 콜백된 후의 데이터 참고
"fb_install_referrer":
"{
"ad_id":1234567890123,
"ad_objective_name":"APP_INSTALLS",
"adgroup_id":1234567890124,
"adgroup_name":"your_adgroup_name",
"campaign_id":1234567890125,
"campaign_name":"your_campaign_name",
"campaign_group_id":1234567890126,
"campaign_group_name":"your_campaign_group_name",
"account_id":1234567890,
"is_instagram":false,
"publisher_platform":"facebook",
"platform_position":null
}"
2. AE 백엔드 설정
adjust 실시간 콜백 계획에서 유저 속성 저장 규칙 설정
AE 백엔드의 서드파티 통합에서 저장 설정의 유저 속성 저장 규칙에 있는 규칙 설정을 클릭하여 해당 설정 규칙을 추가합니다. 예: fb_install_referrer.publisher_platform을 대상 속성명 fb_network_name에 매핑합니다(원래 기본 필드인 network_name과 구분해야 합니다. 그렇지 않으면 최종적으로 저장되는 값은 여전히 Unattributed입니다)
그다음 가상 속성을 새로 만들어 두 채널 필드를 판단하여 통합합니다(다른 어트리뷰션 필드도 마찬가지입니다)
#"#adjust_network_name" ='Unattributed'이면 "fb_network_name"을, 그렇지 않으면 "#adjust_network_name"을 사용
if("#adjust_network_name" ='Unattributed' ,"fb_network_name" ,"#adjust_network_name")
주의 1:
설정 시 플레이스홀더가 fb_install_referrer인지, fb_install_referrer_ad_id인지, 아니면 둘 다인지 구분해야 합니다:
1. fb_install_referrer만 있는 경우 AE 백엔드에서는 fb_install_referrer.ad_id 2단계 필드를 기준으로 설정합니다
2. fb_install_referrer_ad_id만 있는 경우 AE 백엔드에서는 fb_install_referrer_ad_id를 그대로 사용하여 매핑을 설정합니다
주의 2:
설정 후 백엔드에 fb 관련 속성이 저장되지 않는 경우의 조사 방법: 먼저 데이터 수신 receiver 로그에서 해당 필드를 확인할 수 있는지 봅니다. 없으면 --> Install Referrer Decryption Key를 가져왔는지, 그리고 해당 Facebook App ID와 대응하는지 확인합니다