Android에 대한 Meta 로데이터 리포팅

Meta는 광고주가 설치 리퍼러를 사용하여 Android용 로 데이터를 강화하는 것을 지원합니다. 캠페인 메타데이터는 암호화된 형식으로 설치 리퍼러에 추가됩니다. 메타데이터를 읽으려면 앱에 대해 Meta가 제공한 암호 해독 키를 사용해야 합니다.

로데이터를 강화하기 위해 지원되는 설치 리퍼러는 2가지가 있습니다.

  • Google Play 설치 리퍼러(GPIR)
  • Meta 설치 리퍼러(MIR)

두 설치 리퍼러 모두 Facebook 및 Instagram과 같은 Meta 애플리케이션에서 발생하는 앱 설치에 대한 자세한 정보를 제공합니다.그러나 MIR만이 view-through 어트리뷰션 및 동일하지 않은 세션 click-through 어트리뷰션을지원합니다.

시작에 앞서

시작하기 전에 알아야 할 사항은 다음과 같습니다.

요구 사항

  • 앱에 대한 Meta 해독 키( Meta Decryption Key ).
  • 관리자 및 편집자 권한 이 있는 사용자는 Adjust에서 Meta 인증 정보을 업데이트할 수 있습니다.

GPIR

GPIR을 활성화하려면 Google Play 설치 리퍼러를 구성해야 합니다.

MIR

MIR 플러그인을 활성화하려면, Adjust Android SDK를 V5로 업데이트하고, Meta 설치 리퍼러 플러그인을 구성해야 합니다.

작동 원리

설치 리퍼러 솔루션을 사용하면 사용자의 인앱 활동을 Android에 게시된 해당 사용자 획득의 소스 광고에 연결할 수 있습니다. 이를 통해 캠페인의 성과를 측정하고, 주요 사용자 획득 트렌드를 파악할 수 있습니다.

  1. 사용자가 앱을 설치하면 설치 리퍼러는 설치 소스로부터 리퍼러 콘텐츠를 수집합니다.
  2. Meta는 설치 리퍼러의 API를 사용하여 암호화된 데이터를 공유합니다.
  3. Adjust는 해당 데이터를 추출한 뒤, Meta 해독 키를 사용하여 암호를 해독합니다.

해독된 데이터 문자열은 다음과 같은 형태입니다.

{
"ad_id":"12345",
"ad_objective_name":"APP_INSTALL",
"adgroup_id":"54321",
"adgroup_name":"Test Ad Group",
"campaign_id":"987654",
"campaign_name":"Test Campaign",
"campaign_group_id":"654321",
"campaign_group_name":"Test Campaign Group",
"account_id":"444444",
"publisher_platform":"Test Publisher Platform",
}

플레이스홀더를 사용하여 로데이터 내보내기에서 해독된 데이터를 수집할 수 있습니다.

팁:
GPIR과 MIR을 모두 활성화하면 로데이터 내보내기에서 두 소스로부터의 정보를 받게 됩니다. Adjust는 Datascape에서 GPIR과 MIR 정보만 중복 제거합니다. Adjust는 일반적으로 GPIR을 우선시하는 것을 권장합니다.

공유되지 않는 데이터는 무엇인가요?

Meta는 기기 ID를 전송하지 않습니다.

다음의 데이터 포인트는 MIR을 사용하는 경우에만 이용 가능합니다.

  • 뷰쓰루(View-through) 전환
  • Google Play Android 외 앱 스토어(예: Galaxy Store 및 Amazon Appstore)로부터의 앱 이벤트.

설치 리퍼러 설정

설치 리퍼러 솔루션을 설정하고, Meta로부터 특정 캠페인 수준의 데이터를 수신하려면 다음의 단계를 수행하시기 바랍니다.

Adjust와 Meta 인증 정보 공유

Adjust가 리퍼러 메타데이터의 암호를 해독하려면 설치 리퍼러 암호 해독 키를 공유해야 합니다.

해독 키 찾기

암호 해독 키는 Meta 앱 ID별로 사용할 수 있는 64자의 문자열입니다.

예: 9fc19e01a8ac4db1404c23b1ea656047f9fcd5cb3befb0cf650a32ed919893ce

해독 키를 찾으려면 다음의 단계를 수행하시기 바랍니다.

  1. 앱 대시보드를 엽니다.
  2. 관련 앱을 선택합니다.
  3. Settings > Basic 을 선택합니다.
  4. Android 섹션으로 스크롤 다운합니다.
  5. 설치 리퍼러 해독 키 를 복사합니다.
A screenshot from Meta's App Dashboard that shows where to find your Decryption Key. Refer to the textual instructions above.

