どのようにお手伝いできますか?

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

  • 更新

概要:アドネットワークがAppsFlyerのSKAdNetwork(SKAN)ソリューションと連携することで、自社が獲得したトラフィックのアトリビューションと、キャンペーンの最適化が可能になります。

AppsFlyerがアドネットワークに提供する機能とメリット

広告主向けのAppsFlyer SKANソリューションの詳細は、以下を参照してください。

SKANソリューションガイド | SKANダッシュボード

  • キャンペーンによるコンバージョンを自社にアトリビューションする:
    • AppsFlyerと連携すると、広告主に代わって実施したキャンペーンから生じたインストール、アプリ内イベント、収益が、すべて自社のアドネットワークにアトリビューションされます。
    • 連携していない場合、インストール、アプリ内イベント、収益はアドネットワークにアトリビューションされず、オーガニックとして扱われます。 
  • キャンペーンの最適化:
    • ポストバックに含まれるコンバージョン値は、エンコードされています。
    • AppsFlyerは各ポストバックのコンバージョン値をデコードするため、アドネットワークはアプリごとのデコード結果に基づいてキャンペーンを最適化できます。
  • 広告主ごとの直接連携が不要:SKANポストバックはアドネットワークにのみ送信されるため、広告主は以下のいずれかの方法でデータを取得します。
    • 各アドネットワークと個別に連携する。この方法では、アドネットワーク側も広告主側も、連携先が増えるにつれて対応の負担が大きくなります。 
    • AppsFlyerとの連携に一本化する。広告主とアドネットワークの双方が、連携先の増加に対応しやすくなります。
  • AppsFlyer上でSKAN対応をアピールする: 
    • SKAN連携を完了したアドネットワークは認定を受け、AppsFlyer管理画面でSKAN対応パートナーとして表示されます。 
    • これにより、広告主は、このアトリビューションモデルによる決定論的な計測に対応したアドネットワークであることを確認できます。

SKANデータの流れ

5754_Postback_flow_for_SKAD__1_.png

SKANポストバックの全体の流れは、以下のとおりです。

  1. iOSが、アトリビューション先のアドネットワークにSKANポストバックを送信します。
  2. アドネットワークは、次のいずれかの処理を行います。
    • 情報を追加して転送:SKANポストバックに、アドネットワークのキャンペーンID/ソース識別子、キャンペーン名、iOSデバイスのIPアドレスを追加します。 
    • リダイレクト:ポストバックと、アドネットワークが追加したキャンペーンデータをAppsFlyerに送信するよう、iOSデバイスにリダイレクトを指示します。
  3. AppsFlyerが、ポストバックを検証してデコードします。その後、デコード結果と追加情報を含むポストバックをアドネットワークに送信します。同時に、広告主にもデータを共有します。

連携の主な構成

AppsFlyerとアドネットワークのSKAN連携は、主に以下の2つで構成されます。この記事でそれぞれ説明します。

  • アドネットワークからAppsFlyerへのSKANデータの送信
  • AppsFlyerが情報を追加してデコードしたデータを、アドネットワークがポストバックで受信

AppsFlyerにデータを送信する

アドネットワークはデバイスからSKANポストバックを受信した後、以下のいずれかの方法でAppsFlyerに転送します。

  • 情報を追加して転送(POST)
  • リダイレクト(HTTP 307リダイレクト)

SKANポストバックを受信すると、AppsFlyerは以下の処理を行います。

  • ポストバックの検証:重複していないことを確認します。
  • コンバージョン値のデコード:アトリビューションされたインストール/アプリ内イベントのレコードを生成します。
  • デコードしたポストバックをアドネットワークに送信します。
  • 管理画面やレポートを通じて、広告主にアトリビューションデータを提供します。

情報を追加して転送(Enrich and forward)

この方法では、アドネットワークが、デバイスから受信した各ポストバックをAppsFlyerに転送します。

