广告平台的高级隐私保护指南和回传宏

大部分情况下，流量侧应用和/或广告主应用中的IDFA可能不可用，具体取决于用户的ATT授权状态。这时，AppsFlyer可能会使用汇总层级的高级隐私保护机制和概率建模来完成归因。

【最佳方式】建议发送下表所列的所有参数，以确保您带来的流量能得到充分的归因。

1. 请在点击链接的末尾添加以下参数：

   标识符	点击参数	示例
   Campaign	c	US_20_30
   Campaign ID	af_c_id	12345
   Adset	af_adset	ADSET_1
   Adset ID	af_adset_id	56789
   Ad	af_ad	creative_name
   Ad ID	af_ad_id	34567
   Site ID	af_siteid	abcdefgh12345678
   Subsite ID	af_sub_siteid	abcdefgh12345678
   Channel	af_channel	channel_name
   Ad type	af_ad_type	video
   iOS device model*	af_model	设备型号。可使用的值包括： iphone（全部小写） ipad（全部小写）
   Operating system*	af_os	操作系统版本
   * 您也可以通过用户代理（user agent）提供部分信息，这时我们会优先使用通过具体标识符发送的值。

   
   在点击链接末尾添加广告系列信息

   请参照以下示例在点击链接中添加广告系列信息：

   https://app.appsflyer.com/id123456789?pid=YOUR_NETWORK_ID&c={CampaignName}&af_c_id={CampaignID}&af_adset={adset name}&af_adset_id={adset ID}&af_ad={ad name}&af_ad_id={ad ID}&af_ad_type={Ad type}&af_siteid={PublisherId}

2. 请在点击链接中添加下列必须配置的参数*：
   
   

   注意

   如果您未在点击请求中添加必须配置的参数，则您带来的大部分激活都不会归因到贵平台。

   • IP 
   • User-agent 

   * 若使用跳转到AppsFlyer的HTTP referrer发送点击，则无需任何操作。

   若您使用以下任一方式发送点击，请使用本文所述的数据提取方法在点击链接末尾添加相关参数：

   • 点击请求通过应用内流量跳转
   • 服务器到服务器的点击（又称S2S）

   适用于高级隐私保护归因的参数

   参数	是否必须配置	数据提取方法
   设备语言和区域设置 af_lang	否	NSString *language = [[NSLocale preferredLanguages] objectAtIndex:0]; 【推荐方式】建议您同时提供语言和区域设置，例如en-US。
   用户代理（User-agent） af_ua	是	请使用以下格式提取user-agent： Mozilla%2F5.0+%28iPhone%3B+CPU+iPhone+OS+13_3_1 +like+Mac+OS+X%29 AppleWebKit%2F605.1.15+%28KHTML%2C +like+Gecko%29+Mobile%2F15E148 请务必提取非CFNetwork的user-agent。 user-agent值须经URL编码处理。
   设备IP地址 af_ip	是	最佳方式：设备IP可用时，在af_ip参数中提供IP信息。 次优方式：设备IP可用时，AppsFlyer会使用X-Forwarded-For中的IP（存在于代理服务器请求客户端最原始的IP地址的HTTP请求header）

   
   在点击链接末尾添加参数

   如需通过点击归因链接传递这些必要参数，请参考以下示例：

   https://app.appsflyer.com/id123456789?pid=YOUR_NETWORK_ID&c={CampaignName}&af_c_id={CampaignID}&af_adset={adset name}&af_adset_id={adset ID}&af_ad={ad name}&af_ad_id={ad ID}&af_ad_type={Ad-type}&af_siteid={PublisherId}&af_ua={USER-AGENT}&af_lang={LANGUAGE}&af_ip={IP}

   示例

   GET https://app.appsflyer.com/id123456789?pid=YOUR_NETWORK_ID&c={CampaignName}&af_c_id={CampaignID}&af_adset={adset name}&af_adset_id={adset ID}&af_ad={ad name}&af_ad_id={ad ID} &af_ad_type={Ad type}&af_siteid={PublisherId} &af_ua=Mozilla%2F5.0%20%28iPhone%3B%20CPU%20iPhone%20OS%2012_1_4%20 like%20Mac%20OS%20X%29%20AppleWebKit% 2F605.1.15%20%28KHTML%2C%20like%20Gecko%29%20Mobile%2F16D57&af_lang=en-US&af_ip=11.11.1.11

   * 查询参数须经URL编码处理。

   通过点击链接请求header传递数据

   如需通过点击链接请求header传递数据，请参考以下示例：

   GET https://app.appsflyer.com/id123456789?pid=YOUR_NETWORK_ID&c={CampaignName}&af_c_id={CampaignID}&af_adset={adset name}&af_adset_id={adset ID}&af_ad={ad name}&af_ad_id={ad ID}&af_ad_type={Ad type}&af_siteid={PublisherId} accept-language: en-US,en;q=0. User-Agent: Mozilla/5.0 (iPhone; CPU iPhone OS 13_5_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148 X-Forwarded-For: 11.11.1.11, 222.222.2.222

