在合作伙伴配置页面,您可以配置Singular追踪,以便与您的媒体渠道和其他合作伙伴进行合作。如果您刚刚起步,请参阅如何配置合作伙伴设置和回传。
注意:本指南适用于Singular客户。如果您是Singular的合作伙伴或者想成为我们的合作伙伴,请参阅合作伙伴信息。
疑难解答
如果渠道合作伙伴表示他们没有收到安装/转化或者应用内事件的回传:
- 前往归因(Attribution) >导出日志(Export Logs)并下载合作伙伴的回传日志。有关下载日志的帮助,请参阅导出日志和用户级别数据常见问题。
- 确保使用Response HTTP Code = 200过滤回传。如果Response HTTP Code为“200”,则表示合作伙伴确认他们收到了回传。
- 还要选择Response HTTP Body字段,因为它可能有助于在合作伙伴端查明技术问题。
- 与合作伙伴共享日志以在内部验证数据。如果有许多带有其他响应代码的回传,请告知他们从 Singular 接收回传可能存在技术问题。
一些可能的原因是:
- 回溯窗口:可能为一个或多个事件回传配置了不同的回溯窗口。检查合作伙伴配置页面中的设置。
- 技术问题:由于合作伙伴端的技术问题,合作伙伴可能没有收到一个或更多回传。 如需检查,请参阅为什么我的媒体渠道合作伙伴没有收到回传?
- 重复事件:您应用中的 Singular SDK 会自动生成一个名为 __REVENUE__ 的事件,该事件会在应用内购买时触发。此外,您还可以为不同类型的应用内购买创建自己的 SDK 收入事件。当您配置事件回传时,确保给 __REVENUE__ 或您的自定义收入事件发送回传,但不能同时为两者发送回传。否则,Singular 将为每次应用内购买发送两次回传。
如果渠道合作伙伴表示他们收到的回传没有事件属性:
- 转到归因(Attribution)>导出日志(Export Logs)并下载合作伙伴的回传日志。检查回传的HTTP Body或Target URL字段是否包含事件属性。有关下载日志的帮助,请参阅导出日志和用户级别数据常见问题。
- 如果日志显示确实是在没有事件属性的情况下发送的回传,请复查合作伙伴配置页面中的回传设置。如果您尚未配置要与事件一同发送的附加属性,请立即更改设置。
- 如果设置正确且回传仍然缺失事件属性,请联系Singular以获取支持。
如果您的媒体渠道计费是基于在此期间Singular发送给他们的安装/事件回传的数量,您可以在归因(Attribution)>导出日志(Export Logs)中下载原始日志来复查发送给合作伙伴的回传。
有关导出日志页面的常规疑问,请参阅导出日志和用户级别数据常见问题。
对于回传验证,我们建议下载具有以下设置的日志:
请务必过滤Response HTTP Code中的值“200”,以查看回传接收者成功接收的回传。
不要混淆合作伙伴和回传接收者字段:
- 合作伙伴是事件所属的媒体渠道。
- 回传接收者是接收事件回传的合作伙伴。该事件不一定归因于该合作伙伴(请记住,一些合作伙伴要求接收您所有事件的回传,无论它们是归因于该合作伙伴还是其他媒体渠道,您可以在合作伙伴配置页面中启用该选项)。
附加字段“Is Attributed”进一步阐明回传接收者是否是该事件归所属媒体渠道(“Y”表明是同一媒体渠道,“N”表示该事件归因于另一个合作伙伴,您可以在合作伙伴字段中找到该合作伙伴)。
注意:合作伙伴过滤器将按接收回传的合作伙伴的名称过滤回传,无论是合作伙伴媒体渠道、您的内部 BI、还是第三方分析工具等。
对其他日志类型而言,合作伙伴过滤器是指转化或事件归因到的合作伙伴(媒体渠道)。
常见问题
合作伙伴配置常见问题
当应用安装归因于某个渠道时,Singular将会给该渠道的每位合作伙伴发送回传。 您不能禁用这些回传。
其他类型的回传是可选的,这取决于合作伙伴媒体渠道的偏好:
- 召回归因的回传
- 应用内事件回传
- 未归因到合作伙伴的回传,包括转化(安装/召回)和事件。
请参阅回传服务器IP地址。
- 如果我们收到500到559之间的HTTPS响应代码,Singular会重新发送回传。
- 该机制最多可重试5次。
- 从最初的尝试开始,重试间隔分别为:1、5、15、30和60分钟。
合作伙伴类型和术语
-
一些合作伙伴是媒体渠道、广告代理商等。您为这些合作伙伴配置归因设置,然后创建跟踪链接,跟踪链接包含合作伙伴的自定义宏。您还可以让Singular以自动回传的形式向这些合作伙伴发送有关已归因的安装、欺诈行为的判定等信息。
- 其他合作伙伴是第三方BI系统、欺诈分析服务等。如果您使用此类服务,您可以在合作伙伴配置页面中进行设置,以便他们可以接收回传。
平台版本(或者应用程序平台版本)是为特定平台开发的应用程序版本。您可以分别为每个应用程序平台版本配置合作伙伴设置。
例如,如果您有一个同时在Android和iOS上运行的应用,那么您有两个应用程序平台版本,您可以为每个应用程序平台版本配置合作伙伴设置。
也请参阅应用程序配置常见问题。
作为归因合作伙伴开发集成 过程的一部分,Singular将创建一个回传模板,其中包含合作伙伴支持的所有字段。当您保存新的合作伙伴配置时,Singular开始基于该模板创建回传。
要导出所有合作伙伴的回传配置,请点击合作伙伴配置页面右上角的全部导出。
要导出所选的合作伙伴回传设置,请首先点击合作伙伴左侧的复选框选定一个或多个合作伙伴,然后点击导出所选内容。
此操作将下载一个CSV文件,文件包含每个已配置的回传的信息。
栏目 | 描述 |
合作伙伴 | 合作伙伴名称 |
应用程序 | 应用程序显示的名称 |
长名 | 应用程序的长名或者bundle ID |
操作系统 | 应用程序的操作系统(iOS或者Android) |
已创建 | |
点击型归因回溯窗口 | 为此合作伙伴和应用程序平台版本配置的回溯窗口。 |
回传类型 | 安装或事件 |
安装或事件 | 触发回传的事件名称 |
仅归因于 | 针对所有此类事件发送回传,还是仅在安装归因于特定合作伙伴时发送。 |
回传URL | 包括Singular宏的完整回传URL。 |
设置与回传
合作伙伴设置是为每个应用程序平台版本单独配置的。
Singular通常需要某些凭证才能将回传发送给合作伙伴。请让合作伙伴提供适当的凭证。
此回传是通知合作伙伴,是否有有成功的召回发生。开启此回传的选项只适用于支持召回的广告(再营销广告)的合作伙伴。
浏览型归因是基于观看广告而非点击广告的归因。如果您在运行任何浏览型归因的广告系列,请选择包括浏览型归因,以便让Singular也向合作伙伴发送这些归因的回传(否则,Singular将仅发送点击型归因的回传)。
欺诈回传包括Singular欺诈检测系统做出的决策信息。了解更多信息,请参阅欺诈回传。此外,请参阅Singular欺诈预防 以获取Singular的高级欺诈检测方法介绍。
什么是应用内事件?
应用内事件是指您的应用转化之后触发的任何用户事件。例如,安装您应用的用户随后可能会登录或注册、观看新手引导或者升级(如果是游戏应用的话)。一些合作伙伴希望从Singular的归因服务中接收这些事件的回传。
首先,选择你想要发送的回传:
选项 | 含义 |
所有 | 将所有应用内事件回传发送给该合作伙伴。 |
仅当安装归因于X | 有应用安装归因于该合作伙伴时,才发送应用内事件回传给该合作伙伴。 |
关闭 | 不向该合作伙伴发送应用内事件回传。 |
接下来,按照如下所示添加您的应用内事件:
在应用内(SDK)事件下拉列表中,您会看到多个不同的与收入相关的事件,其中一些是有重叠的。
为了防止同一个应用内事件发送重复的回传,请按照以下说明操作。
收入事件名称 |
描述 |
__IAP__ |
在SDK/S2S集成中未指定自定义名称的任何应用内购买所触发的事件。 |
(Custom revenue events) |
在SDK/S2S集成中指定了自定义名称的应用内购买事件也会显示在此列表中。 |
__ADMON_ USER_LEVEL_REVENUE__ | 由广告变现收入触发的事件(如果您使用了发送SDK事件的方式设置广告收入归因revenue attribution)。 |
__REVENUE__ |
由应用程序内的任意收入触发的事件(包括__IAP__,自定义名称的购买事件和广告收入事件)。请参阅下面的警告。 |
如果您只有应用内购买事件收入怎么办:
- 为__IAP__事件和任何自定义购买事件设置映射。
- 或者,也可以选择使用__REVENUE__事件,它包含了您所有的应用内购买事件。
如果您同时拥有应用内购买收入和广告收入该怎么办?
- Set up mappings for 为__IAP__事件、任何自定义购买事件和__ADMON_USER_LEVEL_REVENUE__事件设置映射。
- 我们不建议在这种情况下使用通用的__REVENUE__事件,因为它同时包含了购买和广告收入事件,并且将两种类型的收入映射到媒体渠道的同一收入事件可能会导致问题。
- 相反,将应用内购买事件映射到媒体渠道的购买事件,并将__ADMON_USER_LEVEL_REVENUE__事件映射到媒体渠道的广告变现或者广告收入事件。
- 如果您不确定在媒体渠道端使用哪些事件,请联系媒体渠道了解详细信息。
警告:如果您现有的合作伙伴配置正在发送__REVENUE__事件的回传,并且除了应用内购买事件之外,您还开始有了广告收入事件, 那么如果您的合作伙伴媒体渠道没有被设置为接收广告收入事件或者将其映射到单独的事件中,则可能会产生问题。与媒体渠道核实,以便确认广告收入回传是否发送,以及如何发送。
Singular的集成团队会一直与合作伙伴保持联系,以确保我们拥有最佳的集成。有时,合作伙伴可能会要求您更新集成,例如,合作伙伴希望从Singular接收回传的方式发生变化。
在大多数情况下,您可以通过登录Singular、转到合作伙伴配置页面、打开集成并重新保存来更新集成。
在极少数情况下,更新可能需要更多的步骤,例如提供以前不存的的新字段或设置。在这种情况下,合作伙伴或者Singular将联系您以提供说明。