概要：AppsFlyerが、独自に設定されたCVをデコードしてイベントに変換します。変換されたイベントは、SKANダッシュボード、ローデータ、パートナーへのポストバックに反映されます。
SKANコンバージョン値のデコード
広告主は、Conversion Studioの設定オプションを使用する代わりに、CVのデコードを利用できます。デコードを使用する場合は、広告主側で、アプリのロジックに従ってupdatePostbackConversionValueを設定する必要があります。
アプリ内でCVを設定する部分を除き、処理の流れ、機能、レポートの選択肢は、SKANソリューションガイドの説明と同じです。つまり、広告主が管理するアクティビティ期間の終了後、iOSがアドネットワークにポストバックを送信し、アドネットワークがAppsFlyerに転送します。 AppsFlyerは、広告主が定義したマッピングに従ってCVをイベントに読み替えます。その後は、SDKが設定したCVをデコードした場合と同様に処理します。
カスタムコンバージョン値｜デコード
カスタムCVのデコードを利用するには、CVのマッピングを記載したCSVファイルを、AppsFlyerプラットフォームにアップロードする必要があります。
デコードマッピングの原則
- 細かいCV（1〜63）と、ウィンドウ1〜3の粗いCV（low、medium、high）に対するデコードマッピングを用意します。すべての値をマッピングする必要はありません。たとえば、1、2、10、43だけをマッピングできます。
- CV 0は、常にインストールに対応します。この対応は変更できません。
- マッピング表は、CSVファイルでAppsFlyerにアップロードします。必要に応じて、更新したマッピング表をアップロードできます。
- iOSからポストバックを受信すると、後述の例のように、CVをデコードして対応するイベントを生成します。
- インストール時刻は、ポストバック到着時刻から算出します。
- イベントには、インストール時刻と同じ時刻が設定されます。
- スキーマの作成方法については、以下のマッピング例を参照してください。
-
カスタムアプリ内イベントの名前も使用できます。
- つまり、SDKから一度も送信したことのない、新しいイベント名も使用できます。
- アプリ内イベントを、アドネットワーク側のアプリ内イベントにマッピングできます。
- Meta広告との連携でも同様ですが、次のセクションに示すMeta固有のルールに従う必要があります。
デコードマッピング例のルール
以下の点に注意してください。
- 細かいCVの範囲：1〜63
- 粗いCVの値：low、medium、high
- 1つのCVを、指定した1つ以上のアプリ内イベントに対応付けます。アプリ内イベントには、任意のパラメータを設定できます。
- 以下の例では、インストール日時を2月1日08:00とします。
- 次の表は、デコードマッピング表の例です。必要なCSVファイルと同様の構成になっています。表の後には、デコード処理で生成されるイベントを示しています。
- マッピング内容にかかわらず、インストールイベントは必ず生成されます。
- 収益計測：
- 収益の通貨はUSDです。
- 各CVの収益範囲は、min_revenueとmax_revenueで定義します。
- 集計レポートとダッシュボードでは、その範囲の平均値を収益として算出します。例：min_revenue=4、max_revenue=10。算出される収益は7です。
- ローデータレポートには、算出した収益（skad_revenue）、min_revenue、max_revenueが含まれます。
Meta固有のルール
Meta広告と連携する場合は、以下のルールに従ってください。
- 同じCVに設定する収益の最小値と最大値は、異なる値である必要があります。つまり、同じ値にはできません。
- 次の表のconversion_value 1、2、62のように、値は重複せず、連続した順序になっている必要があります。
- event_counter：Meta広告では、この値は使用しません。［推奨］1を設定してください。
例：デコードマッピング
| conversion_ value |
event_ name |
event_ value |
min_revenue （下限値を含まない） |
max_revenue（上限値を含む） | event_ counter |
hours_from_ install |
|---|---|---|---|---|---|---|
| 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：細かいCV 1
| event_name | skad_revenue |
min_ revenue |
max_revenue |
event_value |
|---|---|---|---|---|
| install | ||||
| af_purchase | 1.5 | 0 | 3 | {abc} |
例B：細かいCV 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：細かいCV 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：細かいCV 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} |
デコードモードでのSSOT（Single Source of Truth）対応
概要
デコードモードでも、SSOTによるアトリビューションを利用できるようになりました。これにより、従来はエンコードモードに限られていた、インストールの重複除去を利用できます。エンコードモードを実装せずに、ノンオーガニックの成果をより正確に計測できます。
主なメリット
- インストールがAppsFlyerでアトリビューションされたか（ノンオーガニック）、されていないか（オーガニック）を、API経由でリアルタイムに確認できます。
- CVの更新時に、SSOTのアトリビューションシグナルを反映できます。
- 専用のSSOTフラグを追加したスキーマファイルをアップロードすることで、SSOT対応のデコードスキーマを使用できます。
- SSOTダッシュボードとData Lockerレポートを利用できます。
- アドネットワークをまたぐノンオーガニックインストールの重複を除去できます。
- アトリビューションとレポートの精度を高められます。
- 開発とQAを簡素化できます。
デコードモードでSSOTを有効にする手順
- AppsFlyer IDの取得：インストール時にSDKからAppsFlyer IDを取得します。
-
SSOT APIへの問い合わせ：AppsFlyer IDとアプリIDを使用し、そのインストールがAppsFlyerでアトリビューションされたかどうかを確認します。
-
APIは次の値を返します。
"is-non-organic-install": true/false
-
-
アトリビューションシグナルの反映：このシグナルを使用して、CVの設定ロジックを調整します。たとえば、該当するCVのエントリに
af_attribution_flagイベントを追加し、アトリビューション結果を反映します。 -
更新したスキーマファイルのアップロード：既存のデコードスキーマを使用します。 SSOTの帰属判定を反映するCVには、重複除去を示す
af_attribution_flagイベントを追加します。 -
レポートの確認
SSOTダッシュボードとData Lockerファイルに、デコードモードのデータも含まれるようになります。
よくある質問
Q：SSOTのアトリビューションフラグを取得するために、いつAPIに問い合わせればよいですか？
A：
-
インストールの直後にAPIに問い合わせてください。
-
アトリビューションの遅延を考慮し、10秒おきに最大5回まで問い合わせ直します。
-
または、精度を確保するため、インストールから25秒以上経過してから1回問い合わせる方法もあります。
デコードCSVファイルの仕様
CVは、1つ以上のアプリ内イベントにマッピングされます。
ファイルのルール
- 形式：CSVファイル
- 最大行数：640行＋ヘッダー行、合計641行。
- ヘッダー行には、ここに示す列名をすべて、表記を変えずに含める必要があります。推奨：添付のサンプルファイルをテンプレートとして使用してください。 SKAN 3およびSKAN 4のデコードCSVサンプルを参照してください。
- 列の先頭文字に、
=、+、-、@を使用しないでください（編集済み）。
デコードCSVファイルの仕様
| 列 | 値の入力が必須 | 内容 | 詳細 |
|---|---|---|---|
| conversion_value |
以下の場合に必須：
|
1〜63の整数 |
同じ細かいCVを複数行に記載できます。詳細は、例を参照してください。 |
| coarse_conversion_value |
SKAN 4のみが対象 |
文字列：
|
同じ粗いCVを複数行に記載できます。 |
| event_name | はい | 文字列 |
アプリ内イベント。 AppsFlyerに既に存在するイベントである必要はありません。 注意！アプリ内イベント名は、大文字と小文字を区別します。 ［推奨］収益のイベント名にはaf_skad_revenueを使用します。 |
| event_value | いいえ | 文字列 | 開発者が設定する文字列。広告主が自社システムでデコードするためのデータを含みます。通常はJSON形式です。 |
| min_revenue |
いいえ
|
整数または浮動小数点数 |
min_revenueとmax_revenueを使用して、USDの収益範囲を設定します。
注意！ Excelでファイルを作成する場合は、CSVに$記号が入らないよう、保存前に列の書式を通貨ではなく桁区切り形式に変更してください。 |
| max_revenue | いいえ |
min_revenueを入力する場合、max_revenueには0より大きい値が必要です。 説明は、min_revenueを参照してください。 |
|
| いいえ |
2021年6月7日以降、廃止されています。 min_revenueとmax_revenueを使用してください。
|
||
| event_counter | はい |
整数
|
例：ユーザーが同じイベントを5回実行した場合、5件のイベントが生成されます。 注意点：収益を送信する場合、報告される金額（USD）には、event_counterの値が掛けられます。つまり、min_revenue=0、max_revenue=3、event_counter=4の場合、報告される総収益は1.5×4＝6です。 例を参照してください。 |
| hours_from_install | はい | 整数 |
AppsFlyerは、この値を使用して、以下のようにインストール日を算出・設定します。
|
| postback_sequence_index |
必須。ただし、SKAN 4のみが対象 |
整数：
|
細かいCVの場合、受信する値は0のみです。 |
CVスキーマファイルのアップロード
開始する前に：
- CVスキーマのCSVファイルを用意します。
- Meta広告と連携して収益を計測する場合は、スキーマがMetaに関するルールに従っていることを確認します。従っていない場合、Meta広告がスキーマを読み取れません。
デコードによるSKAN計測を有効にする手順：
- AppsFlyerで、［設定］＞［SKAN Conversion Studio］に移動します。
- オプション（⋮）をクリックし、［デコードマッピングファイルをアップロード］を選択します。
- まだSKAN 4にアップグレードしていない場合は、SKAN 4用か、それ以前のバージョン用かを選択してファイルをアップロードします。 SKAN 4にアップグレードすると、ほかのバージョンは選択できなくなります。
- 以下のいずれかを行います。
- ［ファイルをドラッグ＆ドロップ］をクリックします。
- 更新したマッピングファイルをアップロードします。
- 画面の指示に従って、ファイルをアップロードします。
- ［SKAN計測］をオンにします。
-
［変更を保存］をクリックします。
注意：その後48〜72時間は、ダッシュボードのデータを正しく解釈できない場合があります。 iOSタイマーの影響で、デコードに使うマッピングが、CVの設定に使ったエンコードマッピングと一致しているか判断できないためです。 - パートナーがポストバックを正しく処理できるよう、アプリ内イベントがパートナー側のイベントにマッピングされていることを確認してください。
CSVアップロードのエラーファイルに関するトラブルシューティング
アップロード時のエラーメッセージ
ファイル内の1つ以上の値が、必要な形式と一致していません：2021年6月7日にファイル形式が変更されています。この記事の例と、ファイルの形式が一致していることを確認してください。
Excelでのevent_revenue_usd列の書式設定
ExcelまたはGoogleスプレッドシートでCSVを作成する場合は、CSVとして保存する前に、event_revenue_usd列を正しい書式に設定する必要があります。
CSVを保存した後、内容が正しい形式になっていることを確認してください。注意：確認にはExcelを使用せず、テキストエディターを使用してください。
Excelでのevent_revenue_usdセルの書式設定
図のように、Excelでは通常、数値のセルに3桁ごとの桁区切り記号が入ります。この書式は、アップロード用CSVファイルには適していません。 $記号も削除する必要があります。
Excelでセルの書式を変更すると、修正できます。
支出額から桁区切りのカンマと$記号を除く手順：
- 書式を変更するセルを選択します。
- 右クリックし、［セルの書式設定］を選択します。
［セルの書式設定］ウィンドウが開きます。 -
［数値］を選択します。
- ［桁区切り（,）を使用する］のチェックを外します。
- ［任意］小数点以下の桁数を設定します。デフォルトは2です。指定できる最大値は5です。
-
［OK］をクリックします。
セルが正しい書式になります。
Excel以外でCSVファイルを目視確認
CSVファイルの内容は、テキストエディターで開いて確認してください。
- Windows：メモ帳、Notepad++
- macOS: TextEdit
以下は、サンプルCSVファイルをテキストエディターで開いた画面です。
エディターでの表示
テキストエディターでCSVファイルを確認します。特に、以下の点に注意してください。
- 空白：フィールドを区切るカンマの前後に、余分な空白がないことを確認します。 Excelでは、@trimコマンドを使用して空白を削除します。
-
event_revenue_usd：event_revenue_usd列の値に、カンマや$記号が含まれていないことを確認します。
Excelで作成したCSVの区切り文字がカンマにならない
Excelが、カンマではなくセミコロン「;」などを区切り文字にしたCSVを作成する場合があります。
- これは、コンピューターの地域設定が英語以外の言語・地域になっている場合に発生します。
- 特に、地域設定でドイツ語を選択している場合によく見られます。
- 解決方法は、OSがmacOSかWindowsかによって異なります。
- Microsoftの情報やフォーラムなどで、最新の対処方法を検索してください。検索語の例：OS名（macOSまたはWindows）Excel CSVファイル 区切り文字 変更。