如需接收高级隐私保护回传，您需要在常规回传对接之外另行设置一个高级隐私保护对接。您可以在AppsFlyer面板中自行配置高级隐私保护回传。

常规模板和高级隐私保护模板的区别

• 每小时发送一批回传。
  • 涵盖所有事件类型。
  • 涵盖归因和拦截回传。
  • 0.001%的回传可能会在之后的批次中发送，最多可能会有24小时的延迟。
• 回传时间与事件实际发生时间无关。
• 时间戳宏：
  • 对于激活和应用内事件，时间戳近似到转化发生时间的小时数。例如，如果事件发生时间为22:55:30，则其上报的时间戳为22:00:00。
  • 按UTC时区上报时间戳。时间戳示例：(2020-07-20 20:00:00)
• 以下参数在高级隐私保护回传中不可用：Click ID、Customer User ID、AppsFlyer ID、IDFA、IDFV、device model、OS version以及carrier。

广告平台进行对接时必须完成的操作：

1. 在AppsFlyer面板中设置您的高级隐私保护回传。
2. 测试高级隐私保护对接。

高级隐私保护回传端点【根据实际需求配置】

高级隐私保护归因可用参数

您可以使用AppsFlyer面板中的回传管理选项设置您的AP回传。

前期准备：

• 如需管理您的高级隐私保护回传，您与AppsFlyer之间必须存在活跃对接。请通过渠道支持微件联系我们，以创建对接。
• 只有账户管理员才能管理回传设置，团队成员无此权限。

请按以下方式设置回传：

1. 从页面顶部导航栏打开账户菜单（点击右上角的邮箱地址，打开下拉菜单）> 回传管理。
2. 选择回传类型：高级隐私保护。
3. 激活配置工具。
   

   

4. 输入端点地址：AppsFlyer会向这些端点发送回传。请输入激活和/或应用内事件的对应URL。
5. 输入回传中需要包含的参数：
   • 参数名称：界面中显示的AppsFlyer参数名称
   • 渠道映射参数：即渠道侧接收到的对应参数
   • 参数值（适用于某些参数）：选择参数值的格式。如在布尔型参数下可选的参数值格式为"true"/"false"或1/0。
   • 激活：勾选需要在激活回传中传递的参数。
   • 应用内事件：勾选需要在应用内事件回传中传递的参数。

   

   高级隐私保护回传宏完整列表。

6. 【可选】在AppsFlyer预定义参数之外添加自定义参数：

   

7. 查看最终的回传模板预览，检查各项配置是否正确无误。

   

8. 点击保存。请注意：保存回传配置后，新配置会立刻生效。

如果出现任何问题，请通过渠道支持微件联系我们。

发送到分析平台的回传分以下两种情况：

• AP关闭时：回传用户级别数据，无限制。
• AP开启时：回传类型取决于用户来源和ATT授权状态，具体请见下表：

分ATT授权状态和用户来源的数据分析平台回传类型

SKAdNetwork是Apple针对iOS设备提供的一种归因技术。高级隐私保护是AppsFlyer汇总层级高级隐私保护（AAP）框架的一部分，是针对AppsFlyer归因的解决方案。AAP能让广告主通过AppsFlyer平台调控用户级别归因数据的可用性。一般情况下，广告平台同时支持AP和SKAdNewtork对接。