SKAN連携ガイド：アドネットワーク向け

この方法を使用する場合、アドネットワークがiOS端末から受け取ったSKAdの各ポストバックをAppsFlyerへ転送することになります。

アドネットワークは：

• iOS端末からSKAdのポストバックを受信します
• ［必須］ポストバックへ以下内容を追加してください：
  
  • アドネットワークのキャンペーンIDとキャンペーン名
  • iOS端末から送信されたポストバックのタイムスタンプ
• ［任意］ポストバックへの以下内容の追加は任意です：
  • iOS端末から受信したIPアドレス（主に地理的情報の目的で必要） 
  • Adset Name と Adset ID
  • Ad Name と Ad ID
  • アドネットワーク名
  • 国コード
  • ソースアプリID
  • クリエイティブ
  • Channel
• ポストバックをAppsFlyerへ送信
• 注意！ポストバックをAppsFlyerに送信する前に、送信するポストバックの内容を使ってAppleのAttribution Signatureを検証し、データを誤って改変してしまっていないか確認してください。 

SKAdNetworkのデータ追加ポストバックのプロトコル

SKAdNetworkのデータ追加ポストバックのJSONパラメータ一覧

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端末からのポストバックに応答し、AppsFlyerに対して直接ポストバックを送信するようにiOS端末に要求することになります： 

このリダイレクトの方法には以下の利点があります：

• 広告主からの信頼向上： MMPは広告主の代理として行動しています。AppsFlyerに対してSKAdのポストバックへのアクセスを直接提供することで、広告主はSKAdのポストバックが転送中に操作されていないことを確信できます。
  
• アドネットワーク側での処理が不要： アドネットワークはリダイレクトコマンドで(iOS端末に)応答するため、SKAdのポストバックを処理する必要がなくなります。これに対し、データ追加と転送の方式ではアドネットワークがポストバックを受け取り、各パラメーターでデータを追加して最後にAppsFlyerに転送する必要があります。

実装について

1. HTTP 307 のレスポンスで応答するようにサーバーを設定し、ポストバックを https://skadredirect.appsflyer.com/api/redirects へリダイレクトさせてください。
2. 以下の表に記載されているクエリパラメータを使って、キャンペーンの詳細な情報を追加してください。キャンペーン詳細を送信してもらうことで、SKAdNetworkの情報をより充実させ、広告主はキャンペーンをより効果的に最適化することが可能になります。

リダイレクトURLの例

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へ送信されたSKAdNetworkの各ポストバックについて、AppsFlyerは以下を送信します：
  • 1件のインストールのポストバック(再インストールはredownloadのパラメータで通知。) 
  • ゼロ件もしくは複数件のアプリ内イベントのポストバック。正確な件数は、コンバージョン値の変換によって変動します。詳細は模擬ポストバックを参照してください。
• SKAdのポストバックを取得することで、同一のインストールまたはアプリ内イベントが複数の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)

この方法を使用する場合、アドネットワークは広告主のアプリで実際のSKANのポストバックをAppsFlyerへ送信することになります。

連携のテスト

テストの判定基準

• この方法を使用する場合、次の表に記載されているように、アドネットワークは事前準備されたポストバックの内容をAppsFlyerのテストアプリに送信することになります。そして、AppsFlyerはコンバージョン値を解読したポストバックをアドネットワークへ返信します。
• 表に記載されているように、テストアプリ毎に異なるコンバージョン値のマッピングが用意されています。

連携手順

テストの判定基準