アドネットワーク側では、以下の処理を行います。

  • iOSデバイスからポストバックを受信します。
  • [必須]次の情報をポストバックに追加します。
    • アドネットワークのキャンペーンIDとキャンペーン名
    • iOSデバイスから送信されたポストバックのタイムスタンプ 
  • [任意]次の情報をポストバックに追加します。
    • デバイスから受信したIPアドレス。主に地域情報の特定に必要です。
    • 広告セットのIDと名前
    • 広告のIDと名前
    • アドネットワーク名
    • 国コード
    • 広告掲載元アプリのID
    • クリエイティブ
    • チャネル
  • AppsFlyerにポストバックを送信します。
  • 注意: AppsFlyerにポストバックを送信する前に、送信する内容を使用してAppleのアトリビューション署名を検証し、意図せずデータを破損していないことを確認してください。

情報を追加したSKANポストバックのプロトコル

エンドポイント https://skadpostbacks.appsflyer.com/api/postbacks
HTTPメソッド POST
受け付けるContent-Type application/json
レスポンスコード

200 OK:受信したポストバックの形式が有効です。 

400 Bad request:JSONの形式が不正、JSONが空、または必須フィールドが不足しています。

情報を追加したSKANポストバックのJSONパラメータ

パラメータ 形式 説明 データソース
version 文字列

SKAdNetworkのバージョン。

例:"version":"2.0"

SKANポストバック
ad-network-id 文字列

アドネットワークID。

例:"ad-network-id":" abc123defg.SKAdnetwork"

SKANポストバック
ad-network-name 文字列
  • アドネットワーク名。
  • 例:ad_network_name=your_network
アドネットワーク
ad-network-country-code 文字列
  • アドネットワークが判定したユーザーの地域情報。
  • ISO 3166(alpha-2)のコードを指定してください。
  • 例:CN、ZA
  • アドネットワークでは、キャンペーンの配信対象地域に基づいて地域情報を判定することがよくあります。  
  • AppsFlyerは、この国コードを使用して、レポートや管理画面の地域関連フィールドに値を設定します。
アドネットワーク
campaign-id 整数
  • SKAN 3以前のみ。
  • SKAdNetworkのキャンペーンID。
  • 例:"campaign-id":23
SKANポストバック
transaction-id 文字列 SKAdNetworkポストバックのトランザクションID。 SKANポストバック
app-id 整数
  • AppsFlyerに表示される対象アプリのID。必ず接頭辞idが付きます。
  • 例:app_id=id123456789
SKANポストバック
attribution-signature 文字列 アトリビューション署名。 SKANポストバック 
redownload ブール値 redownload = trueは、ユーザーがApp Storeからアプリを再ダウンロードしたことを示します。 SKANポストバック
source-app-id 整数
  • 広告掲載元アプリのID(パブリッシャー)。
  • SKAN 4では、ティア3の最初のポストバックでのみ取得できます。 Appleのドキュメントを参照してください。
SKANポストバック
conversion-value 整数

AppsFlyer SDKが、広告主の設定に従ってコンバージョン値を設定します。

注意

  • iOSのプライバシー保護のしきい値により、このパラメータがポストバックに含まれず、値がNullになる場合があります。
  • Nullと0では、意味が異なります。
    • Null:iOSがコンバージョン値を開示しなかったことを示します。
    • 0:ユーザーはアプリをインストールしましたが、計測対象の行動は行っていません。  
SKANポストバック 
ad-network-campaign-id 文字列 アドネットワーク、広告主、AppsFlyerの間でキャンペーンを共通のIDで識別できるよう、自社のcampaign-idを指定する必要があります。 アドネットワーク
ad-network-campaign-name 文字列 アドネットワークのキャンペーンIDに対応するキャンペーン名。この名前が管理画面やレポートに表示されます。  アドネットワーク
ad-network-adset-id 文字列 アドネットワークの広告セットID。 アドネットワーク
ad-network-adset-name 文字列 アドネットワークの広告セット名。 アドネットワーク
ad-network-ad-name 文字列 アドネットワークの広告名。 アドネットワーク
ad-network-ad-id 文字列 アドネットワークの広告ID。 アドネットワーク
ip 文字列
  • ポストバックを送信したデバイスのIPアドレス。
  • IPv4とIPv6に対応しています。
  • 例:"ip":"198.51.100.1"
アドネットワーク
timestamp 文字列
  • アドネットワークがSKANポストバックを受信した時刻。 10桁のUNIXエポックタイムスタンプ。[任意]13桁のエポックタイムスタンプも使用できます。
  • 例:2020年8月4日07:25(UTC)は、"timestamp": "1596525944"に相当します。
