通过Push API获取原始数据

消息特征

可用的消息类型

专属字段

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

相关文档：SKAN原始数据字段。Push API消息的结构和字段与其对应。 

消息特征：

SKAN归因的消息类型

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

服务器端要求

请注意：这里使用了一个为时4秒的计时机制，如果在这4秒内AF的服务器没有接收到发送成功的消息，那么系统就会认为该消息发送失败。 

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

端点 

端点规划表

不可以。	配置	说明	在本栏中记录您的设置规划
1	方法	POST 或者 GET
2	端点URL	-
3	事件消息类型	选择至少一种事件消息类型。 必须要先记录到至少一个应用内事件后，您才能勾选对应的应用内事件消息，否则该选项将显示为不可用。
4	字段   字段列表是所有消息类型共有的	警告 如果您勾选了全选，所有新添加的字段都会自动选中。这时，请确保您能够支持所有自动添加的新增字段，以免出现问题。 选择所需的字段。 最常用的字段是默认勾选的 空/null的字段不会被发送
5	应用内事件类型	您可以按应用内事件进行筛选，以控制发送到端点的流量。 您可以选择一个、多个或所有应用内事件。请注意：如果事件未显示在列表中，请直接搜索该事件。  如果点击全选，系统会自动添加新的应用内事件  应用内事件必须至少被记录到一次，相应的消息选项才会显示为可选。 必要情况下可使用S2S来发送事件。

请注意：只有AppsFlyer账户所有者才能更改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地址加白。 
   请注意：这里使用了一个为时2秒的计时机制，如果在这4秒内AF的服务器没有接收到发送成功的消息，那么系统就会认为该消息发送失败。 
2. 为确认您的端点是否接收到了测试消息，
   您可以查看测试消息的副本。 

请注意：只有AppsFlyer账户所有者才能更改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就开始生效，将数据发送到端点。  

通过使用Push API身份验证令牌，客户可以无缝接入并保护其Push API消息安全，只需为请求的令牌添加一个可自定义的授权header即可。
您可以通过为每个App ID定义令牌名称和值，自定义随Push API消息一同发送的授权 header。这样不仅可确保消息的安全性，也能满足您的特定需求。

请注意：只有AppsFlyer账户所有者才能更改Push API设置。其他类型的用户只能查看该设置。

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

1. 报告> API数据接口向下滚动到Push API部分。
2. 找到要修改的端点。
3. 进行修改。
4. 点击Save。

请注意：只有AppsFlyer账户所有者才能更改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，以及错误消息截屏。

不可以。Push API仅支持使用header传递身份验证令牌。不支持额外的自定义header（如consumer-key）。

如果需要传递额外参数，请将其包含在URL中。使用场景示例:

https://your.server.com?consumer_key=abc456