Adjust에 해독 키 추가하기

Adjust에서 해독 키를 추가하려면 다음의 단계를 수행하시기 바랍니다.

  1. Campaign Lab > 파트너 를 엽니다.
  2. Facebook 을 검색한 후 링크를 클릭하여 개요 페이지로 이동합니다.
  3. 앱 목록 확인을 위해 데이터 공유 를 선택합니다.
  4. 구성을 원하는 앱을 찾은 후 수정 버튼()을 클릭합니다.
  5. Facebook에 대한 데이터 공유 활성화 섹션에서 편집 을 선택합니다.
  6. 해독 키(선택 사항) 필드에 이전 단계에서 복사한 해독 키를 붙여넣기 합니다.
  7. 저장 버튼을 클릭합니다.

콜백에 Meta 리퍼러 플레이스홀더 추가

Adjust는 플레이스홀더를 사용하여 Meta로부터의 해독된 데이터를 전송할 수 있습니다. 이를 로데이터 내보내기에서 수신하려면 관련 플레이스홀더를 콜백 URL 또는 CSV에 추가하시기 바랍니다.

사용 가능한 플레이스홀더

GPIR
MIR
플레이스홀더설명
{fb_install_referrer}Meta 설치 리퍼러 전체 콘텐츠의 해독된 형식.
{fb_install_referrer_campaign_group_name}Meta 설치 리퍼러 전체 콘텐츠로부터의 "campaign_group_name" 값.
{fb_install_referrer_campaign_group_id}Meta 설치 리퍼러 전체 콘텐츠로부터의 "campaign_group_id" 값.
{fb_install_referrer_campaign_name}Meta 설치 리퍼러 전체 콘텐츠로부터의 "campaign_name" 값.
{fb_install_referrer_campaign_id}Meta 설치 리퍼러 전체 콘텐츠로부터의 "campaign_id" 값.
{fb_install_referrer_adgroup_id}Meta 설치 리퍼러 전체 콘텐츠로부터의 "adgroup_id" 값.
{fb_install_referrer_adgroup_name}Meta 설치 리퍼러 전체 콘텐츠로부터의 "adgroup_name" 값.
{fb_install_referrer_ad_id}Meta 설치 리퍼러 전체 콘텐츠로부터의 "ad_id" 값.
{fb_install_referrer_account_id}Meta 설치 리퍼러 전체 콘텐츠로부터의 "account_id" 값.
{fb_install_referrer_ad_objective_name}Meta 설치 리퍼러 전체 콘텐츠로부터의 "ad_objective_name" 값.
{fb_install_referrer_publisher_platform}Meta 설치 리퍼러 전체 콘텐츠로부터의 "publisher_platform" 값.

리포트 및 플레이스홀더 매핑

Adjust는 Meta의 리퍼러 플레이스홀더로부터 받은 데이터를 Adjust의 리포트와 일치시키기 위해 다음의 매핑을 사용합니다.

GPIR
MIR
Adjust 어트리뷰션 필드Meta 리포팅플레이스홀더예시 값
network_name퍼블리셔 플랫폼 {fb_install_referrer_publisher_platform} Meta Installs
campaign_nameCampaign name
Campaign ID		 {fb_install_referrer_campaign_group_name}
({fb_install_referrer_campaign_group_id}) 		Android Meta 캠페인 테스트 (123456789)
adgroup_nameAd Set Name
Ad Set ID		 {fb_install_referrer_campaign_name}
({fb_install_referrer_campaign_id}) 		Android - US - Basic Ad Set (234567890)
creative_nameAd Name
Ad ID		 {fb_install_referrer_adgroup_name}
({fb_install_referrer_adgroup_id}) 		Summer banner (345678901)

Adjust가 network_name을 표기하는 방법

Adjust는 다음의 로직을 사용하여 network_name 을 보고합니다.

publisher_platformnetwork_name은 다음과 같이 보고됩니다.
“facebook”, “unknown” 또는 기타Facebook 설치
"instagram”Instagram 설치
"messenger”Facebook Messenger 설치
"audience_network”Off-Facebook 설치

콜백 예시

