SKAdNetworkカスタムコンバージョン値のデコード

概要:AppsFlyerは、広告主が設定したコンバージョン値をデコードしてイベントに変換します。これらイベントは、SKAdNetwork管理画面、ローデータ、パートナーへのポストバックを入力する際に使用されます。

SKAdNetwork_-_Custom__1_.png

SKAdNetworkカスタムコンバージョン値のデコード

ユーザーインターフェイス上で利用できるAppsFlyer SKAdNetwork計測オプションの代わりに、コンバージョン値のデコードソリューションを使用できます。カスタムコンバージョンのデコードを使用する場合、アプリのロジックに従って updateConversionValue を設定する必要があります。

アプリ内でコンバージョン値を設定する以外の部分(計測フロー、機能、レポーティングオプションなど)は、SKAdNetworkソリューションガイドに記載されている手順と同じです。つまり、計測期間(広告主が設定可)が終了した時点で、iOSはアドネットワークにポストバックを送信し、アドネットワークがAppsFlyerに転送します。SDKで設定されたデコード済みのコンバージョン値と同様に、AppsFlyerはマッピングに従って、コンバージョン値をイベントにデコードします。

カスタムコンバージョン値—デコード

カスタムコンバージョン値の実装には、コンバージョン値のマッピングを含むCSVファイルをAppsFlyerプラットフォームにアップロードする必要があります。

デコードマッピングの原則

  • コンバージョン値1~63のデコードマッピングを設定してください。値の範囲全てをマッピングする必要はありません。例えば、1、2、10、43の値のみをマッピングします。
  • コンバージョン値0は常にインストールにマッピングされ、変更できません。
  • マッピング表は、CSV形式でAppsFlyerにアップロードしてください。必要に応じて、更新されたマッピング表をアップロードできます。
  • 次の例で示すように、iOSからポストバックを受信するとコンバージョン値はイベントにデコードされます。
  • インストール時刻は、ポストバックの到着時刻を使用して算出されます。
  • イベントはインストール時間と同じ時間になります。
  • スキーマの準備方法を最もよく理解するために、次のマッピングシナリオを確認してください。
  • カスタムアプリ内イベント名も設定可能です。
    • つまり、SDKによって送信されたことがない場合でも、新しいイベント名を送信します。
    • アプリ内イベントをアドネットワークのアプリ内イベントにマッピングできます。
    • これはFacebookの連携にも当てはまります。次のセクションで説明する Facebook 固有のルールが適用されます。

デコードマッピングシナリオのルール

特記事項:

  • コンバージョン値の範囲:1-63
  • コンバージョン値は、1つ以上の指定したアプリ内イベントにマッピングされます。アプリ内イベントにはオプションのパラメーターがあります。
  • 例:インストール日は2月1日の08:00であると仮定します。
  • 次の表は、デコードマッピング表の例です。構造は、必要なCSVファイルの構造に似ています。次の表は、デコード処理の結果として生成されたイベントを示しています。
  • マッピングに関わらず、インストールイベントは常に生成されます。
  • 収益の計測:
    • 収益はUSDです。
    • 特定のコンバージョン値には、min_revenueとmax_revenueによって制限された収益範囲があります。
    • 集計レポートおよび管理画面では、収益は範囲の平均値として計算されます。例:min_revenue=4 および max_revenue=10。計算された収益は7です。
    • ローデータレポートには、計算された収益(skad_revenue)、min_revenue、max_revenue が含まれます。

Facebook固有のルール

Facebookと連携している場合は、次のルールに従ってください。

  • 特定のコンバージョン値の最小および最大収益値には、異なる値を設定してください。つまりこれらに同じ値は設定できません。
  • 値はオーバーラップせず、次の表の conversion_value 1-2 および 62 に示すように、連続した順序にする必要があります。
  • event_counter: Facebook はこの値を考慮しません。[ベストプラクティス] 値を1に設定してください。
コンバー
ジョン値
イベント
イベント

min_revenue

(not -inclusive)