アドネットワーク
fidelity-type 整数
  • アトリビューションに影響する広告の表示方式を区別します。以下のように、0と1で示されます。 
    • ビュースルー広告(0)
    • StoreKitで表示される広告(1)
  • SKAN V2.2以降で必須のフィールドです。
SKANポストバック(V2.2以降)
did-win ブール値 SKANポストバック(V3.0以降)
ad-network-source-app-id 文字列 広告を掲載するアプリに対応するパブリッシャーIDを指定してください。通常は、Appleが生成したIDではなく、アドネットワークがパブリッシャーに割り当てたIDです。  アドネットワーク
postback-sequence-index 整数
  • SKAN 4以降のみ。
  • SKANウィンドウの順序を示す番号です。値は0、1、2のいずれかです。
SKAN 4.0ポストバック(iOS 16.2)
coarse-conversion-value 文字列
  • SKAN 4以降のみ。
  • 値はlow、medium、highのいずれかです。
  • 最初のポストバックでは、ティア1でのみ取得できます。 2回目と3回目のポストバックでは、ティア1-3で取得できます。 Appleのドキュメントを参照してください。
SKAN 4.0ポストバック(iOS 16.2)
source-identifier 文字列
  • SKAN 4以降のみ。
  • campaign-idに代わるパラメータです。
  • 値は最大4桁です。
  • 最初のポストバックでは、ティア2-3で最大4桁、ティア0-1で2桁の値を取得できます。 2回目と3回目のポストバックでは、ティア1-3で2桁の値を取得できます。ティア0では、ポストバックはありません。 Appleのドキュメントを参照してください。

SKAN 4.0ポストバック(iOS 16.2)
source-domain 文字列
  • SKAN 4以降のみ。
  • アトリビューション対象となるWeb広告の配信元を示します。例:example.com 
  • Web広告の場合のみ、ティア3の最初のポストバックで取得できます。 Appleのドキュメントを参照してください。
SKAN 4.0ポストバック(iOS 16.2)
creative 文字列
  • SKAN 4以降のみ対象。
  • キャンペーンをより細かく分類するため、source_identifierの追加の桁を使用している場合に取得できます。
アドネットワーク
channel 文字列
  • SKAN 4以降のみ対象。
  • キャンペーンをより細かく分類するため、source_identifierの追加の桁を使用している場合に取得できます。
アドネットワーク

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="
  }'

リダイレクト

Redirect_us-en__2_.png

この方法では、アドネットワークがデバイスにHTTPリダイレクト(307)を返し、AppsFlyerにポストバックを直接送信するよう指示します。 

リダイレクト方式には、以下の利点があります。

  • 広告主からの信頼の向上:MMPは広告主に代わって計測を行います。 AppsFlyerがポストバックを直接受信することで、広告主は転送の途中でポストバックが改変されていないと確信できます。
     
  • アドネットワーク側での処理が不要:アドネットワークはデバイスにリダイレクトを返すため、ポストバックを処理する必要がなくなります。一方、情報を追加して転送する方式では、アドネットワークがポストバックを受信し、パラメータを追加してからAppsFlyerに転送する必要があります。

実装方法

  1. ポストバックの転送先をhttps://skadredirect.appsflyer.com/api/redirectsとするHTTP 307レスポンスを返すよう、サーバーを設定してください。
  2. 以下の表に記載されたクエリパラメータを使用して、キャンペーンの詳細を追加します。キャンペーンの詳細は、必須情報として送信してください。キャンペーンの詳細があれば、SKANデータにコストなどのキャンペーン情報を追加でき、広告主はキャンペーンを効果的に最適化できます。

リダイレクト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

キャンペーンの詳細を指定するクエリパラメータ(任意)

クエリパラメータ 説明
ad-network-name
  • アドネットワーク名。
  • 例:ad_network_name=your_network
ad-network-campaign-id キャンペーンID
ad-network-campaign-name キャンペーン名
ad-network-adset-id 広告セットID
ad-network-adset-name 広告セット名
ad-network-ad-id 広告ID
ad-network-ad-name 広告名
ad-network-country-code
  • アドネットワークが判定したユーザーの地域情報。
  • ISO 3166(alpha-2)のコードを指定してください。
  • 例:CN、ZA
  • アドネットワークでは、キャンペーンの配信対象地域に基づいて地域情報を判定することがよくあります。  
  • AppsFlyerは、この国コードを使用して、レポートや管理画面の地域関連フィールドに値を設定します。
