文档

集成故障排除

Troubleshoot 常见移动端测量合作伙伴(MMP)集成错误。
阅读时间8 分钟最后更新于 3 天前

将移动端端衡量合作伙伴 (MMP) 与用户获取广告系列集成When,后台会检查广告系列是否成功接收数据。后台验证以下数据共享指标:
  • 您的广告系列会在发布后两天内收到安装数据。
  • 您的广告系列会在发布后的七天内收到 POST 安装后事件数据。
如果您的广告系列未能通过上述任何验证检查,后台会以集成错误message标志您的广告系列。请参阅以下各节以了解 ON 如何解决这些错误。
本故障排除指南涵盖以下 MMP 的集成问题:
  • Adjust
  • Airbridge
  • AppsFlyer
  • ByteBrew
  • Singular
  • Tenjin
有关与 AppsFlyer 集成的其他问题,请参阅 AppsFlyer 集成验证文档。

两天内没有安装数据

如果您的广告系列在投放后的两天内未接收安装数据,可能会对性能和归因产生负面影响。后台会标志此问题并显示以下错误message:
检测到一个或多个广告系列的集成阻挡问题。这些问题可能会严重影响性性能。解决此问题可确保准确的跟踪和交付:广告系列必须在发布后 2 天内至少接收一次安装回传。

原因

如果 MMP 集成配置错误,广告系列可能无法累积安装数据。请参阅特定于 MMP 的集成指南以了解分步集成说明。

解决方案

请考虑以下两种分辨率以确保广告系列收到安装数据。

从所有来源共享安装数据

当您与 Unity 共享安装数据时,请确保包含整个用户群底部的数据,包括归因、未归因和自然安装。如需了解每种归因类型的定义,请参阅归因介绍。
每个 MMP 对此设置都有独特的术语。请参阅以下示例展示了在支持的 MMP 后台中如何从所有来源共享安装数据:
要共享All用底部的安装数据,请在 调整(调整)后台中执行以下步骤:
1.转到 **Campaign Lab(广告系列实验室)**选项卡 > **Partners(合作伙伴)**页面。 2.在 **What sources of data do you want to share(您希望共享哪些数据来源)**选项中,选择 Data from all attribution sources(所有归因来源的数据)。

查看集成设置

请查看首选 MMP 的集成指南,确保其Configured正确。请查看合作伙伴集成指南中的集成激活、广告主凭据和数据共享 Settings:
完成以下步骤,将调整和共享数据与用户获取广告系列正确集成:
1

Activate Unity Ads in the Adjust dashboard

若要启用与 Unity Ads 的集成,请按以下步骤操作:
1.在 Adjust Dashboard 中,转到 Campaign Lab > Partners。 2.选择 + New partner,并搜索 Unity Ads。 3.选择您的应用并选择 Next。 4.在 Game ID Field 字段中输入您的广告主 Game ID。要从 Unity Dashboard 复制 Game ID,请参阅以下步骤:

要从用户获取后台复制 Game ID,请执行以下步骤:
  1. 从后台左侧导航菜单转到 Apps(应用)。表格列出了您组织的每个应用。
  2. 滚动或搜索以找到所需的应用。
  3. 选择应用行末尾的 Settings () 以打开应用细节 Page。
  4. 转到 MMP Settings 部分。
  5. 选择 Game ID Next 旁边的复制 () 以将该 ID 复制到剪贴板。
注意
请严格按照用户获取后台中显示的 Game ID 输入。Game ID 不匹配会导致 Unity 无法正确接收事件。
2

Choose data to share with Unity

要选择调整可与广告系列共享的数据,请在调整集成中执行以下步骤:
1.在 **What sources of data do you want to share(您希望共享哪些数据来源)**选项中,选择 Data from all attribution sources(所有归因来源的数据)。 2.从 您还想共享哪些Other数据? 部分中,选择All选项:
  • Sessions(会话)
  • 卸载并重新安装
  • 应用内收入
  • 参数
3.在 Parameters 数据选项中,选择 发送 All Parameters**。
调整数据共享选项

Select all Adjust data-sharing options

重要
您必须共享所有数据类型才能启用 ON Ad Spend (ROAS) 和事件优化广告系列。
3

Map events and parameters

若要与您的用户获取广告系列共享应用内事件,请在 Adjust 集成中进行如下操作:
1.转到 数据共享 > 映射事件,然后选择 + 映射事件。
2.从 调整事件 列表中选择要调整与 Unity 共享的事件。
调整事件

Adjust event

3.若要为所有平台映射相同事件,请选择 使用全局映射。
4.在 合作伙伴事件 > Name Field中选择或进入与正确 调整 事件对应的 Unity 事件。
Partner event

Partner event

请参阅表以了解正确的 调整 事件Mapping:

留存广告系列的

事件类型

Adjust 应用事件

Unity 合作伙伴事件

映射注释

In-app Purchase (IAP)
purchase
purchase
-
广告收入
ad_revenue
ad_revenue
如果您的 Adjust 帐户支持广告收入数据共享,请将该数据作为专门的
ad_revenue
事件发送。
否则,请勿发送广告收入事件。将 Mapping Ad Revenue 事件映射为其他事件类型(如 ),可能导致广告系列优化失效。
完成重要步骤
{milestone_event}
level_complete_{NameOfEvent}
您可以为 调整 **App 事件 使用Any自定义定义的Event name。
确保为合作伙伴事件Name使用提供的格式。
NameOfEvent
不能包含空格。
会话
  • session
  • launch
session
会话事件不需要事件 Mapping。

七天内没有 POST 事件数据

