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

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

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

  • Meta 설치 리퍼러(MIR)
  • Google Play 설치 리퍼러(GPIR)
참고:
두 설치 리퍼러는 Facebook과 Instagram과 같은 Meta 앱에서 발생한 앱 설치에 대한 추가 정보를 제공합니다. 그러나 MIR은 GPIR이 지원하지 않는 뷰쓰루(view-through) 어트리뷰션 및 동일하지 않은 세션 클릭 쓰루(click-through) 어트리뷰션을 지원합니다. Adjust는 Meta 캠페인 성과를 최대화하기 위해 MIR를 사용하는 것을 강력히 권장드립니다.

시작에 앞서

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

요구 사항

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

MIR

GPIR

작동 원리

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

사용자가 앱을 설치하면 설치 리퍼러는 설치 소스로부터 리퍼러 콘텐츠를 수집합니다. Meta는 해당 데이터를 설치 리퍼러의 API를 사용하여 암호화된 형식으로 공유합니다. 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",
}

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

경고:
MIR과 GPIR을 모두 활성화하면 두 소스로부터 정보를 모두 수신하게 됩니다. Adjust는 Datascape에서 MIR 및 GPIR 정보를 중복 제거하지만, 로데이터 내보내기에서 두 데이터의 세트를 모두 받게 됩니다. 또한, GPIR 데이터보다 MIR 데이터를 우선시해야 합니다.

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

Meta는 다음의 메타데이터를 전송하지 않습니다.

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

  • 뷰쓰루(View-through) 전환
  • Google Play Store 외의 Android 앱 스토어(예: Galaxy Store나 Amazon Appstore)에서 발생한 앱 이벤트.

설치 리퍼러 솔루션 설정

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

1. Adjust에서 Meta 인증 정보 업데이트하기

Adjust가 리퍼러 메타데이터의 암호를 해독하려면 설치 리퍼러 암호 해독 키를 공유해야 합니다. 이는 소문자(af)와 숫자(0-9)로 구성된 64자의 문자열입니다. Meta 앱 ID 당 1개의 암호 해독 키가 있습니다.

예: 9fc19e01a8ac4db1404c23b1ea656047f9fcd5cb3befb0cf650a32ed919893ce

해독 키 찾기

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

  1. Meta 개발자 포털 에 로그인합니다.
  2. 우측 상단에서 나의 앱 으로 이동합니다.
  3. 암호 해독 키에 액세스하고자 하는 앱을 선택합니다.
  4. Settings > Basic 을 선택합니다.
  5. Android 섹션으로 스크롤 다운합니다.
  6. Google Play 헤더에서 Install Referrer Decryption Key 를 찾습니다.

Adjust에 해독 키 추가하기

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

  1. Campaign Lab 에서 광고 네트워크 를 선택합니다.
  2. Facebook 을 검색한 후 링크를 클릭하여 개요 페이지로 이동합니다.
  3. 앱 목록 확인을 위해 데이터 공유 를 선택합니다.
  4. 구성을 원하는 앱을 찾은 후 수정 버튼()을 클릭합니다.
  5. 구성을 원하는 플랫폼에 대한 암호화키 를 입력합니다.

2. 콜백에 Meta 리퍼러 플레이스홀더 추가하기

Adjust는 로데이터 내보내기를 통해 Meta에서 암호 해독된 데이터를 전송하기 위해 특정 플레이스홀더를 사용할 수 있습니다. 정보를 수신하려면 콜백 URL 또는 CSV 정의를 필요한 플레이스홀더로 업데이트해야 합니다.

사용 가능한 플레이스홀더