GPIR
MIR
https://app.my-random-server.com/?tracker={tracker_token}&tracker_name={tracker_name}referrer={referrer}&fb_referrer={fb_install_referrer}&PhFbInstallReferrerAdId={fb_install_referrer_ad_id}&PhFbInstallReferrerAdGroupId={fb_install_referrer_adgroup_id}&PhFbInstallReferrerAdGroupName={fb_install_referrer_adgroup_name}&PhFbInstallReferrerCampaignId={fb_install_referrer_campaign_id}&PhFbInstallReferrerCampaignName={fb_install_referrer_campaign_name}&PhFbInstallReferrerCampaignGroupId={fb_install_referrer_campaign_group_id}&PhFbInstallReferrerCampaignGroupName={fb_install_referrer_campaign_group_name}&PhFbInstallReferrerAccountId={fb_install_referrer_account_id}&PhFbInstallReferrerAdObjectiveName={fb_install_referrer_ad_objective_name}&PhFbInstallReferrerPublisherPlatform={fb_install_referrer_publisher_platform}

값이 입력된 콜백 예시

GPIR
MIR
https://app.my-random-server.com/?tracker=unattr&tracker_name=Unattributed&referrer=adjust_reftag%3DceJTzfSP7kyVV%26utm_source%3Dfacebook%26utm_content%3D%257B%2522source%2522%253A%257B%2522data%2522%253A%2522afe56cf6228c6ea8c79da49186e718e92a579824596ae1d0d4d20d7793dca797bd4034ccf467bfae5c79a3981e7a2968c41949237e2b2db678c1c3d39c9ae564c5cafd52f2b77a3dc77bf1bae063114d0283b97417487207735da31ddc1531d5645a9c3e602c195a0ebf69c272aa5fda3a2d781cb47e117310164715a54c7a5a032740584e2789a7b4e596034c16425139a77e507c492b629c848573c714a03a2e7d25b9459b95842332b460f3682d19c35dbc7d53e3a51e0497ff6a6cbb367e760debc4194ae097498108df7b95eac2fa9bac4320077b510be3b7b823248bfe02ae501d9fe4ba179c7de6733c92bf89d523df9e31238ef497b9db719484cbab7531dbf6c5ea5a8087f95d59f5e4f89050e0f1dc03e464168ad76a64cca64b79%2522%252C%2522nonce%2522%253A%2522b7203c6a6fb633d16e9cf5c1%2522%257D%257D&fb_referrer=%7B%22ad_id%22%3A%2212345%22%2C%22ad_objective_name%22%3A%22APP_INSTALLS%22%2C%22adgroup_id%22%3A%2254321%22%2C%22adgroup_name%22%3A%22Adams+Test+Ad+Group%22%2C%22campaign_id%22%3A%22987654%22%2C%22campaign_name%22%3A%22Adams+Test+Campaign%22%2C%22campaign_group_id%22%3A%22654321%22%2C%22campaign_group_name%22%3A%22Adams+Test+Campaign+Group%22%2C%22account_id%22%3A%22444444%22%7D&PhFbInstallReferrerAdId=12345&PhFbInstallReferrerCampaignId=%7B%22ad_id%22%3A%2212345%22%2C%22ad_objective_name%22%3A%22APP_INSTALLS%22%2C%22adgroup_id%22%3A%2254321%22%2C%22adgroup_name%22%3A%22Adams+Test+Ad+Group%22%2C%22campaign_id%22%3A%22987654%22%2C%22campaign_name%22%3A%22Adams+Test+Campaign%22%2C%22campaign_group_id%22%3A%22654321%22%2C%22campaign_group_name%22%3A%22Adams+Test+Campaign+Group%22%2C%22account_id%22%3A%22444444%22%7D&PhFbInstallReferrerCampaignName=Adams+Test+Campaign&PhFbInstallReferrerCampaignGroupId=654321&PhFbInstallReferrerCampaignGroupName=Adams+Test+Campaign+Group&PhFbInstallReferrerAccountId=444444&PhFbInstallReferrerAdObjectiveName=APP_INSTALLS &PhFbInstallReferrerAdObjectiveName=APP_INSTALLS&FbInstallReferrerPublisherPlatform=facebook

Meta에 어트리뷰션되지 않은 설치

리퍼러가 설치에 추가되었으나 최종 어트리뷰션이 Meta가 아닌 파트너에 연결된 경우, 데이터에서 여전히 해당 리퍼러 정보를 수신할 수 있습니다.

GPIR
MIR
https://myserver.com?tracker=def456&tracker_name=NetworkA&fb_install_referrer=%7B%22ad_id%22%3A%2212345%22%2C%22ad_objective_name%22%3A%22APP_INSTALLS%22%2C%22adgroup_id%22%3A%2254321%22%2C%22adgroup_name%22%3A%22Test+Ad+Group%22%2C%22campaign_id%22%3A%22987654%22%2C%22campaign_name%22%3A%22Test+Campaign%22%2C%22campaign_group_id%22%3A%22654321%22%2C%22campaign_group_name%22%3A%22Test+Campaign+Group%22%2C%22account_id%22%3A%22444444%22%7D