max_revenue (inclusive) scale イベント
カウント
インストール
後経過時間
1 af_purchase {abc} 0 3   1 24
2 af_purchase {def} 3 10   3 36
21 event_a         1 24
21 event_b         3 24
21 event_c {xyz}       2 24
21 event_d         1 24
21 event_e         1 24
21 event_f         1 24
21 event_g         1 24
62 af_purchase {fgh) 10 17   2 72
62 event_a {klm}       3 72
例:デコードマッピング
例A:コンバージョン値 1
event_name skad_revenue

min_revenue

max_revenue

event_value
install        
af_purchase 1.5 0 3 {abc}
例 B:コンバージョン値 2
event_name skad_revenue min_revenue max_revenue event_value
install        
af_purchase 6.5 3 10 {def}
af_purchase 6.5 3 10 {def}
af_purchase 6.5 3 10 {def}
例 C:コンバージョン値 21
event_name skad_revenue min_revenue max_revenue event_value
install        
event_a        
event_b        
event_b        
event_b        
event_c       {xyz}
event_c       {xyz}
event_d        
event_e        
event_f        
event_g        
例 D:コンバージョン値 62
event_name skad_revenue min_revenue max_revenue event_value
install        
af_purchase 13.5 10 17 {fgh}
af_purchase 13.5 10 17 {fgh}
event_a       {klm}
event_a       {klm}
event_a       {klm}

CSVファイルのデコードに関する仕様

コンバージョン値は1つまたは複数のアプリ内イベントにマッピングされます。

ファイルに関するルール:

  • 形式:CSVファイル
  • 最大行数:640行+ヘッダー行;合計641行まで
  • ヘッダー行には、ここで示すとおりの列名を全て含める必要があります。[ベストプラクティス] 添付されているサンプルファイルをテンプレートとして使用してください。デコードCSVのサンプルファイル
  • 列の最初の文字に次の文字を使用しないでください:=+-@ (編集済み)。
 
カラム  必須な値 コンテンツ 詳細
conversion_value はい 整数値 1–63

同じコンバージョン値を複数回リストすることができます。詳細は、例を参照してください。

event_name はい 文字列

アプリ内イベントです。AppsFlyerにすでに存在するイベントである必要はありません。

注!アプリ内イベント名は大文字小文字を区別します

[ベストプラクティス]:収益に関するイベント名は、af_skad_revenue です。

event_value いいえ 文字列 デベロッパーにより設定された広告主によりシステム内でデコードされるデータを含む文字列です。通常これはJSON形式です。
min_revenue

いいえ

 

整数型、またはローティング

min_revenue と max_revenue を使用して、USDでの収益範囲を設定してください。

  • コンバージョン値を収益に紐づけたくない場合は、min_revenueとmax_revenueを空白に設定してください。
  • min_revenue に設定した値は含まれません。つまり0より大きいこく、0.0001に近いことを意味します。
  • max_valueに設定した値は含まれます。
  • 例:min_revenueが0で、max_revenueが4の場合、範囲は0.0001~4となります。
  • max_revenue は、min_revenueより大きい値である必要があります。

注!Excel を使用してファイルを生成する場合は、保存する前に、列形式を通貨ではなくカンマに変更して、CSVファイルに$記号が埋め込まれないようにします。 

max_revenue いいえ  

min_revenueを入力する場合:max_revenue には0より大きい値を指定する必要があります。 

詳細は、min_revenue の説明を参照してください。

event_revenue_usd いいえ  

 

2021年6月7日に非推奨。min_revenue と max_revenue を使用してください。

 

scale いいえ 空のままにします 今後のために用意されている項目です。空のままにしておいてください。
event_counter はい

整数型

 

  • デコード時にイベントが複製された回数。通常、これはユーザーが特定のアクションを実行した回数を示しています。
  • 最小値1。

例:ユーザーが特定のイベントを5回実行した場合、5つのイベントが生成されます。

考慮事項:収益を送信する場合、レポートされるUSDの総額は event_counter の値で乗算されますつまり、event_value_usd = 3 で、event_counter = 4 の場合、レポートされる総収益は 3 X 4 = 12 となります。

例を参照してください。

hours_from_install はい Integer
  • インストールから経過した時間
  • 最小値1
  • 指定された conversion_value のすべての行の値は同じでなければなりません。つまり、異なるコンバージョン値に対して異なる値が許可されます。

AppsFlyerはこれを使用してインストール時刻を算出し設定します:インストール日=ポストバックタイムスタンプ - (最大 hours_from_install + 24時間)。イベント時刻はインストール時刻と同じです。