MIR
GPIR
플레이스홀더설명
{meta_install_referrer}Meta 설치 리퍼러 전체 콘텐츠의 해독된 형식.
{meta_install_referrer_campaign_group_name}Meta 설치 리퍼러 전체 콘텐츠로부터의 "campaign_group_name" 값.
{meta_install_referrer_campaign_group_id}Meta 설치 리퍼러 전체 콘텐츠로부터의 "campaign_group_id" 값.
{meta_install_referrer_campaign_name}Meta 설치 리퍼러 전체 콘텐츠로부터의 "campaign_name" 값.
{meta_install_referrer_campaign_id}Meta 설치 리퍼러 전체 콘텐츠로부터의 "campaign_id" 값.
{meta_install_referrer_adgroup_id}Meta 설치 리퍼러 전체 콘텐츠로부터의 "adgroup_id" 값.
{meta_install_referrer_adgroup_name}Meta 설치 리퍼러 전체 콘텐츠로부터의 "adgroup_name" 값.
{meta_install_referrer_ad_id}Meta 설치 리퍼러 전체 콘텐츠로부터의 "ad_id" 값.
{meta_install_referrer_account_id}Meta 설치 리퍼러 전체 콘텐츠로부터의 "account_id" 값.
{meta_install_referrer_ad_objective_name}Meta 설치 리퍼러 전체 콘텐츠로부터의 "ad_objective_name" 값.
{meta_install_referrer_publisher_platform}Meta 설치 리퍼러 전체 콘텐츠로부터의 "publisher_platform" 값.

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

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

MIR
GPIR
Adjust 어트리뷰션 필드Meta 리포팅플레이스홀더예시 값
network_name퍼블리셔 플랫폼
  • {meta_install_referrer_publisher_platform}
Meta 설치
campaign_nameCampaign name
Campaign ID
  • {meta_install_referrer_campaign_group_name}({meta_install_referrer_campaign_group_id})
 Android Facebook campaign test (123456789)
adgroup_nameAd Set Name
Ad Set ID
  • {meta_install_referrer_campaign_name}({meta_install_referrer_campaign_id})
 Android - US - Basic Ad Set (234567890)
creative_nameAd Name
Ad ID
  • {meta_install_referrer_adgroup_name}({meta_install_referrer_adgroup_id})
 Summer banner (345678901)

Adjust가 network_name을 표기하는 방법

콜백 예시

콜백 URL 예시

MIR
GPIR
https://app.my-random-server.com/?tracker={link_token}&tracker_name={link_name}referrer={referrer}&meta_referrer={meta_install_referrer}&PhMetaInstallReferrerAdId={meta_install_referrer_ad_id} &PhMetaInstallReferrerAdGroupId={meta_install_referrer_adgroup_id}&PhMetaInstallReferrerAdGroupName={meta_install_referrer_adgroup_name}&PhMetaInstallReferrerCampaignId={meta_install_referrer_campaign_id}&PhMetaInstallReferrerCampaignName={meta_install_referrer_campaign_name}&PhMetaInstallReferrerCampaignGroupId={meta_install_referrer_campaign_group_id}&PhMetaInstallReferrerCampaignGroupName={meta_install_referrer_campaign_group_name}&PhMetaInstallReferrerAccountId={meta_install_referrer_account_id}&PhMetaInstallReferrerAdObjectiveName ={meta_install_referrer_ad_objective_name}&PhMetaInstallReferrerPublisherPlatform={meta_install_referrer_publisher_platform}

값이 입력된 콜백 예시

MIR
GPIR
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%25223A%252%25%25%2A 2522%252C%2522nonce%2522%253A%2522b7203c6a6fb633d16e9cf5c1%2522%257D%257D&meta_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+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%7DRefin_group_name%22%3A%22Adams+Test+Campaign+Group%22%2C%22account_id%22%3A%7DRef. 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+T%22Addams+Group%22Adams+Group 22%2C%22campaign_id%22%3A%22987654%22%2C%22campaign_name%22%3A%22Adams+Test+Campaign%22%2C%22campaign_gr oup_id%22%3A%22654321%22%2C%22campaign_group_name%22%3A%22Adams+Test+Campaign+Group%22%2C%22account_id%22%3A%22444444%22%7D&PhMetaInstallReferrerCampaignName=Adams+Test+Campaign&PhMetaInstallReferrerCampaignGroupId=654321&PhMetaInstallReferrerCampaignGroupName= Adjust+Test+Campaign+Group&PhMetaInstallReferrerAccountId=444444&PhMetaInstallReferrerAdObjectiveName=APP_INSTALLS &PhMetaInstallReferrerAdObjectiveName=APP_INSTALLS&MetaInstallReferrerPublisherPlatform=facebook

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

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

MIR
GPIR
https://myserver.com?tracker=def456&tracker_name=NetworkA&meta_install_referrer=%7B%22ad_id%22%3A%2212345%22%2C%22ad_objective_name%22%3A%22APP_INSTALLS%22%2C%22adgroup_id%22%3A%22543%2122 %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