安卓端 Meta 原始数据报告

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

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

  • Google Play install referrer(GPIR)
  • Meta Install Referrer(MIR)

两种 Install Referrer 都能提供更多来自 Facebook 和 Instagram 等 Meta 旗下应用的安装信息。但是只有 MIR 支持展示归因和非同一会话点击归因。

操作前须知

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

要求

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

GPIR

要启用 GPIR,您需要设置Google Play Install Referrer

MIR

要启用 MIR 插件,您需要将 Adjust 安卓 SDK 更新至 v5 且配置 Meta install referrer 插件

工作原理

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

  1. 当用户安装您的应用时,Install Referrer 会从安装来源收集推荐数据。
  2. Meta 使用 Install Referrer 的 API 分享此加密数据。
  3. 随后,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",
}

您可以在原始数据导出中使用占位符来收集已解密数据。

提示:
如果同时启用 GPIR 和 MIR,则原始数据导出中会同时收到来自这两个来源的信息。Adjust 仅会对 Datascape 中的 GPIR 和 MIR 信息进行去重。我们的一般建议是 GPIR数据优先。

哪些数据不会被分享?

Meta 不会发送设备 ID。

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

  • 展示转化。
  • 来自非 Google Play 和安卓应用商店 (例如 Galaxy Store 和 Amazon 应用商店) 的应用事件。

设置 Install Referrer

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

与 Adjust 分享 Meta 凭证

要让 Adjust 解密 referrer 元数据,您需要提供 Install Referrer Decryption Key。

如何查找Decryption Key

解密密匙 (Decryption Key) 是一个 64 字符长的字符串,每个 Meta 应用 ID 对应一个。

示例:9fc19e01a8ac4db1404c23b1ea656047f9fcd5cb3befb0cf650a32ed919893ce

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

  1. 打开应用控制面板
  2. 选择相关应用。
  3. 选择 设置 > 基本​ 。
  4. 滚动至 安卓​ 部分。
  5. 复制  Install Referrer 解密密钥​ 。
A screenshot from Meta's App Dashboard that shows where to find your Decryption Key. Refer to the textual instructions above.

在 Adjust 中添加Decryption Key

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

  1. 选择 Campaign Lab > 合作伙伴​ 。
  2. 搜索 Facebook​ 并点击链接进入概览页面。
  3. 选择 数据分享​ 标签页来查看应用列表。
  4. 找到想要设置的应用并选择 编辑​ 按钮 ()。
  5. 启用 Facebook 数据分享​ 部分,选择 编辑​ 。
  6. 将上一步复制的密钥粘贴进 解密密钥 (可选)​ 字段。
  7. 点击 保存​ 按钮。

将 Meta referrer 占位符添加至您的回传

Adjust 可以使用占位符向您发送来自 Meta 的解密数据。要在原始数据导出中接收此信息,请将相关占位符添加至您的回传 URL 或 CSV 定义。

可用的占位符

GPIR
MIR
占位符描述
{fb_install_referrer}Meta Install Referrer 的解密后完整内容。
{fb_install_referrer_campaign_group_name}完整 Meta Install Referrer 内容的 "campaign_group_name" 值。
{fb_install_referrer_campaign_group_id}完整 Meta Install Referrer 内容的 "campaign_group_id" 值。
{fb_install_referrer_campaign_name}完整 Meta Install Referrer 内容的 "campaign_name" 值。
{fb_install_referrer_campaign_id}完整 Meta Install Referrer 内容的 "campaign_id" 值。
{fb_install_referrer_adgroup_id}完整 Meta Install Referrer 内容的 "adgroup_id" 值。
{fb_install_referrer_adgroup_name}完整 Meta Install Referrer 内容中的 "adgroup_name" 值。
{fb_install_referrer_ad_id}完整 Meta Install Referrer 内容的 "ad_id" 值。
{fb_install_referrer_account_id}完整 Meta Install Referrer 内容的 "account_id" 值。
{fb_install_referrer_ad_objective_name}完整 Meta Install Referrer 内容的 "ad_objective_name" 值。
{fb_install_referrer_publisher_platform}完整 Meta Install Referrer 内容的 "publisher_platform" 值。

报告和占位符映射

Adjust 使用下列映射确保来自 Meta referrer 占位符的数据与我们的报告保持一致。

GPIR
MIR
Adjust 归因字段Meta 报告占位符示例值
network_namePublisher platform {fb_install_referrer_publisher_platform} Meta 安装
campaign_nameCampaign name
Campaign ID
{fb_install_referrer_campaign_group_name}
({fb_install_referrer_campaign_group_id})
Android Meta campaign test (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”非 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 的安装

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

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