合作伙伴配置和回传:常见问题和故障排除

文档

在 "合作伙伴配置"页面,您可以配置 Singular 跟踪器,使其与各种广告网络和其他合作伙伴协同工作。如果您刚开始使用,请参阅《如何配置合作伙伴设置和回传》

注意:本指南适用于Singular客户。如果您是Singular 合作伙伴或希望成为其合作伙伴,请参阅合作伙伴信息

故障排除

为什么我的网络合作伙伴收不到回帖

如果合作伙伴网络说他们没有收到安装/转换或应用程序内事件的反馈:

  1. 转到 "属性">"导出日志",下载合作伙伴的回传日志。有关下载日志的帮助,请参阅导出日志和用户级数据常见问题解答
  • 确保过滤响应 HTTP 代码 = 200 的回传。如果响应 HTTP 代码为 "200",则表示合作伙伴确认收到了回传。
  • 还要选择 "响应 HTTP 主体"字段,因为它可能有助于确定合作伙伴端的技术问题。
  • 与合作伙伴共享日志,以便在内部验证数据。如果有许多带其他响应代码的回传,请告知他们在接收来自 Singular 的回传时可能存在技术问题。
我的营销活动已经停止,为什么合作伙伴网络仍会收到安装/转换或应用内事件的回传?

如果广告网络合作伙伴被设置为接收所有安装或应用内事件,并且您选择了 "发送所有 "事件给合作伙伴,那么回帖配置将继续向他们发送回帖。您必须删除回传或取消选中 "合作伙伴配置 "中的 "发送所有 "复选框,才能停止发送此数据。请参阅Singular 术语表中的 "接收所有安装 "定义。

为什么合作伙伴收到的回传事件数量与Singular 报告中的事件数量不匹配

可能的原因有

  • 回溯窗口: 一个或多个事件可能为回传配置了不同的回传窗口。检查合作伙伴配置页面中的设置。
  • 技术问题:由于合作伙伴端的技术问题,合作伙伴可能没有收到一个或多个回传。如需检查,请参阅为什么我的网络合作伙伴没有收到回传?
  • 重复事件: 应用程序中的 Singular SDK 会自动生成一个名为__REVENUE__ 的事件,该事件会在任何应用程序内购买时触发。此外,您还可以为不同类型的应用程序内购买创建自己的 SDK 收入事件。在配置事件回传时,请确保为 __REVENUE__自定义命名的收入事件发送回传,而不是同时发送。否则,Singular 将为每个应用内购买发送两次回帖。
为什么会向没有事件属性的合作伙伴发送回帖?

如果网络合作伙伴说他们收到的回帖没有事件属性:

  1. 转到 "属性">"导出日志",下载合作伙伴的回帖日志。检查回帖HTTP 主体目标 URL字段,查看它们是否包含事件属性。有关下载日志的帮助,请参阅导出日志和用户级数据常见问题
  2. 如果日志显示发送的回传确实没有事件属性,请仔细检查合作伙伴配置页面中的回传设置。如果没有配置将添加的属性与事件一起发送,请立即更改设置。
  3. 如果设置正确,但回传仍然缺少属性,请联系 Singular 支持。
如何仔细检查发送给网络合作伙伴的回传内容,例如用于计费和开票?

如果您与网络的账单是基于Singular在此期间向其发送的安装/事件回传数量,您可以通过 "属性">"导出日志"下载原始传日志,仔细检查向合作伙伴发送了哪些回传。

有关导出日志页面的一般帮助,请参阅导出日志和用户级数据常见问题

对于回传验证,我们建议下载具有以下设置的日志:

postback_log1.png

postback_log2.png

确保过滤响应 HTTP 代码中的值 "200",以查看回传接收方成功接收的回传。

不要混淆 "合作伙伴"和"回帖接收方 "字段:

  • 合作伙伴是指事件归属的网络。
  • 回帖接收方是接收事件回帖的合作伙伴。事件并不一定归属于该合作伙伴(请记住,有些合作伙伴会要求接收所有事件的回帖,无论事件是归属于该合作伙伴还是其他网络,您可以在合作伙伴配置页面启用该选项)。

附加字段 "是否归属"进一步说明了回贴接收者是否是事件归属的网络("Y "表示是同一网络,"N "表示事件归属于另一个合作伙伴,您可以在 "合作伙伴"字段中看到)。