ad-network-source-app-id 広告を掲載するアプリに対応するパブリッシャーIDを指定してください。通常は、Appleが生成したIDではなく、アドネットワークがパブリッシャーに割り当てたIDです。 
ip
  • ポストバックを送信したデバイスのIPアドレス。
  • IPv4とIPv6に対応しています。
  • 例:"ip":"198.51.100.1"
timestamp
  • アドネットワークがSKANポストバックを受信した時刻。 10桁のUNIXエポックタイムスタンプ。[任意]13桁のエポックタイムスタンプも使用できます。
  • 例:2020年8月4日07:25(UTC)は、"timestamp": "1596525944"に相当します。
creative
  • SKAN 4以降のみ対象。
  • キャンペーンをより細かく分類するため、source_identifierの追加の桁を使用している場合に取得できます。
channel
  • SKAN 4以降のみ対象。
  • キャンペーンをより細かく分類するため、source_identifierの追加の桁を使用している場合に取得できます。

AppsFlyerからデータを受信する

最初のポストバックを受信する前に、以下を確認してください。 

  • アドネットワークは、ポストバックのエンドポイントとテンプレートを定義する必要があります。Partner AssistantウィジェットからAppsFlyerの担当者(PDM)に連絡し、設定が完了していることを確認してください。
  • AppsFlyerは、既存のポストバックと同じ仕組みでSKANポストバックを送信します。

基本方針

  • アドネットワークからAppsFlyerに送信されたポストバック1件に対し、AppsFlyerは以下を送信します。
    • インストールポストバック1件。再ダウンロードかどうかは、redownloadパラメータで示されます。 
    • アプリ内イベントポストバック0件~複数件。件数は、コンバージョン値のデコード結果によって異なります。テスト用ポストバックを参照してください。
  • ポストバックを取り込む際は、同じインストールやイベントが、AppsFlyerの複数のアトリビューションソリューションで計測される場合があることに注意してください。 attribution_sourceパラメータで、ポストバックの種類を区別してください。 

アドネットワークパートナーが使用できるポストバックマクロ

ポストバックマクロ(名前) 説明 形式と例 アプリ内イベントのみ対象
site_id 広告を掲載するアプリ(広告掲載元アプリのID)。 文字列:876534  
install_time updateConversionウィンドウに基づき、AppsFlyerが推定します。 10桁のUNIXエポックタイムスタンプ、または日時を読み取れる形式のタイムスタンプで提供されます。
  • 文字列:1596119460 
  • 2020年7月30日14:31(UTC)に相当します。
 
skadnetwork_ad_network_time アドネットワークがiOSデバイスからポストバックを受信した時刻。アドネットワークから報告されます。 10桁のUNIXエポックタイムスタンプ、または日時を読み取れる形式のタイムスタンプで提供されます。
  • 文字列:1596119460 
  • 2020年7月30日14:31(UTC)に相当します。



 

 

skadnetwork_received_time
AppsFlyerがアドネットワークからポストバックを受信した時刻。 10桁のUNIXエポックタイムスタンプ、または日時を読み取れる形式のタイムスタンプで提供されます。

 

  • 文字列:1596119460 
  • 2020年7月30日14:31(UTC)に相当します。
 
event_name

イベント名 

  • af_skadnetwork_revenue
  • af_login
  • af_skadnetwork_revenue
  • または広告主が設定した名前。 

文字列:af_skadnetwork_revenue、abc123

 

はい
revenue 指定された通貨コードで表した収益額。 数値:5、20、0.4 はい
currency 広告主が設定したアプリ固有の通貨コード。 文字列:EUR、USD、ZAR はい
attribution_source

アトリビューションデータのソース:

SKAdNetwork:SKAdNetwork