コンバージョン値スキーマファイルのアップロード

はじめに:

  • コンバージョン値のスキーマCSVファイルを準備します。
  • Facebookと連携し、収益を計測する場合は、スキーマがFacebookに関するルールに準拠していることを確認してください。そうでないと、Facebookはスキーマを解釈できません。

カスタム計測を使用したSKAdNetwork計測を有効にする方法:

  1. AppsFlyerで、設定 > SKAdNetwork設定を開きます。
  2. カスタム計測を選択します。
  3. 次のいずれかを実行してください:
    • ファイルをドラッグ&ドロップします。
    • 更新済みのマッピングファイルをアップロードします。
  4. 画面の指示に従ってファイルをアップロードしてください。
  5. SKAdNetwork計測をオンにします。
  6. 変更を保存 をクリックしてください。
    注:アップロード後48時間は、管理画面のデータは正しくない可能性があります。iOSタイマーの問題により、この期間はデコードマッピングが使用されているエンコードマッピングと一致するかが不明なためです。
  7. ポストバックを正しく受信できるように、アプリ内イベントがパートナーが使用するアプリ内イベントにマッピングされていることを確認してください。

CSVファイルのアップロードエラーに関するトラブルシューティング

アップロードエラーメッセージ

ファイル内の1つ以上の値が必要な形式と一致しません。ファイル形式は2021年6月7日以降変更されました。ファイル形式がこの記事内の例と一致していることを確認してください。

Excelを使用して event_revenue_usd 列を書式設定する

Excel/Googleシートを使用してCSVファイルを作成する場合は、CSVファイルとして保存する前に、event_revenue_usd 列を正しくフォーマットする必要があります。

CSVファイルを保存した後、コンテンツが正しくフォーマットされていることを確認してください。:確認の際にはExcelを使用せず、各種エディタを使用してください。

event_revenue_usd をExcelでフォーマットする

図に示すように、Excelでは通常、値のセルをコンマでフォーマットして千の値を区切ります。この形式は、CSVのアップロードファイルには適していません。また、$記号を削除する必要があります。

mceclip0.png

Excelでセルをフォーマットすることで修正できます。

1000の区切り記号、または$記号なしで金額をフォーマットする方法:

  1. フォーマットするセルを選択してください。
  2. 右クリックして、セルの書式設定を選択してください。
    セルの書式設定の画面が開きます。
  3. 数値を選択してください。

    Formatnumbers.png

  1. 1000の区切り記号を使用 (,) をオフにしてください。
  2. (任意) 小数点以下の桁数を設定してください。デフォルトは2です。許可される最大値は5です。 
  3. OKをクリックします。
    セルは正しくフォーマットされています。

Excelを使用しない場合のCSVファイルのチェック

CSVファイルの内容を調べるには、エディターを使用してファイルを表示してください。

  • Windows: Notepad / Notepad++
  • macOS: テキストエディット

以下は、エディターに表示されたCSVファイルのサンプルのスクリーンショットです。 

エディター画面

SKCustomeEditor.png

エディターを使用して、CSVファイルを検査してください。特に、次の点に注意してください。

  • 空白スペース:フィールドを区切るコンマの前後に、空白スペースがないことを確認してください。Excelでは、@trimのコマンドを使用して空白スペースを削除してください。
  • event_revenue_usd:event_revenue_usd 列に、カンマや$記号が含まれていないことを確認してください。

    mceclip1.png

Excelで作成されたCSVファイルには、区切り文字としてのコンマがありません

Excelでは、カンマではなくセミコロン";"などの文字を区切り文字にしてCSVファイルを作成します:

  • これは、使用しているコンピューターの地域設定が英語以外の言語/地域に設定されている場合に発生します。
  • この問題は、地域設定でドイツ語が選択されている場合に特によく見られます。
  • 解決策は、お使いのコンピューターのオペレーティングシステム(macOSまたはWindows)によって異なります。
  • この問題を解決するには、 Microsoftまたはその他のフォーラムからの最新のガイダンスを検索してください。次の用語を検索に使用してください: Operating system (macOS or Windows) Excel change delimiter for CSV files.
この記事は役に立ちましたか?