广告平台的SKAN对接指南

广告平台可使用此方法将其从设备侧接收到的各次回传分别转发到AppsFlyer。

广告平台

• 接收来自iOS设备的回传。
• 【必选】在回传数据中补充以下维度：
  • 相关广告系列在广告平台中的ID和名称。
  • 从设备收到的IP地址，主要用于地理位置解析。
  • iOS设备发送回传的时间戳。
• 【可选】在回传数据中补充以下维度：
  • 广告组ID和名称
  • 广告ID和名称
  • 广告平台名称
  • 国家代码
  • 流量侧应用ID（Source App ID）
  • 广告素材
  • 流量入口（Channel）
• 完成上述数据扩充后，再将回传发送到AppsFlyer
• 注意：向AppsFlyer转发回传之前，广告平台必须先通过回传内容验证Apple的归因签名（Attribution Signature），避免对数据造成意外损坏。

扩充后的SKAN数据回传规范

扩充后的JSON格式SKAN回传参数

Curl示例—扩充后的SKAN 3回传数据

curl --location --request POST 'https://skadpostbacks.appsflyer.com/api/postbacks?app_id=id888707074' \
  --header 'Content-type: application/json' \
  --data-raw '{
      "version":"3.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
  }'

Curl示例—扩充后带精细转化值的SKAN 4回传数据

curl --location --request POST 'https://skadpostbacks.appsflyer.com/api/postbacks?app_id=id888707074' \
  --header 'Content-type: application/json' \
  --data-raw '{
      "version": "4.0"
      "ad-network-id": "example123.skadnetwork",
      "ad-network-campaign-name": "skadnetwork_abc_campaign",
      "ad-network-campaign-id": "222222",
      "source-identifer": "5239",
      "app-id": 525463029,
      "transaction-id": "6aafb7a5-0170-41b5-bbe4-fe71dedf1e30",
      "redownload": false,
      "source-app-id": 1234567891,
      "fidelity-type": 1, 
      "did-win": true,
      "conversion-value": 63
      "postback-sequence-index": 0
      "attribution-signature": "MEUCIGRmSMrqedNu6uaHyhVcifs118R5z/AB6cvRaKrRRHWRAiEAv96ne3dKQ5kJpbsfk4eYiePmrZUU6sQmo+7zfP/1Bxo="
  }'

Curl示例—扩充后带粗略转化值的SKAN 4回传数据

curl --location --request POST 'https://skadpostbacks.appsflyer.com/api/postbacks?app_id=id888707074' \
  --header 'Content-type: application/json' \
  --data-raw '{
      "version": "4.0"
      "ad-network-id": "example123.skadnetwork",
      "ad-network-campaign-name": "skadnetwork_abc_campaign",
      "ad-network-campaign-id": "222222",
      "source-identifer": "39",
      "app-id": 525463029,
      "transaction-id": "6aafb7a5-0170-41b5-bbe4-fe71dedf1e31",
      "redownload": false,
      "source-app-id": 1234567891,
      "fidelity-type": 1, 
      "did-win": true,
      "coarse-conversion-value": "high"
      "postback-sequence-index": 0
      "attribution-signature": "MEUCIQD4rX6eh38qEhuUKHdap345UbmlzA7KEZ1bhWZuYM8MJwIgMnyiiZe6heabDkGwOaKBYrUXQhKtF3P/ERHqkR/XpuA="
  }'

在此方法中，广告平台使用HTTP重定向指令（307）来响应iOS设备发出的SKAN信息，请求设备将SKAN回传直接发送到AppsFlyer。

重定向方法具有以下优势：

• 增强广告主的信任感：由于MMP代替广告主开展移动衡量工作，因此当广告平台向AppsFlyer开放一手回传信息时，广告主无需担心回传数据在传输过程中出现篡改问题。
  
• 省去广告平台的数据处理工作：广告平台使用重定向指令对设备进行响应时，无需对回传数据进行处理。但“补充数据维度并转发”的方式则需要广告平台获取数据并在其中添加额外的参数，最后再转发给AppsFlyer。

启用方式

1. 配置您的服务器以使用HTTP 307对SKAdNetwork回调进行响应，将回调信息重定向到 https://skadredirect.appsflyer.com/api/redirects
2. 您可以在SKAN回传中添加下表所列的广告系列信息查询参数。请务必在回传中发送广告系列信息，因为我们需要通过这些信息补充SKAN回传中的成本等投放数据，这样广告主才能有效地优化其投放。

重定向的SKAdNetwork请求示例

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

建议添加的广告系列相关参数（非必须）

• 对于广告平台侧发送到AppsFlyer的每条回传，AppsFlyer都会发送：
  • 一条激活回传。AF会使用“redownload”参数来标识重新下载行为。
  • 零次到数次的应用内事件回传。具体次数取决于转化值的解析结果，详见模拟回传。
• 使用回传数据时需注意：同一个激活或事件可能会同时被多个AppsFlyer归因模式归因。这时您可以使用attribution_source参数来区分回传的类型。

AppsFlyer发送的SKAN激活回传示例

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

AppsFlyer发送的SKAN应用内事件回传示例

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

在该方法中，广告平台需针对实际使用中的应用向AppsFlyer发送其真实的SKAN回传。

测试对接

测试成功标准：

• 广告平台可使用此方法将AppsFlyer预先备制的回传数据发送到AppsFlyer测试应用，具体说明请见下表。然后AppsFlyer会把解析完毕的转化信息再回传给广告平台。
• 各测试应用的转化值映射构架都有所不同，具体请见下表。

对接流程

测试成功标准：