文字列:SKAdNetwork  
app_id アプリID(広告主のアプリ)。 文字列:ID123456790  
country アドネットワークが判定したインストールの地域(国)。 文字列:US、UK、ZA   
campaign アドネットワークからのポストバックで送信されたad-network-campaign-nameを使用して設定されるキャンペーン名。 文字列:UA_US_23+  
campaign_id アドネットワークからのポストバックで送信されたad network-campaign-idを使用して設定される、アドネットワークのキャンペーンID。注意:SKAN 4では、この値は常にnullです。 文字列:3456745  
redownload

設定される値:true、false

redownload = trueは、ユーザーがApp Storeからアプリを再ダウンロードしたことを示します。

ブール値:true、false  

skadnetwork_ambiguous_event

(SKAN 4以降では廃止)

広告主が管理画面でSKANの設定を変更してから、最初の72時間以内に受信したイベント。 SKANにはさまざまなタイマーがあるため、AppsFlyerはイベントを正確にマッピングできません。

  • SKAN 4以降では使用できません。
ブール値:true、false  
skadnetwork_campaign_id 元のSKANポストバックで提供されたSKANキャンペーンID。 56, 23  
af_skadnetwork_nonce パートナーがポストバックの重複を識別するための、一意のランダムな識別子。    
event_id アドネットワーク側のイベント名/ID。   はい
transaction_id

SKANポストバックのトランザクションID。

注意:transaction_idをパートナーに共有するには、広告主による明示的な許可が必要です。連携タブで許可するよう、広告主に依頼してください。

   
ad_network_adset_id アドネットワークがiOSポストバックに追加する値。 文字列  
ad_network_adset_name アドネットワークがiOSポストバックに追加する値。 文字列  
ad_network_ad_name アドネットワークがiOSポストバックに追加する値。 文字列  
ad_network_ad_id アドネットワークがiOSポストバックに追加する値。 文字列  
SKAN_min_event_counter 注意事項(1)を参照。 整数 はい
SKAN_max_event_counter 注意事項(1)を参照。 整数 はい
SKAN_min_time_post-install 注意事項(2)を参照。 整数 はい
SKAN_max_time_post-install 注意事項(2)を参照。 整数 はい
SKAN_min_event_revenue 注意事項(3)を参照。 実数 はい
SKAN_max_event_revenue 注意事項(3)を参照。 実数  はい
fidelity-type

アトリビューションに影響する広告の表示方式を区別します。以下のように、0と1で示されます。 

  • ビュースルー広告(0)
  • StoreKitで表示される広告(1)
整数  
skad_af_attribution_flag SSOT(Single Source of Truth)の仕組みによって、ユーザーがAppsFlyerでアトリビューションされたかどうかを示します。  ブール値  
skad_postback_sequence_index
  • SKANウィンドウを示す値です。0、1、2のいずれかです。
  • SKAN 3では、値は0です。
整数  
skad_coarse_conversion_value
  • 値はlow、medium、highのいずれかです。
  • SKAN 3では、値はnullです。
文字列  
skad_source_identifier
  • 値は最大4桁です。
  • SKAN 3では、値はnullです。 
文字列  
skad_source_domain
  • アトリビューション対象となるWeb広告の配信元を示します。
  • SKAN 3では、値はnullです。
文字列  
ad_network_creative
  • アドネットワークから受信した追加情報に基づく値です。
  • SKAN 3では、値はnullです。
文字列  
ad_network_channel
  • SKAN 4以降のみ対象。
  • キャンペーンをより細かく分類するため、source_identifierの追加の桁を使用している場合に取得できます。
文字列  

注意事項:

  1. イベントの発生回数:イベントの発生回数は、次の式で算出します。
    [round up (SKAN_min_event_counter+SKAN_max_event_counter) / 2]
    注意:計算結果は、小数点以下を切り上げて整数にする必要があります。
  • 例:
    • A. min=0、max=1の場合、イベントの発生回数は1です。
    • B. min=0、max =10の場合、イベントの発生回数は5です。
  • インストール時刻の算出:カスタムコンバージョンを実装している広告主については、AppsFlyerは「ポストバックの到着時刻 - 48h - average (min_time_post_install + max_time_post_install)」でインストール時刻を算出します。アドネットワーク側で、これらのマクロを使用する必要はありません。  
  • 収益の算出:AppsFlyerは、最小値と最大値の平均を求めてイベントの収益を算出します。アドネットワーク側で、これらのマクロを使用する必要はありません。 