注意:"合作伙伴 "过滤器将根据接收回传的合作伙伴名称过滤回传--无论是合作伙伴网络、内部 BI 还是第三方分析工具等。

对于其他日志类型,"合作伙伴 "过滤器表示转换或事件归属的合作伙伴(广告网络)。

常见问题

合作伙伴配置常见问题

哪些回传是必需的,哪些是可选的?

当应用程序安装归属于每个合作伙伴网络时,Singular 会向该网络发送回传。您不能禁用这些回传。

其他类型的回帖是可选的,取决于合作伙伴网络的偏好:

  • 重新参与回传
  • 应用内事件回传
  • 有关转换(安装/重新吸引)和不属于合作伙伴的事件的回帖
Singular 回帖从哪些 IP发送?
Singular何时以及多久重试一次回帖?系统在两次重试之间会等待多长时间?
  • 如果收到的HTTPS响应代码在500和559之间,Singular会重试回传。
  • 该机制最多可重试 5 次。
  • 重试间隔为 1、5、15、30 和 60 分钟。

合作伙伴类型和术语

什么是合作伙伴

合作伙伴配置"页面中的合作伙伴是您配置的与 Singular 归属服务协同工作的所有网络和服务。

注意:这不是您告诉 Singular 从哪些来源获取营销活动数据以在 Singular 报告中展示数据的地方。为此,您需要在 "数据连接器"页面中单独设置广告网络和其他媒体来源(参见 "数据连接器 "常见问题)。

我可以为合作伙伴进行哪些设置?

合作伙伴配置页面允许你为每个合作伙伴和网站配置以下内容:

  • 点击归因的回溯窗口
  • 向合作伙伴发送哪些回帖
  • 如果 Singular 需要您的登录凭证来连接合作伙伴,您也可以在此输入合作伙伴平台的登录凭证。这一点因合作伙伴而异。

更多详情,请参阅下面的配置设置和回传

有哪些类型的合作伙伴
  • 有些合作伙伴是广告网络、广告公司等。你可以为这些合作伙伴配置归因设置,然后创建包含合作伙伴自定义宏的跟踪链接。您还可以让 Singular 以自动回传的形式向这些合作伙伴发送有关归因安装、欺诈决策等信息。

  • 其他合作伙伴包括第三方 BI 系统、欺诈分析服务等。如果您与此类服务合作,可以在 "合作伙伴配置 "页面对其进行设置,使其能够接收回传信息。
什么是"内部 "合作伙伴(内部 BI)?

"内部 BI "是一种特殊类型的合作伙伴,如果您想让自己的内部平台接收有关归因决策、欺诈决策等的反馈,可以对其进行配置。更多信息,请参阅配置内部 BI 回传

什么是网站?

站点(或应用程序站点)是为特定平台开发的应用程序版本。您可以为每个应用程序站点分别配置合作伙伴设置。

例如,如果您有一个在 Android 和 iOS 上运行的应用程序,您就有两个应用程序站点,您可以为每个站点配置合作伙伴设置。

另请参阅:应用程序配置常见问题

Singular如何知道向每个合作伙伴发送哪些数据?

与合作伙伴开发集成的过程中,Singular 会创建一个回传模板,其中包含合作伙伴支持的所有字段。当你保存一个新的合作伙伴配置时,Singular就会开始根据该模板创建回传。

如何导出合作伙伴设置?如何获得为合作伙伴配置的回帖的完整列表

导出所有合作伙伴的回帖设置:

  • 单击 "合作伙伴配置"页面右上角的 "全部导出"。
  • 要导出所选合作伙伴的回帖设置,首先单击合作伙伴左侧的复选框,选择一个或多个合作伙伴,然后单击 "导出所选"。

这将下载一个 CSV 文件,其中包含已配置的每个回帖的信息。

注意

  • CSV 文件中的每一行代表为该合作伙伴配置的一次回贴。
  • 自 2023 年 5 月起,导出文件中将提供新字段。
