简介
The integrated partners setup guide explains how to connect AppsFlyer to your integrated partners enabling attribution recording and postbacks.
When you start working with a new ad network, you set up an account with the new ad network and then configure the ad network in AppsFlyer. Doing so enables you to attribute the ad networks installs and to record post-install events.
Before AppsFlyer, connecting to the ad network and recording attributions required weeks of development and testing time. Integrating the network’s SDK into your app so as to be able to attribute installs and record in-app events.
Today, using AppsFlyer's SDK and dashboard you can configure mobile traffic attribution with AppsFlyer's 4000+ integrated partners in minutes.
See the full list of integrated partners.
Set up the integration.
重要信息!
As of March 2019, both advertisers and agencies, require an initial manual activation. Partner integrations, which produced conversions during the period December 2018 to February 2019, are automatically enabled. For more info, click here.
已对接合作伙伴列表
To open the integrated partners list, in AppsFlyer, go to Configuration > Integrated Partners.
In the integrated partners list you can search for an integrated parnter by:
- View and select any of the available partners
- Free text search
- Refine your search, using filters
Integrated partner types
- AppsFlyer的大部分已对接合作伙伴致力于为移动营销人员获取高质量用户。被视为广告平台的已对接合作伙伴类型包括广告网络、联盟网络、直接发布商、程序化广告和中国国内广告网络
- 代理商
- 利用他们的专业知识从其他广告平台获取高质量用户
- 营销合作伙伴
- 与代理类似,营销合作伙伴擅长与特定广告平台合作,其中包括Facebook营销合作伙伴,Apple Search Ads营销合作伙伴以及Twitter官方广告合作伙伴
- 再营销广告平台
- 专注访客找回活动的广告平台
- 第三方平台
- 已对接平台主要用于BI相关的目的,包括分析或营销自动化平台
- 电视归因
- 合作伙伴能够更准确地将新增安装归因给播出的电视广告
- 假量监测
- 第三方外部反作弊系统是区别于AppsFlyer Pretect360反作弊解决方案的外部系统。
可以勾选合作伙伴类型的复选框来筛选这类合作伙伴的结果。点击清除全部即可清除所有选项, 并查看列表中所有类型的已对接合作伙伴。
可用的合作伙伴筛选器
在已对接合作伙伴列表里选中按合作伙伴状态筛选框,即可仅显示活跃配置。活跃配置指的是已开启归因或在过去7天内有过至少一次归因链接点击的合作伙伴。
分合作伙伴类型的可用选项卡
当选中和点击某个合作伙伴的对话框时,其设置窗口就会打开第一个可用的设置选项卡。根据合作伙伴类型, 每个合作伙伴最多有5个设置选项卡:
合作伙伴类型 | 对接页面 | 归因链接页面 | 成本选项卡 | 广告收入选项卡 | "权限" 选项卡 | 备注 |
---|---|---|---|---|---|---|
媒体渠道 | Y | Y | Y | Y | Y | 包括广告平台、网盟、直接发布平台、程序化广告、中国国内广告平台以及访客找回平台。 归因链接不适用于自归因平台 |
代理 | N | N | N | N | Y | 不作为广告平台的纯代理 |
第三方 | Y | N | N | N | N | 分析或营销自动化平台 |
营销合作伙伴 | Y | N | N | N | N |
合作伙伴激活
The first thing you need, to start working with an integrated partner, is to activate it.
In the Integration tab, enable Activate Partner:
- 启用对接选项卡参数的设置
- 允许将安装和事件归因给该合作伙伴
- 允许该合作伙伴接收回传
重要信息!
The Activate Partner toggle must not be used to pause or turn off campaign attribution!
Disabling the partner integration and may cause irreversible damage to your active campaigns.
有关合作伙伴激活的常见问题解答、使用案例和更多详情, 请点击此处。
合作伙伴设置选项卡
按照以下常规步骤设置与合作伙伴的归因。
合作伙伴标题
对接页面
对接选项卡可分成几个不同部分。请注意,每个合作伙伴的对接要求不同,且通常包含所有下述部分的子集。
常规设置
本节用于连接合作伙伴和AppsFlyer。广告主也可以在这里看到关于该合作伙伴的相关消息。
激活合作伙伴
有关详细信息,请参阅上面的合作伙伴激活段落。
合作伙伴 ID
部分合作伙伴需要通过其授予广告主的唯一ID来连接AppsFlyer。这些ID可被称为app ID、账户 ID、用户 ID、平台 ID等。
开启展示归因
如果希望获取该合作伙伴的展示归因,要在这里设置为开启。
自归因平台-该标签页显示的是展示归因窗口期滑块。
非自归因平台-如果没有激活,也可以在归因链接标签页(如下所述)找到该滑块。不过,在这种情况下,AppsFlyer会忽略展示归因滑块上设置的任何值。
默认回传
如果该合作伙伴激活了归因/对接,AppsFlyer就会自动回传接下来的用户安装、启动、再互动以及拒绝安装等。可以用该部分定义发送回传的用户来源。
”仅限归因给该合作伙伴的事件“用于仅仅发送来自该合作伙伴的事件。“来自任何合作伙伴或自然量的事件”会把所有渠道获取的全部用户发送给该合作伙伴。
应用内事件设置
可以在这里通过回传把AppsFlyer事件映射给合作伙伴。
- 如果需要, 请在此处再次设置合作伙伴 ID
- 将应用内事件回传切换为 打开
- 为所有 SDK定义的事件选择发送选项。
- 仅发送来自该合作伙伴的事件用于仅发送归因给该平台的用户事件
- 来自任何合作伙伴或自然量的事件会把所有渠道获取的全部用户发送给该合作伙伴
- 点击添加事件把SDK事件添加到列表
- 填写以下参数:
参数名称 | description |
---|---|
SDK 事件名称 | 事件名称, AppsFlyer会从应用中集成的 SDK 或从服务器到服务器事件中接收。 提示-如果在列表中看不到要查看的事件,可以在具有非自然安装的设备上激活该事件,然后重新检查。 |
合作伙伴事件标识符(Event Identifier) | 由合作伙伴定义的唯一事件名称或ID。这里有多个选项: 文本字段 - 从合作伙伴处获得相应的event ID。 下拉框-为您的活动选择最适合的预定义活动。有些对接含有自定义值,这样就可以把SDK事件原封不动地发给合作伙伴。 |
发送收入 | 未勾选时-AppsFlyer仅发送事件,不发送事件值。 勾选时-AppsFlyer会把包括收入值(如果某事件有收入的话)在内的所有参数发送给合作伙伴。 |
注意
-
可以选择或键入SDK事件名称。
键入的值可以在事件名称之前或之后带有空格, 在这种情况下, 这些值是带下划线的。只有在SDK事件名称中具有相同空格时,才在键入的事件名称中包含空格。 -
如果对接选项卡中不存在应用内事件回传部分, 则表示该合作伙伴未在其初步配置中设置AppsFlyer应用内事件记录。该合作伙伴可以联系AppsFlyer 的合作伙伴团队来完成对接。
- 为了防止广告主无意中与第三方分析平台分享过多信息, 我们已从2019年3月起删除了发送所有事件选项。在此之前配置的分析平台仍保留此设置选项。
归因链接页面
请注意, AppsFlyer 不会保存生成的合作伙伴归因链接。
注意
对于所有的SRN,例如Facebook、Apple Search Ads、Snapchat等,这个标签页不适用,因为他们不使用外部归因链接。
归因链接参数
该选项卡可分成几个不同部分:
在本节中, 选择要添加到归因链接中的参数。
在归因链接里添加更多参数可以便于日后进行进一步的深入分析。归因链接中预定义的参数,可以通过添加参数和定义新值的方式进行编辑。
- Campaign - 添加该参数以比较自有媒体的不同广告活动。
归因链接参数: c - 广告集-设置广告集名称可以比较该媒体渠道某具体广告系列活动的不同广告集之间的表现。
归因链接参数: af_adset - 广告名称-设置广告名称可以比较该自有媒体渠道某具体广告集中不同广告的表现。
归因链接参数: af_ad - Site ID 和Sub Site ID - 设置子渠道ID参数可以把安装归因给具体的发布平台。如果有许多发布平台, 我们建议限制所使用的site ID数量, 并使用sub site ID 参数, 以避免超出site ID 限制。
归因链接参数: af_siteid and af_sub_siteid - 订阅者参数-使用5个订阅者参数中的任何一个来插入有用的值。这些参数会被解析并显示在原始数据报告里,进而使汇总或筛选数据变得非常方便。归因链接参数: af_sub1, af_sub2, af_sub3, af_sub4, af_sub5
只需在新参数框中输入, 即可将任何其他参数添加到归因链接中。可以在这里找到所有的可用 AppsFlyer URL 参数: AppsFlyer 归因链接结构和参数
再营销设置
开启后,会在归因链接中添加&is_retargeting=true参数,然后AppsFlyer会把这个链接识别为访客找回
归因链接,而非用户获取链接。请注意,目前访客找回活动只支持点击归因,而不支持通过展示归因。
归因链接参数: is_retargeting
启用访客找回时, 将显示以下设置。
-
标准链接 vs. OneLink
下述情况下选择标准归因链接选项:
- 您的URL不需要深度链接或
- 计划仅使用URI Scheme深度链接
下列情况下,选择使用 OneLink:
- Android和iOS应用共用同一个链接或者
- 深度链接使用Universal link或者app link
请注意, 选择OneLink会把具体应用专属的点击记录链接变成 OneLink URL。
-
深度链接URL
如果该链接旨在将用户深度链接到应用中的任意特定活动,请使用此字段。
归因链接参数: af_dp
可以在AppsFlyer深度链接解决方案指南中查看更多详情。 -
再互动窗口期
设置再互动窗口期,发生在窗口期内的应用内事件会归因给相应访客找回的媒体渠道。这个值可以设置为数天(1-90天)、数小时(至多23小时)甚至是终生。
归因链接参数: af_reengagement_window
点击型归因
可以拖曳这个滑块来设置点击到安装时间的最长时间。只有发生在归因窗口期内的安装(首次启动)才有可能会被归因给该合作伙伴。
归因链接参数: af_click_lookback
点击查看更多关于点击归因窗口的信息。
点击归因链接
这就是包含了所有设置信息的归因链接。
由于AppsFlyer不会保存合作伙伴的归因链接,因此,请复制生成的链接并将其发送给潜在客户点击广告时激活的相应合作伙伴。
浏览型归因窗口期
可以拖曳这个滑块来设置最大展示至安装时间。在广告展示之后,在没有其他相关点击的情况下,只有发生在归因窗口期内的安装(首次启动)才有可能会被归因给该合作伙伴。
您可以将这个值自定义为1-23小时或1-7天。
归因链接参数: af_viewthrough_lookback
更多关于展示归因的信息在这里。
展示归因链接
展示归因链接里含有与点击归因链接相似的归因数据(除了窗口期不同之外)。将该链接发送给合作伙伴, 以便在相应广告被观看1秒或更长时间时激活该链接。
成本选项卡
成本选项卡通过合作伙伴提供的广告支出成本来丰富归因数据, 如果合作伙伴支持发送成本数据。
对部分合作伙伴而言,获取成本数据也可以获得点击和展示数据。
获取成本数据
支持成本数据的广告平台要么提供特殊的API, 要么在点击链接上提供安装成本数据。
点击类广告平台会自动提供成本数据,而API广告平台需要进行一些设置,示例如下:
Enable Get Cost Data to display the required setup for cost data. Follow the specific instructions on the partner's cost section.
例如, 在上面的截图中, 合作伙伴要求设置该合作伙伴给出的唯一用户API 密钥。
要获取支持成本数据的合作伙伴完整列表, 请访问此处。
在某些情况下, 合作伙伴会自动把成本数据包含在每个归因链接中。在这些情况下, 将显示如下消息:
要获取支持成本数据的合作伙伴完整列表, 请访问此处。
成本数据同步状态
成本选项卡显示成本集成的状态以及 AppsFlyer 上次成功提取匹配成本数据的时间。这个适用于支持通过 API 获取成本数据的广告平台。
下表描述了五种不同的状态消息, 以及在成本选项卡中看到它们时应执行的操作。
状态消息 | description | 应对措施 |
---|---|---|
有效的 |
合作伙伴 API 正在响应并返回数据。 |
无 |
有效的
同步消息: 成本数据从未成功提取 |
可能原因如下:
|
|
没有匹配的数据
|
AppsFlyer使用合作伙伴API 查询此应用的活跃广告系列, 但合作伙伴 API 未返回这些广告系列的任何数据。 |
如果在广告系列仍在进行时更改广告系列名称, 则可能发生这种情况。
如果依赖于成本数据, 请不要在广告系列活动仍处于活动状态并正在运行时更改其名称。
此外, 请确保输入的API凭证是该应用相对应的, 并且广告平台在归因链接中上传了正确的广告系列ID。 |
合作伙伴 API 没有响应 |
广告平台成本数据 API 已关闭或遇到问题。 |
等待该平台API 开始响应。 |
无效证书 |
成本API 证书错误。AppsFlyer 无法提取成本数据。 |
确保成本 API 密钥是正确的。 |
最近一次成功提取数据
成本选项卡显示最近一次提取成本数据的时间。如果从未提取成本数据, 则同步消息显示成本数据从未成功提取。
示例
举例
Scenario 1: Stopped campaigns
AppsFlyer提取您在A广告平台投放的多个广告系列的成本。在成本选项卡中看到的是上次成功同步是2小时前。同一天,您停止了A广告平台上正在进行的广告系列。两周后查看A平台的成本选项卡,看到的是上次成功同步是14天前。
Scenario 2: Ad network API issues
AppsFlyer提取您在B广告平台投放的多个广告系列的成本。在成本选项卡中看到的是上次成功同步是2小时前。然后, B广告平台发生了API问题。他们花了几个小时才修复这个问题。这时在成本选项卡中看到的是上次成功同步是8小时前。
OAuth广告平台
OAuth 网络 (谷歌、脸书) 允许同步多个账户来提取成本数据。对于每个已同步的帐户, AppsFlyer 显示成本集成的状态以及 AppsFlyer 最后一次成功提取匹配成本数据的时间。
广告收入选项卡
只有当您作为广告发布平台向用户展示合作伙伴的广告时, 此部分才具有相关性。有鉴于此,您肯定希望衡量从不同渠道获得的用户的参与度,以便找到利润最高的渠道。
设置获取广告收入数据按钮, 以显示获取该平台收入数据所需的设置。按照该平台广告收入部分的具体说明进行操作。例如, 上面的截图中,该平台要求的就是简单的系统登录而已。
要了解更多有关广告收入 (即广告变现) 记录的信息, 请访问此处。
权限选项卡
在此选项卡中, 可以选择授予合作伙伴的权限, 无论该合作伙伴是广告平台、代理, 还是两者兼而有之。注意,即使没有启用对该合作伙伴的归因,也仍然可以通过权限选项卡给该合作伙伴授权。
When you enable permissions for a partner, only this partner gets permission to your app. Other partners don't get permissions to your app unless to choose to.
重要信息!
For an ad network or agency to see your app in their dashboard and be able to view data related to the app, you must at least enable Ad Network Permissions. Additional permissions can be granted. These are discussed below.
Partner set up is visible to ad networks when it's done by advertisers, but not when it's done by agencies. Therefore, when an agency, but not the advertiser, configures the ad network integration, the ad network sees this section as inactive, although it is actually active for the agency.
In case you're working with the partner as an agency only, disregard the Ad Network Permissions section and go straight to the Agency Permissions section.
广告平台权限
打开广告平台权限以配置广告平台权限。
Once you toggle Ad Network Permissions on:
- The app appears on the ad network's dashboard
- Permissions are granted only to this ad network
- The ad network admin can see basic data about the app
给广告平台团队成员授权
To give specific ad network team members permissions to manage your app. The ad network admin has access by default. Before you can add ad network team members, contact the ad network to get the team members emails
- Get the emails addresses of ad network team members
- Verify with the ad network that the emails are correct
- 点击添加团队成员
- 输入广告平台团队成员的电子邮件
- 点击添加
- 如果需要, 重复此过程以添加更多团队成员
Once you enable permissions for the ad network, decide what permissions you want to grant it and its team members.
通过这些开关给广告平台授权处理他们自己的应用配置:
- 允许配置对接-允许合作伙伴设置对接选项卡 (应用内事件回传除外)
- 允许配置应用内事件回传-允许合作伙伴在集成选项卡上设置映射给其自身的应用内事件回传
- 允许访问留存报告-仅允许访问该合作伙伴自己的留存数据
- 允许查看累积的忠实用户数量 - 仅允许访问该合作伙伴自己的忠实用户数据
- 允许查看累积的应用内事件数量 - 仅允许访问该合作伙伴自己的应用内事件数据
- 允许查看累积的应用收入数据 - 仅允许访问该合作伙伴自己的数据
- 允许访问Protect360控制面板-仅访问该合作伙伴自己的Protect360数据,前提是广告主有开通该功能
了解更多关于广告平台权限的详情。
代理权限
通过这些开关给广告平台授权处理他们自己的应用配置:
- 主开关-将其设置为ON:
1. 可显示代理权限选项
2. 可以把安装归因给相应代理。
3.允许代理查看Facebook和Twitter营销数据警告--在开关关闭期间发生的安装不会归因给代理, 也不会显示在代理的控制面板和数据上。(更多详情) - Allow access to your retention report - retention data created by the users brought by the agency only (more details)
- 允许访问汇总的自然数据
- 允许配置应用内事件回传-允许代理在集成选项卡上设置映射给其自身的应用内事件回传
- 事件共享权限 -在此处选择您的首选选项:
a) Only events attributed to this partner - send only events from agency's own brought traffic to the app
b) Events attributed to any partner or organic - send events from all sources of your traffic, including other media sources, agencies, and organic users - Allow to send event revenue - permit the agency to send events including their monetary value
- Make sure to select specific events you want to grant the agency permission to. Click Add event and pick the event from the drop-down list. Do this for each event you want to add.
- 事件共享权限 -在此处选择您的首选选项:
Once you grant permissions to agencies, consider the following:
- When you grant permissions to agencies, they can grant the ad networks they work with permissions to manage your apps. It’s the same as granting permissions to ad networks.
- If you work with an ad network, and your agency also works with this ad network, both of you can edit the ad network team members permission to view the app’s dashboard.
- If you see new ad network team members or missing team members that you didn’t add or remove, it’s possible that your agency added or removed them.
了解更多关于代理合作的详情。
为什么要测试已对接合作伙伴?
AppsFlyer已经与数千家合作伙伴实现对接,通过AppsFlyer控制面板可以轻松开始归因这些平台的营销活动。
无论如何,我们强烈建议在增加广告预算前测试所有要合作的新平台。
很多错误都出现在设置过程中。事前测试可以避免把可观的资源浪费在发现归因数据缺失或错误上。
重要信息!
确保首先测试应用的基础SDK对接-自然和非自然安装。
测试归因链接
占所有已对接广告平台99.5% 的常规广告平台都根据AppsFlyer的归因链接来归因。自有媒体归因也是如此,通过AppsFlyer的自定义归因链接来归因。
正确的归因取决于其归因链接上的参数, 因此最好在开始常规广告平台或自定义归因链接营销活动之前进行测试。
为新合作伙伴或营销活动创建归因链接后:
- 要把这个新的归因链接发送到白名单测试设备上(通过电子邮件或二维码)
- 点击链接-确保被重定向到应用商店
- 安装应用程序
- 启动应用
- 在控制面板上查看该安装有否出现在该合作媒体渠道名下
- (在数据总览页面的媒体渠道筛选框里选择相应媒体渠道名称)进入营销活动层级查看该安装有否出现在正确的营销活动名下
- 必要时,可深入到下一层级的广告集甚至单独广告层级
测试自归因平台
所有自归因平台,包括Facebook、Apple Search Ads、Google Ads、Snapchat等,都不依赖外部归因链接来归因。相反,自归因平台会收到AppsFlyer的查询,自行归因后返回答案。
因此,无法像常规广告平台一样脱离其平台系统对自归因平台进行对接测试。
然而,与任何新SRN合作之前进行测试是很重要的。
那要怎么测试呢?
- 在 AppsFlyer上执行完整的SRN设置
- 必要时查询相应的平台配置指南,比如 Facebook, Google Ads, Twitter, Apple Search Ads, Snapchat 等。
- 在该SRN平台上投放一个新的低预算营销活动。
- 当该合作伙伴的控制面板上显示新增安装时,前往AppsFlyer控制面板查看该安装是否显示在相应平台名下
- (在数据总览页面的媒体渠道筛选框里选择相应媒体渠道名称)进入营销活动层级查看该安装有否出现在正确的营销活动名下
- 必要时,可深入到下一层级的广告集甚至单独广告层级
如果一切正常,就可以开始在这个平台上投放新的高预算营销活动。同时,无需为新的营销活动重复该测试。
使用原始数据进行高级测试
原始数据是可以挖掘营销宝藏的地方。如果您的AppsFlyer帐户有原始数据权限,那就应该在合作平台测试中使用原始数据:
- 执行上述测试后, 前往导出数据页面
- 确保选择了已测试的媒体渠道
- 安装之后最多需要等15分钟, 就可以下载原始安装数据报告
- 检查该合作伙伴的安装记录是否存在并包括媒体渠道、广告系列名称、触达时间及类型、设备 ID (IDFA 或广告 ID)、代理名称 (报告中称为 "合作伙伴") 之类的参数。