SKANポストバックの例

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ポストバック:アドネットワークが受信した実際のSKANトラフィックを使用します。
  • テスト用ポストバック:AppsFlyerのテストアプリを使用します。

iOSデバイスから実際のSKANポストバックを受信するには、アドネットワーク側で以下の対応を行います。

テスト用ポストバックを受信するには:

本番環境

この方法では、アドネットワークが、本番アプリの実際のSKANポストバックをAppsFlyerに送信します。 

連携テストの手順

担当 対応内容
アドネットワーク Appleから付与されたSKANネットワークIDを、AppsFlyerの担当者(PDM)に伝えるか、Partner Assistantウィジェットから連絡してください。
アドネットワークとAppsFlyer ポストバック連携の検証に使用する共通の顧客を、双方で合意のうえ決めます。対象の顧客は、最新のAppsFlyer SDKを実装している必要があります。
アドネットワーク この記事で説明したいずれかの方法で、アプリのSKANポストバックをAppsFlyerに送信します。
AppsFlyer 広告主が設定したコンバージョン値のマッピングに従って、デコードしたポストバックをアドネットワークに送信します。

テストの確認項目

担当 対応内容
アドネットワーク 合意した共通の顧客について、指定した期間内に送信したSKANポストバックの件数をAppsFlyerに伝えます。
AppsFlyer 受信したポストバックの件数と、アドネットワークから報告された送信件数を照合します。
AppsFlyer

対象アプリについて、アドネットワークに送信したポストバックの件数を、以下の種類別に共有します。

  • インストール/再ダウンロードのポストバック
  • アプリ内イベントのポストバック

注意:確率論的モデリングによるポストバックと同じエンドポイントを使用する場合は、attribution_source=skadnetworkでフィルタリングし、SKANポストバックとそれ以外のポストバックを区別してください。

テスト用ポストバック

  • この方法では、以下の表に示すAppsFlyerのテストアプリを対象に、事前に用意したポストバックをアドネットワークからAppsFlyerに送信します。 AppsFlyerは、デコードしたポストバックをアドネットワークに返します。
  • テストアプリごとにコンバージョン値のマッピングが異なります。詳細は表を参照してください。
アプリID コンバージョンの計測モード 手順
id888707085

収益。単位は1米ドル。

想定される結果: 

  1. 連携タブで、アプリ内イベントポストバックを有効にします。 
  2. イベント名af_SKAN_revenueを選択し、パートナー側のイベント識別子にマッピングします。
  3. 設定を保存します。
  4. コンバージョン値を7に設定したポストバックを送信します。
  5. AppsFlyerは、以下を返します。
    • インストールポストバック
    • 収益額が7米ドルのaf_SKAN_revenueポストバック
id888707086

コンバージョン。以下のアプリ内イベントを使用します。
 

  • af_level_complete
  • af_login
  • af_SKAN_revenue
  • af_register
  • af_subscription
  • af_custom_event
  1. 連携タブで、アプリ内イベントポストバックを有効にします。 
  2. 一覧にあるアプリ内イベントをそれぞれ選択し、パートナー側のイベント識別子にマッピングします。 
  3. 設定を保存します。
  4. コンバージョン値を63に設定したポストバックを送信します。
  5. AppsFlyerは、以下を返します。
    • インストールポストバック
    • af_level_completeのポストバック
    • af_loginのポストバック
    • af_SKAN_revenueのポストバック
    • af_registerのポストバック
    • af_subscriptionのポストバック
    • af_custom_eventのポストバック
id888707087 エンゲージメント。af_skad_revenueイベントで計測します。
  1. 連携タブで、アプリ内イベントポストバックを有効にします。 
  2. イベント名af_skad_revenueをパートナー側のイベント識別子にマッピングします。
  3. 設定を保存します。
  4. コンバージョン値を3に設定したポストバックを送信します。
  5. AppsFlyerは、以下を返します。
    • インストールポストバック
    • af_skad_revenueイベントのポストバック3件

連携手順