如果您的广告系列在投放后的七天内没有收到 POST 事件数据,可能会对性能和优化产生负面影响。后台会标志此问题并显示以下错误message:
检测到一个或多个广告系列的集成阻挡问题。这些问题可能会严重影响性性能。解决此问题可确保准确的跟踪和交付:广告系列必须在发布后的 7 天内至少接收一次 POST 安装后事件回传。

原因

几种集成 Settings 可能会干扰 MMP 向广告系列发送 POST 事件数据,例如:

归因Configured不正确

当您配置不正确的归因链接时,MMP 无法与 Unity 共享 POST 事件数据。

Ad Revenue报告已Disabled

如果未启用 MMP 来为 Purchase 和 Ad Revenue 事件发送值和 Revenue,后台将没有实现以下优化的广告系列目标所需的数据:
  • 应用内购 (IAP) ON 广告支出回报率 (ROAS)
  • 广告收入 ROAS
  • 混合 ROAS
  • 付款人事件优化
ON 如何解决此问题的细节,请参阅正确配置数据共享部分。

解决方案

请考虑以下解决方案以确保广告系列收到 POST 安装后事件数据。

正确映射安装后事件

当您将安装后事件数据分享至您的广告系列时,请确保正确映射安装后事件。正确映射意味着您需要将 Unity Ads 事件名称与正确的 MMP 事件名称对应。
警告
如果您使用除 Singular 以外的其他 MMP,请勿将广告收入事件与应用内购 (IAP) 事件合并。
请参考以下示例,它们展示了正确映射的事件名称:
在 Adjust 集成的 Map events to share with Unity Ads(映射事件以与 Unity Ads 共享) 部分中,按如下方式映射您的安装后事件:
留存广告系列的

事件类型

Adjust 应用事件

Unity 合作伙伴事件

映射注释

In-app Purchase (IAP)
purchase
purchase
-
广告收入
ad_revenue
ad_revenue
如果您的 Adjust 帐户支持广告收入数据共享,请将该数据作为专门的
ad_revenue
事件发送。
否则,请勿发送广告收入事件。将 Mapping Ad Revenue 事件映射为其他事件类型(如 ),可能导致广告系列优化失效。
完成重要步骤
{milestone_event}
level_complete_{NameOfEvent}
您可以为 调整 **App 事件 使用Any自定义定义的Event name。
确保为合作伙伴事件Name使用提供的格式。
NameOfEvent
不能包含空格。
会话
  • session
  • launch
session
会话事件不需要事件 Mapping。

正确配置数据共享

当您与广告系列共享 POST 安装后事件数据时,请确保正确配置数据共享 Settings。
要将安装和 POST 安装后事件数据发送到 Unity,请参阅以下合作伙伴指定说明的配置数据共享 Settings 部分:
完成以下步骤,将调整和共享数据与用户获取广告系列正确集成:
1

Activate Unity Ads in the Adjust dashboard

若要启用与 Unity Ads 的集成,请按以下步骤操作:
1.在 Adjust Dashboard 中,转到 Campaign Lab > Partners。 2.选择 + New partner,并搜索 Unity Ads。 3.选择您的应用并选择 Next。 4.在 Game ID Field 字段中输入您的广告主 Game ID。要从 Unity Dashboard 复制 Game ID,请参阅以下步骤:

要从用户获取后台复制 Game ID,请执行以下步骤:
  1. 从后台左侧导航菜单转到 Apps(应用)。表格列出了您组织的每个应用。
  2. 滚动或搜索以找到所需的应用。
  3. 选择应用行末尾的 Settings () 以打开应用细节 Page。
  4. 转到 MMP Settings 部分。
  5. 选择 Game ID Next 旁边的复制 () 以将该 ID 复制到剪贴板。
注意
请严格按照用户获取后台中显示的 Game ID 输入。Game ID 不匹配会导致 Unity 无法正确接收事件。
2

Choose data to share with Unity

要选择调整可与广告系列共享的数据,请在调整集成中执行以下步骤:
1.在 **What sources of data do you want to share(您希望共享哪些数据来源)**选项中,选择 Data from all attribution sources(所有归因来源的数据)。 2.从 您还想共享哪些Other数据? 部分中,选择All选项:
  • Sessions(会话)
  • 卸载并重新安装
  • 应用内收入
  • 参数
3.在 Parameters 数据选项中,选择 发送 All Parameters**。
调整数据共享选项

Select all Adjust data-sharing options

重要
您必须共享所有数据类型才能启用 ON Ad Spend (ROAS) 和事件优化广告系列。
3

Map events and parameters

若要与您的用户获取广告系列共享应用内事件,请在 Adjust 集成中进行如下操作:
1.转到 数据共享 > 映射事件,然后选择 + 映射事件。
2.从 调整事件 列表中选择要调整与 Unity 共享的事件。
调整事件

Adjust event

3.若要为所有平台映射相同事件,请选择 使用全局映射。
4.在 合作伙伴事件 > Name Field中选择或进入与正确 调整 事件对应的 Unity 事件。
Partner event

Partner event

请参阅表以了解正确的 调整 事件Mapping:

留存广告系列的

事件类型

Adjust 应用事件

Unity 合作伙伴事件

映射注释

In-app Purchase (IAP)
purchase
purchase
-
广告收入
ad_revenue
ad_revenue
如果您的 Adjust 帐户支持广告收入数据共享,请将该数据作为专门的
ad_revenue
事件发送。
否则,请勿发送广告收入事件。将 Mapping Ad Revenue 事件映射为其他事件类型(如 ),可能导致广告系列优化失效。
完成重要步骤
{milestone_event}
level_complete_{NameOfEvent}
您可以为 调整 **App 事件 使用Any自定义定义的Event name。
确保为合作伙伴事件Name使用提供的格式。
NameOfEvent
不能包含空格。
会话
  • session
  • launch
session
会话事件不需要事件 Mapping。