SKAdNetwork广告平台对接指南

使用此方法，广告平台将从设备收到的每个回调转发到AppsFlyer。

广告平台

• 接收来自iOS设备的回调
• 向iOS设备的回调中补充以下数据：
  • 广告平台广告系列ID和广告系列名称
  • 从设备收到的IP地址，主要用于地理位置解析。
  • 从iOS设备发送的回调时间戳
• 再发送回调到AppsFlyer

Curl 示例—补充 SKAd 回调数据维度

curl --location --request POST 'https://skadpostbacks.appsflyer.com/api/postbacks' \
 --header 'Content-type: application/json' \
  --data-raw '{
      "version":"2.0",
      "app-id": 888707086,
      "ip": "192.0.2.0",
      "ad-network-campaign-name": "skadnetwork_abc_campaign",
      "source-app-id": 888707074,
      "ad-network-id": "abcabcabc.skadnetwork",
      "transaction-id": "68eb3d91-15f5-44ee-9267-25c7655c20b6",
      "redownload": false,
      "attribution-signature": "MDYCGQCsQ4y8d4BlYU9b8Qb9BPWPi+ixk/OiRysCGQDZZ8fpJnuqs9my8iSQVbJO/oU1AXUROYU=",
      "timestamp": "1596525944",
      "ad-network-campaign-id": "222222",
      "conversion-value": 63,
      "campaign-id": 99
  }'

使用此方法，广告平台使用HTTP重定向命令来307来回应iOS设备发出的SKAdNetwork信息，请求设备将SKAdNetwork回调直接发送到AppsFlyer。 

重定向方法具有以下优点

• 增加广告主的信任度：MMP代表广告主执行。通过向AppsFlyer提供一手回传信息，广告主可以确信，该回传在传输过程中不会受到操纵。
• 广告平台无需做其他处理：广告平台（向设备）使用重定向指令，因此无需处理回传。相比之下，广告平台进行数据补充并转发的方法要求广告平台对回调进行处理，填充进其他参数，然后再将其转发给AppsFlyer

实现

1. 配置您的服务器以使用HTTP 307对SKAdNetwork回调进行响应，将回调信息重定向到 https://skadredirect.appsflyer.com/api/redirects
2. 在SKAdNetwork回调中拼接包含广告系列信息的详细参数，可添加的参数详见下表。特别建议在重定向请求中拼接广告系列的信息。广告系列信息使我们能够利用广告消耗和其他广告系列的数据来丰富SKAdNetwork数据，并使共同的广告主能够有效地优化广告。

重定向的SKAdNetwork请求举例

https://skadredirect.appsflyer.com/api/redirects&ad-network-campaign-id=243232&ad-network-campaign-name=yarg_campaign_name
  &ad-network-adset-name=dsdsa

• 对于从广告平台发送到 AppsFlyer 的每个回调，AppsFlyer 都会发送：
  • 一个激活回。重新下载由 redownload 参数表示
  • 零到几次应用内事件回发确切的数字取决于转换值的请参阅模拟的回调
• 当您使用回调时，同一激活或事件可以被多个AppsFlyer 归因解决方案归因。使用attribution_source参数区分回发类型。

AppsFlyer 发送的激活 SKAd 回调示例

http://YourCompanyDomain.com/event?site_id=(publisher-id)&install_time=(timestamp)
&event_time=(timestamp)&skan_ad_network_time=(timestamp)
&skan_af_received_time=(timestamp)
&attribution_provider=skadnetwork
&app_id=(id123456789)&country=(ZA)&campaign=(campaign-name)
&campaign_id=(campaign-id)&skad_ambiguous_event=(boolean)
&redownload=(boolean)
&af_skad_nonce=(uuid)

AppsFlyer 发送的应用内事件 SKAd 回调示例

http://YourCompanyDomain.com/event?site_id=(publisher-id)&install_time=(timestamp)
&event_time=(timestamp)&skan_ad_network_time=(timestamp)
&skan_af_received_time=(timestamp)&revenue=(value)
&currency=(code)&event_name=(event-name)&attribution_provider=skadnetwork
&app_id=(id123456789)&country=(ZA)&campaign=(campaign-name)
&campaign_id=(campaign-id)&skad_ambiguous_event=(boolean)
&redownload=(boolean)
&af_skad_nonce=(uuid)

使用此方法，广告平台将有真实广告开启的广告主App的SKAd实际信息发送给AppsFlyer。 

• 使用此方法，广告渠道先将AppsFlyer预先准备的测试应用的回调内容发送到AppsFlyer（如下表），AppsFlyer再把解码后的转化信息回调给广告渠道。
• 每个测试app都有一个不同的转换值映射，如表中所示。