担当 対応内容
アドネットワーク Appleから付与されたSKANネットワークIDとSKANポストバックテンプレートを、ポストバック管理画面で設定します。質問やサポートの依頼は、Partner Assistantウィジェットからお問い合わせください。
アドネットワーク
  1. テストアプリを有効にします。
  2. 各アプリについて、上の表の「手順」列に記載された設定を行います。 
  3. 上の表にあるテストアプリを使用して、テスト用ポストバックを送信します。テスト用ポストバックを送信する際の注意事項:
    • app_idとコンバージョン値は、上の表に指定された値を設定してください。 
    • アドネットワークではAppleの仕様に準拠した署名を生成できないため、テスト用ポストバックに署名フィールドを含める必要はありません。 AppsFlyerは、テスト用ポストバックの署名を検証しません。
    • アドネットワークは、POST方式またはREDIRECT方式でポストバックを送信します。
AppsFlyer 連携時にアドネットワークが指定したエンドポイントに、デコードしたポストバックを返します。

テストの確認項目

担当 対応内容
AppsFlyer ポストバックを処理し、アドネットワークにポストバックを送信します。
アドネットワーク
  • アドネットワークは、変換済みのポストバックを受信してデコードします。
  • AppsFlyerから送信されたアプリ内イベントポストバックが、想定される処理の流れと一致することを確認します。たとえば、アプリID888707087でコンバージョン値が3の場合、アドネットワークはaf_SKAN_revenueイベントのポストバックを3件受信します。 

補足事項

必須フィールド、追加情報、認定などについて補足します。

よくある質問

ポストバックに関する質問と回答

追加情報のフィールドは必須ですか? 

現時点では、以下の追加パラメータが1つ以上欠けていても、ポストバックは処理されます。ただし、これらの情報は次の理由で必要です。 

  • アドネットワークのキャンペーンID:コスト連携を行っている場合、コストはこのキャンペーンIDを使用して報告されます。 
  • アドネットワークのキャンペーン名:多くの広告主は、キャンペーン番号ではなくキャンペーン名を使用してキャンペーンを識別します。 
  • IPアドレス:地域情報の特定に必要です。 
  • タイムスタンプ:インストールを正しい日付にアトリビューションするために使用します。 

キャンペーンIDとキャンペーン名は、どちらか一方だけ送信してもよいですか?

上の回答を参照してください。 IDと名前の両方に、同じ値を設定することも検討してください。 

「情報を追加して転送」を使用しています。 AppsFlyerの仕様にないキーと値のペアを追加してもよいですか? 

はい、追加できます。アトリビューション署名が有効であれば、ポストバックは処理され、追加された情報は無視されます。

SKANポストバックと既存のポストバックでは、テンプレートは異なりますか?

はい。処理の流れと構造が異なります。

同じインストールについて、SKANポストバックと、確率論的モデリング/決定論的モデリングによるポストバックの両方を受信し、重複して報告されることはありますか?

はい。計測手法にかかわらず、インストールが自社にアトリビューションされて記録されるたびに、ポストバックが送信されます。

attribution_sourceを使用して、SKANポストバックを区別してください。

AppsFlyerからのポストバックを処理する必要はありますか?
 

いいえ。ただし、ポストバックで報告されるユーザーの質に基づいて、キャンペーンを最適化することを推奨します。 

AppsFlyerのアトリビューションリンクを呼び出す必要がありますか?それとも、SKANペイロードと追加情報を含むポストバックを送信するだけで十分ですか?
 

SKANペイロードと追加情報を送信するだけで十分です。

AppsFlyer管理画面でSKAN連携パートナーとして認定されるには、何が必要ですか?

  • この記事に記載されているいずれかの方法で連携を完了する
  • アトリビューションパートナーとしてAppsFlyerを利用しているアプリのポストバックを送信する

SKANキャンペーンIDの上限が100件であることは、どのような影響がありますか? 

1-100の制限は、Apple側でキャンペーンに署名し、番号を割り当てる方法に関するものです。同時に使用できる一意のキャンペーンは、100件までという意味です。 AppsFlyerに送信するポストバックには、実際のキャンペーン名とIDを追加できます。つまり、ポストバックを受信した時点で使用している実際のキャンペーンIDに、SKANキャンペーンIDを対応付けられます。そのため、1つのアプリで同時に実施するキャンペーンが100件を超えなければ、AppsFlyerで計測するキャンペーン数が100件に制限されることはありません。