安卓端 Meta 原始数据报告

借助 Meta,广告主可以使用 Install Referrer 获得更加详尽的安卓原始数据。推广活动元数据会以加密格式附加在 Install Referrer 中。要读取元数据,您需要使用 Meta 为应用提供的 Decryption Key。

您可以使用两种受支持的 install referrer 来丰富原始数据:

  • Meta Install Referrer(MIR)
  • Google Play install referrer(GPIR)
请注意:
两种 Install Referrer 都能提供更多来自 Facebook 和 Instagram 等 Meta 旗下应用的安装信息。不过,MIR 支持展示和非同一会话点击归因,GPIR 则不支持。我们强烈推荐您使用 MIR,以便充分发挥 Meta 推广活动的潜力。

操作前须知

以下是您在操作前需要了解的内容。

要求

  • 应用的Meta Decryption Key
  • 拥有 管理员​ 和 编辑员权限的用户可以在 Adjust 中更新 Meta 凭证。

MIR

GPIR

工作原理

借助 Install Referrer 解决方案,您可以针对在安卓端投放的广告,将用户的应用内活动关联到用户获取来源,从而持续监测推广活动的表现,了解重要用户获取趋势。

当用户安装您的应用时,Install Referrer 会从安装来源收集推荐内容。Meta 使用 Install Referrer API 以加密格式分享该数据。随后,Adjust 会提取该数据并使用 Meta Decryption Key 进行解密。

已解密数据字符串示例:

{
"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 信息进行去重,但您依旧会在原始数据导出中收到两组数据。 MIR 数据的优先级应高于 GPIR 数据。

哪些数据不会被分享?

Meta 不会发送以下任何元数据:

以下元数据 只在​ 使用 MIR 时可用:

  • 展示转化。
  • 在 Google Play 商店以外的安卓应用商店 (如 Galaxy Store 和 Amazon Appstore) 发生的应用事件。

设置 Install Referrer 解决方案

要设置 Install Referrer 解决方案并从 Meta 接收推广活动层级详情,请按照下列步骤操作。

1. 在 Adjust 中更新您的 Meta 凭证

要让 Adjust 解密 referrer 元数据,您需要分享 Install Referrer Decryption Key。该密钥是一个 64 字符的字符串,由小写字母 (a-f) 和数字 (0-9) 组成。每个 Meta 应用 ID 对应一个 Decryption Key。

示例:9fc19e01a8ac4db1404c23b1ea656047f9fcd5cb3befb0cf650a32ed919893ce

如何查找Decryption Key

要找到您的Decryption Key,请按照下列步骤操作。

  1. 登录Meta 开发者门户
  2. 在右上角找到 我的应用​ 。
  3. 选择您想使用 decryption key 的应用。
  4. 选择 设置 > 基本​ 。
  5. 滚动至 安卓​ 部分。
  6. 找到 Google Play​ 标题下的 Install Referrer Decryption Key​ 。

在 Adjust 中添加Decryption Key

要在 Adjust 中添加 Decryption Key,请按照下列步骤操作。

  1. 找到 Campaign Lab​ ,选择 合作伙伴​ 。
  2. 搜索 Facebook​ 并点击链接进入概览页面。
  3. 选择 数据分享​ 标签页来查看应用列表。
  4. 找到想要设置的应用并选择 编辑​ 按钮 ()。
  5. 启用 Facebook 数据分享​ 部分,选择 编辑​ 。
  6. 为想要设置的每个平台输入 Decryption key​ 。

2. 为您的回传添加 Meta referrer 占位符

利用特定占位符,Adjust 可以将来自 Meta 的解密数据发送至您的原始数据报告。要接收该信息,请更新您的回传 URL 或 CSV 定义,添加必要的占位符。

可用的占位符

MIR
GPIR
占位符描述
{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” 值。

报告和占位符映射

为了统一来自 Meta referrer 占位符的数据和报告,Adjust 使用以下映射。

MIR
GPIR
Adjust 归因字段Meta 报告占位符示例值
network_namePublisher platform
  • {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={tracker_token}&tracker_name={tracker_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}&PhMetaInstallReferrerIsClick={meta_install_referrer_is_click}&PhMetaInstallReferrerActualTimestamp={meta_install_referrer_actual_timestamp}

已填充值的回传示例:

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%2522data%2522%253A%2522afe56cf6228c6ea8c79da49186e718e92a579824596ae1d0d4d20d7793dca797bd4034ccf467bfae5c79a3981e7a2968c41949237e2b2db678c1c3d39c9ae564c5cafd52f2b77a3dc77bf1bae063114d0283b97417487207735da31ddc1531d5645a9c3e602c195a0ebf69c272aa5fda3a2d781cb47e117310164715a54c7a5a032740584e2789a7b4e596034c16425139a77e507c492b629c848573c714a03a2e7d25b9459b95842332b460f3682d19c35dbc7d53e3a51e0497ff6a6cbb367e760debc4194ae097498108df7b95eac2fa9bac4320077b510be3b7b823248bfe02ae501d9fe4ba179c7de6733c92bf89d523df9e31238ef497b9db719484cbab7531dbf6c5ea5a8087f95d59f5e4f89050e0f1dc03e464168ad76a64cca64b79%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%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&PhMetaInstallReferrerAdId=12345&PhMetaInstallReferrerCampaignId=%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&PhMetaInstallReferrerCampaignName=Adams+Test+Campaign&PhMetaInstallReferrerCampaignGroupId=654321&PhMetaInstallReferrerCampaignGroupName=Adams+Test+Campaign+Group&PhMetaInstallReferrerAccountId=444444&PhMetaInstallReferrerAdObjectiveName=APP_INSTALLS &PhMetaInstallReferrerAdObjectiveName=APP_INSTALLS&MetaInstallReferrerPublisherPlatform=facebook&PhMetaInstallReferrerIsClick=1&PhMetaInstallReferrerActualTimestamp=1234567890

对于未归因至 Meta 的安装

如果安装信息中带有 referrer,而 Meta 以外的其他合作伙伴获得了最终的归因,您依旧可以在数据中接收 referrer 信息。

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%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