通过Push API获取原始数据

本章节重点说明SKAN框架中的可用消息（报告类型），以及如何判断消息类型。请先通读本章，然后参考SKAN归因端点设置指南。

您还可参考SKAN原始数据字段，因为Push API消息的结构和字段与其对应。

判断SKAN归因中的消息类型

请确保您的服务器符合以下要求：

• 请参照下表说明，规划您的AppsFlyer归因端点设置，下图中的数字与下表中的行数相对应。
• 本节内容不涉及SKAdNetwork，有关SKAN归因的说明请参见SKAdNetwork归因设置。 

端点 

• 仅管理员用户可更改API设置，账户用户只能查看Push API设置。

请按以下步骤添加AppsFlyer归因端点：

1. 从AF后台进入对接 > API数据接口，向下滚动到Push API部分。
2. 单击添加端点。
3. 选择HTTP方式：POST或GET
4. 输入端点URL。 如果收到this URL is not safe（该URL不安全）的消息，请联系AppsFlyer技术支持。
5. 选择一种或多种事件类型。请注意：如果应用内事件消息显示为不可用，说明尚未记录到任何应用内事件。 
6. 选择Push API消息中需要包含的字段。请注意：
   
   • 消息中始终包含必填字段：应用ID、事件名称、事件时间、IDFA（iOS）或Advertising ID（安卓）
   • 您可使用下图所示的控件来选择可选字段。

     

     • 最常用的字段是默认勾选的，您可以手动取消这些选项。
     • 根据需要选择可选字段。
     • 点击清除全部，清除所有可选字段。
     • AF系统不会发送null/空的字段及其对应的键，这在数据入库BI和解析过程中需特别留意。
7. 选择一个或多个事件（最多52个），也可选择“所有应用内事件”。
   
   • 该列表中只包含已经记录到的事件类型。如果其中没有显示您想要的事件类型，请先使用测试设备发送这类事件。
8. 点击保存后，该Push API就开始生效，将转化数据发送到端点。
9. 请按以下步骤测试端点。

测试端点：

1. 点击发送测试
   发送测试按钮下方会显示测试结果。
   测试消息发送到端点后，如果显示测试失败，请确保您已对AppsFlyer服务器的IP地址加白。
   请注意：这里使用了一个为时3秒的计时机制，如果在这3秒内AF的服务器没有接收到发送成功的消息，那么系统就会认为该消息发送失败。
2. 您可以查看测试消息的副本，以此来确认您的端点是否接收到了测试消息。

请注意：仅管理员可更改API设置，账户用户只能查看Push API设置。

请按以下步骤添加SKAdNetwork Push API端点：

1. 从AF后台进入对接 > API数据接口，向下滚动到Push API部分。
2. 选择SKAdNetwork作为归因实体。  
3. 点击添加端点。 
   请注意：您可以为每个应用定义1-3个SKAdNetwork端点。 
4. 选择HTTP方式：POST或GET
5. 输入端点URL。 如果收到this URL is not safe（该URL不安全）的消息，请联系AppsFlyer技术支持。
6. AF系统不会发送null/空的字段及其对应的键，这在数据入库BI和解析过程中需特别留意。
7. 点击保存后，该Push API就开始生效，将数据发送到端点。 

请注意：仅管理员可更改API设置，账户用户只能查看Push API设置。

请按以下步骤修改端点设置：

1. 从AF后台进入对接 > API数据接口，向下滚动到Push API部分。
2. 找到要修改的端点。
3. 进行修改。
4. 点击保存。

请注意：仅管理员可更改API设置，账户用户只能查看Push API设置。

请按以下步骤删除端点 ：

1. 从AF后台进入对接 > API数据接口，向下滚动到Push API访问部分。
2. 单击删除端点 。
3. 点击保存后，端点就会被删除。

如果您的服务器通过IP地址来限制访问，在这种情况下没有接收到测试消息可能是因为没有对所有的AppsFlyer IP地址加白。 

如果用户点击了再营销广告并产生了付费事件，而该事件又发生在UA再互动窗口期内，这时再营销应用内事件就会发生重复。这一机制背后的逻辑是要将收入同时归因到UA渠道和再营销渠道。

如果您同时启用了以下两项，就会发生事件重复：

• UA应用内事件
• 再营销应用内事件

事件重复的判断及去重

• 应用内事件必须至少被记录到一次，相应的消息选项才会显示为可选。
• 您可以使用测试设备生成应用内事件，也可以使用S2S API手动生成事件。

如果您使用Amazon CloudFront作为端点，请检查您的CloudFront是否通过421拒绝码拒绝接收消息。如果发生上述情况，请参考如何选择CloudFront对HTTPS请求的响应方式。

具体问题：设置端点URL时显示“this URL is not safe“（此URL不安全）的消息。

应对办法：联系AppsFlyer技术支持，在问题描述中包含应用ID、端点URL，以及错误消息截屏。