说明
合作伙伴 合作伙伴名称
机构 [新字段] 配置机构的名称(如果相关)
应用程序 应用程序的显示名称
捆绑 ID 应用程序的长名称或捆绑 ID
网站公共 ID [新字段] 应用程序在 Apple App Store 或 Google Play 中的 ID,或网站的 URL。
操作系统 应用程序的操作系统(iOS 或 Android)
发送直通回传
[新字段] 如果合作伙伴已配置为接收有关直通浏览的反馈,则为 True。
点击归因回溯窗口 为该合作伙伴和应用程序站点配置的回看窗口
回帖类型 此行中描述的特定回传是针对安装还是事件。
事件回看类型 回看窗口选项:
- 接触点:时间范围从归因于安装的广告点击/浏览开始。
- 安装:时间范围从安装开始。
- 无:事件回溯无时间限制。
事件回溯窗口 回溯窗口,用于根据事件回溯类型将事件回溯限制在指定的时间范围内(以天为单位)。
事件 SDK 名称
[字段名称已更改 原为 "事件"] 如果此行中描述的回传是针对一个事件: 该事件的奇异 SDK 名称。
事件合作伙伴名称
[新字段] 如果本行中描述的回传是针对一个事件:事件的合作伙伴名称,在合作伙伴配置中映射。
仅归属 是对所有此类事件进行回传,还是仅对归属于特定合作伙伴的事件进行回传。
回传 URL 回传的完整 URL,包括奇异宏。
创建日期
[新字段]配置的创建日期
上次更新日期
[新字段] 配置的最后更新日期
回传 URL 是否自定义 [新字段] 是/否(此字段仅在此 Singular 客户启用灵活回传功能时可用)。
跟踪器名称过滤器
[新字段] 过滤器名称或 "无过滤器"(此字段仅在此 Singular 客户已启用灵活回传功能时可用)。
有限数据共享限制 [新字段] 真/假(此字段仅在此Singular 客户已启用限制数据共享功能时可用)。
有限数据共享默认值 [新字段] 真/假(此字段仅在此单一客户已启用限制数据共享功能时可用)。
国家限制类型 [新字段] "包括 "或 "不包括"(此字段只有在此 Singular 客户已启用相关功能时可用)。
国家限制 [新字段]以逗号分隔的国家名称列表(全名,而非国家代码)(此字段仅在此 Singular 客户已启用相关功能时可用)。

设置和回传

如何仔细检查发送给网络合作伙伴的回传内容,例如用于计费和开票?
为什么我需要在设置合作伙伴时选择应用程序和应用程序站点

合作伙伴设置是为每个应用程序站点单独配置的。

要求我输入的安全密钥/令牌/密码是什么?

Singular通常需要某些凭证才能向合作伙伴发送回传。请向合作伙伴索取相应的凭证。

什么是重新参与回传

这些回帖用于通知合作伙伴重新吸引成功。启用这些回帖的选项仅适用于支持再参与营销活动(重定向营销活动)的合作伙伴。

什么是浏览归因

直通属性是根据广告浏览而不是广告点击确定的属性。如果您运行任何直通广告系列,请选择 "包含直通属性",这样Singular就会向合作伙伴发送有关这些属性的反馈(否则,Singular只会发送有关点击属性的反馈)。

注意--应用内事件的浏览属性将由安装或重新吸引属性设置决定。这意味着,只有在安装或重新吸引时启用了 "直通 "属性,才会将其应用于应用内事件。

什么是欺诈回溯?

欺诈回溯包括有关 Singular 欺诈检测系统所做决定的信息。要了解更多信息,请参阅欺诈回溯。此外,请参见Singular欺诈预防,了解Singular先进的欺诈检测方法。

什么是归因回溯窗口?

请参阅"归因回溯窗口"。

什么是回溯窗口起点?

这是一个回溯窗口,用于将事件回溯限制在指定的时间范围内,例如安装后 5 天。如果事件发生在指定天数之后,则不会发送回传。发送归属安装后事件的默认时间是归属接触点的 7 天(请参阅下面的 "接触点 "定义)。

什么是应用内事件

应用内事件是指转换后在应用中发生的任何用户事件。例如,用户安装了您的应用程序后,可能会登录或注册您的平台、观看教程,如果是游戏应用程序,还可能会提升等级。一些合作伙伴希望从 Singular 的归因服务中接收有关这些事件的反馈。

如何配置事件回传

image4.png

首先,选择要发送的回帖:

选项 意义
全部 向该合作伙伴发送有关所有应用内事件的回帖
仅当安装归属于 X 时 只有当应用安装归属于该合作伙伴时,才向该合作伙伴发送有关应用内事件的回帖。
关闭 从不向该合作伙伴发送应用内事件的回帖。

接下来,添加应用程序内事件如下:

字段 字段
应用内(SDK)事件名称 您的应用程序通过 Singular SDK 集成发送的事件名称。
事件名称 合作伙伴识别到的事件名称或 ID(合作伙伴通常会有一个能识别到的事件列表)。

回传窗口起点

(原为回看)

设置回溯窗口,将事件回溯限制在指定的时间范围内,例如安装后 5 天。如果事件发生在指定天数之后,则不会发送回传。在发送归属的安装后事件时,默认时间为归属的接触点(见下文 "接触点 "定义)起 7 天。

选项:
- 接触点时间范围从归因安装的广告点击/查看开始。
- 安装时间范围从安装开始。
- 无限制(仅限企业):事件回传无时间限制。归因于媒体源的事件仍将被发送,即使安装或重新参与归因于 30 多天前。当在 Analytics --> Reports 中提取 "Actuals "计数时,此选项可使 CPE(每次活动成本)活动目标的媒体源报告数字与广告商的单一报告相匹配。

注意:安装后事件会在事件发生时发送。

天数 回溯窗口的长度(天数)。
包含收入值 对于收入事件,在回传中包含收入信息(如果不勾选该复选框,Singular 将只发送事件计数)。
有哪些不同的收入事件(__IAP__、__REVENUE__、__ADMON_ USER_LEVEL_REVENUE__)?我应该为哪个事件配置回传?

应用程序内(SDK)事件下拉菜单中,您会看到几个不同的收入相关事件,其中有些事件是重叠的。

为防止对同一应用内事件重复发送回帖,请按以下说明操作。

收入事件名称
说明

__IAP__

由任何应用内购买触发的事件,SDK/S2S 实施中未赋予自定义名称。

(自定义收入事件)

在 SDK/S2S 实现中被赋予自定义名称的应用内购买事件也会出现在列表中。
__admon_ user_level_revenue__ 由广告货币化收入触发的事件(如果使用发送 SDK 事件的方法设置了广告收入归属)。
__REVENUE__

由进入应用程序的任何收入触发的事件(包括 __IAP__ 、自定义名称的购买事件和广告收入事件)。请参见下面的警告。

如果只有应用内购买收入,该怎么办?

  • 为 __IAP__ 和任何自定义购买事件设置映射。
  • 或者使用 __REVENUE__,它包含所有应用内购买事件。

如果既有应用内购买收入,又有广告收入,该怎么办?

  • 为 __IAP__ 、任何自定义购买事件和 __ADMON_USER_LEVEL_REVENUE__ 设置映射。
  • 在这种情况下,我们建议使用通用事件 __REVENUE__,因为它包括购买和广告收入事件,在网络侧将两种收入映射到同一收入事件可能会导致问题。
  • 相反,应将应用内购买事件映射到网络的购买事件,将 __ADMON_USER_LEVEL_REVENUE__ 事件映射到网络的劝诫或广告收入事件。
  • 如果不确定在网络方面使用什么事件,请联系网络了解详情。

警告:如果您对合作伙伴的现有配置是发送__REVENUE__回传,而您除了应用内购买事件外还开始有广告收入事件,如果合作伙伴网络没有设置为接收广告收入事件或需要将它们映射到一个单独的事件,这可能会导致问题。请与网络联系,了解是否以及如何发送广告收入回传。

如何更新合作伙伴集成和回传配置?

Singular的集成团队会与合作伙伴保持联系,以确保我们拥有最好的集成。有时,合作伙伴可能会要求您更新集成,例如,由于合作伙伴希望从Singular接收回传的方式发生了变化。

在大多数情况下,您可以登录Singular,进入 "合作伙伴配置"页面,打开集成,然后重新保存,即可更新集成。

在某些罕见的情况下,更新可能需要更多步骤,比如提供以前不存在的新字段或设置。在这种情况下,合作伙伴或 Singular 将与您联系并提供说明。

我可以对合作伙伴集成进行全局更改吗?我可以更新合作伙伴配置的默认设置吗?

虽然合作伙伴的配置设置可能看起来相似,但每个配置都是唯一集成在 Singular 中的。目前无法同时更新多个配置。