概要:AppsFlyer ROI360のコストインポートでは、CSVファイルをアップロードまたはメールで送信することで、マーケティングにかかる広告費を漏れなく正確に把握できます。
概要
コストインポートでは、次のことが可能です。
- モバイルキャンペーン、インフルエンサー施策、CTVなど、さまざまなマーケティング施策のキャンペーン広告費をAppsFlyerに取り込めます。特に、APIやアトリビューションリンク経由で広告費を送信しないメディアソースを利用する場合に役立ちます。
- 既存の広告費データをさかのぼって上書き・修正できます。
広告費は、CSVファイルをAppsFlyerにアップロードするか、メールで送信して報告します。 AppsFlyerがファイルを受信するとデータが処理され、数時間以内にダッシュボードとレポートで利用できるようになります。これにより、キャンペーンの広告費とROIの全体像を把握できます。
注意:
- アドネットワークは、必要な権限が付与されていれば、顧客の広告費ファイルをインポートできます。
- 代理店はデータをアップロードできません。代理店がファイルを作成し、広告主に送付してアップロードを依頼することは可能です。
手順
コストインポートで広告費データをAppsFlyerに送信するには、次の作業を行います。
- 送信する広告費データを含むCSVファイルを作成します。
- 次のいずれかの方法で、ファイルをAppsFlyerに送信します。
詳しい手順は、以下の各セクションを参照してください。
広告費データを含むCSVファイルの作成
コストインポート用のCSVファイルは、広告主、アドネットワーク、代理店が作成できます。サンプルファイルを確認
CSVファイルを作成するには:
- 以下の表に示すスキーマ、形式、ルールに従って作成します。
広告費データと併せて、アドネットワークが報告したクリック数とインプレッション数を含めることもできます。注意:ExcelまたはGoogleスプレッドシートでファイルを作成する場合は、ExcelとGoogleスプレッドシートでの書式設定手順に従ってください。
CSVスキーマ
|
列名 (大文字と小文字を区別) |
形式/補足 | 例 | 必須 |
|---|---|---|---|
| date |
|
|
✓ |
| app-id |
|
|
✓ |
| media-source |
|
network_x_int | ✓ |
| campaign |
|
campaign_a |
✓ 注意:アトリビューションデータに名前とIDの両方がある場合、照合させるにはCSVにも両方を含める必要があります。 |
| spend |
|
2874.12345
|
✓ |
| reported-clicks |
|
1200 | いいえ |
| reported-impressions |
|
45000 | いいえ |
| geo |
|
US, CN, AU
|
いいえ |
| currency |
|
USD, GBP, EUR, JPY |
いいえ 空欄の場合、デフォルトでUSDになります。 |
| campaign-id | 形式:文字列 | abc1234def |
いいえ 注意:アトリビューションデータに名前とIDの両方がある場合、照合させるにはCSVにも両方を含める必要があります。 |
| adset | 形式:文字列 | my_adset_1 | |
| adset-id | 形式:文字列 | id5678ghi | |
| ad | 形式:文字列 | my_ad_name | |
| ad-id | 形式:文字列 | id91011jkl | |
| site-id |
|
id1213mno | いいえ |
| channel | 形式:文字列 | video | いいえ |
| keywords | 形式:文字列 |
|
いいえ |
| agency |
|
AgencyName | いいえ |
| 注意:英語以外の文字を含む名前は、UTF-8でエンコードする必要があります。 | |||
CSVの形式とルール
| ルール | 要件 |
|---|---|
| 使用できない文字 | 文字列形式のフィールドでは、先頭の文字に=、+、-、@を使用できません。例えば、@example_campaignや=123は使用できません。 |
| アプリ所有者 | 1つのファイルに含められる広告主(アプリ所有者)は1社のみです。同じ広告主アカウントに属する複数のアプリを含めることは可能です。 |
| ファイルの拡張子 | CSV。例:abc123.csv |
| ファイルの構造 |
|
| 広告の階層 |
広告費はキャンペーン単位で記録する必要があります。広告階層内のその他のディメンションは任意です。 下位の階層のデータを一部だけアップロードしても、キャンペーン階層以下のすべてのデータが上書きされます。 例:広告セット1のキャンペーン広告費を含むファイルをインポートし、その後、同じキャンペーンの広告セット2を別のファイルでインポートすると、キャンペーンの総費用が置き換わり、広告セット2のデータのみが表示されます。キャンペーンの総費用を反映するには、インポートするファイルに広告セット1と広告セット2の両方を含める必要があります。 |
ファイルのアップロード
広告主とアドネットワークは、コストインポート用のCSVファイルをアップロードできます。
前提条件:アドネットワークは、広告主からコストインポートの権限を付与されている必要があります。
AppsFlyerの管理画面からCSVファイルをアップロードするには:
- AppsFlyerのサイドメニューから[設定]>[コストインポート]を選択します。
コストインポートページが表示されます。 -
[+広告費ファイルをインポート]をクリックします。
広告費インポートのウィンドウが開きます。
- CSVファイルを[広告費ファイルをインポート]ウィンドウにドラッグします。
ファイルを処理中であることを示すメッセージが表示されます。 - アップロード中にエラーメッセージが表示された場合は、エラーを修正し、該当する手順をやり直してください。
- [コストインポート:ファイルの概要]ウィンドウが開きます。
- 次のいずれかの操作を行います。
- アップロードを中止する場合は、[インポートをキャンセル]をクリックします。
- インポートを完了する場合は、[ファイルをインポート]をクリックします。
「完了しました!」というメッセージが表示されます。 - エラーメッセージが表示された場合は、エラーメッセージの対処方法に従ってください。
- [別のファイルをインポート]または[完了]をクリックします。
ファイルのメール送信
広告主とアドネットワークは、コストインポート用のCSVファイルをメールで送信できます。
前提条件:
-
広告主:
- 送信元メールアドレスは、AppsFlyerに登録済みのユーザーのものである必要があります。
-
アドネットワーク:
- 送信元メールアドレスは、AppsFlyerに登録済みのユーザーのものである必要があります。
- 広告主からコストインポートの権限を付与されている必要があります。
CSVファイルをメールで送信するには:
-
メールインポート用トークンを取得します。
- AppsFlyerのサイドメニューから[設定]>[コストインポート]を選択します。
- ページ右上の[メールインポート用トークン]をクリックします。
- トークンをコピーして保存します。
- 次の内容でメールを作成します。
-
宛先:
adspend-upload@appsflyer.com - CC:自動返信による処理結果を共有するユーザー
- 件名:メールインポート用トークンを件名に貼り付けます。
- 添付ファイル:データを含むCSVファイル。
-
宛先:
-
メールを送信します。
- ファイルの受信・処理が完了すると、処理の詳細、検出された問題やエラーをまとめたステータスメールが届きます。このメールは、ファイル送信時のメールに含まれるすべての関係者と、広告主の管理者に送信されます。エラーが見つかった場合は、エラーメッセージの対処方法に従ってください。
- 送信したファイルのステータスは、コストインポートダッシュボードで確認できます。
ダッシュボード
コストインポートダッシュボードでは、ファイルのアップロードと、過去にアップロードしたファイルの詳細の確認ができます。
コストインポートダッシュボード
コストインポートダッシュボードを開くには、AppsFlyerのサイドメニューから[設定]>[コストインポート]を選択します。
インポート済みファイルについて確認できる情報を、以下の表に示します。
| 列名 | 説明 |
|---|---|
| CSVファイル名 | AppsFlyerにインポートした広告費ファイルの名前。 |
| アップロード日 | ファイルをインポートした日付。 |
| メディアソース | ファイルに含まれるメディアソース。 |
| 対象期間 | ファイル内で広告費が発生した最初の日付と最後の日付。 |
| 一致した行(%) | ファイル内で、広告費がアトリビューションデータと一致した行の割合。詳細はこちら。 |
| ステータス |
インポートしたファイルのステータス:
|
| 操作 |
|
一致した行
行の照合とは、インポートした広告費と、AppsFlyerに記録されたアトリビューションデータを照合する処理です。メディアソース、キャンペーン、広告セット、広告など、利用可能なすべてのディメンションの名前(IDではありません)を使用して照合します。すべて一致した行には、is-matching=TRUEが設定されます。
一致したかどうかにかかわらず、広告費は記録され、AppsFlyerのダッシュボードとレポートで利用できます。
一致した行の割合は、コストインポートダッシュボードに表示されます。想定外の不一致行がある場合や、一致した行の割合(%)が想定より高い場合は、次の手順で確認します。
- 不一致レポートをダウンロードし、原因を調べます。不一致レポートには「is-matched」列があり、各行にTRUE(一致)またはFALSE(不一致)が設定されます。
- 必要に応じて、インポートを取り消します。
- 詳しくは、この表の「操作」を参照してください。
補足情報
ExcelまたはGoogleスプレッドシートでのCSVファイルの作成
ExcelまたはGoogleスプレッドシートでCSVファイルを作成する場合は、CSV形式で保存する前に、date列(日付)とspend列(広告費)の書式を正しく設定する必要があります。 CSVファイルを保存した後に、内容の形式が正しいことを確認してください。以下の手順に従って、次の作業を行います。
- 日付セルの書式設定。
- spendセルの書式設定。
- 内容の形式の確認。
日付セルの書式設定
Excelで日付セルをYYYY-MM-DD形式に設定するには:
- 書式を設定するセルを選択します。
- 右クリックし、[セルの書式設定]を選択します。
セルの書式設定ウィンドウが開きます。 - [ユーザー定義]を選択します。
- [種類]フィールドにYYYY-MM-DDと入力します。
-
[OK]をクリックします。
日付の書式が設定されます。
spendセルの書式設定
Excelでは通常、以下の画像のように、数値のセルに3桁区切りのカンマが設定されます。この書式はコストインポート用ファイルには適していません。
spendセルの3桁区切りのカンマを無効にするには:
- 書式を設定するセルを選択します。
- 右クリックし、[セルの書式設定]を選択します。
セルの書式設定ウィンドウが開きます。 -
[数値]を選択します。
- [桁区切り(,)を使用する]のチェックを外します。
- 任意で、[小数点以下の桁数]を設定します。デフォルトは2桁です。最大5桁まで指定できます。
-
[OK]をクリックします。
セルの書式が正しく設定されます。
内容の形式の確認
内容の形式を確認するには:
- エディターでファイルを開きます。
- Windows:メモ帳、Notepad++
- macOS:テキストエディット
- 特に以下の点を確認してください。
- 空白:フィールドを区切るカンマの前後で、値の先頭や末尾に不要な空白がないことを確認してください。 Excelでは、@trimコマンドで空白を削除できます。
- 日付:日付セルがYYYY-MM-DD形式になっていることを確認してください。
- 広告費:spendセルにカンマが含まれていないことを確認してください。
-
区切り文字:カンマである必要があります。セミコロンになっている場合:
- コンピューターの地域設定が英語以外の言語・地域、特にドイツ語に設定されていると、この問題が発生することがあります。
- 対処方法は、コンピューターのOS(macOSまたはWindows)によって異なります。
- 解決方法は、Microsoftやその他のフォーラムで最新の案内を検索してください。検索語句の例:OS名(macOSまたはWindows)、Excel、CSVファイルの区切り文字の変更。
以下の画像は、サンプルCSVファイルをエディターで開いた画面です。
メールインポート用トークン
メールインポート用トークンは、メールの送信者にコストインポート用ファイルの送信権限があることを確認するために使用します。
広告主とアドネットワークでは、トークンが異なります。
-
広告主のトークン:
- 同じトークンを、アカウント内のすべてのアプリに使用できます。
- アカウント内のどのユーザーでも取得できます。
-
アドネットワークのトークン:
- すべての広告主に同じトークンを使用します。
広告主とアドネットワークの間でトークンを共有しないでください。
アドネットワークのコストインポート権限
アドネットワークがコストインポートを利用するには、アプリごとに広告主から権限を付与される必要があります。
アドネットワークにコストインポートの権限を付与するには:
- AppsFlyerで、広告主がサイドメニューから[コラボレーション]>[有効な連携]を選択します。
連携済みパートナーページが表示されます。 - 連携済みパートナーを選択します。
- [権限]タブを開きます。
- [アドネットワークの権限]が有効になっていない場合は、有効にします。
- 任意で、アカウントユーザーを追加します。
- [コストインポートの使用]を有効にします。
- [権限を保存]をクリックします。
トラブルシューティング・仕様・制限事項
エラーメッセージと対処方法
コストインポートで表示されるエラーメッセージと対処方法を、以下の表に示します。
| エラーメッセージ | 説明 | 対処方法 |
|---|---|---|
| ファイルに指定されたアプリIDが、AppsFlyerに1つも存在しません。アプリIDが正しいことを確認してください。 | アカウントにアプリIDが存在しません。 | アプリIDを変更して再送信してください。 |
| 行[line name]の列数が正しくありません。列数は[number]列である必要がありますが、[number]列が指定されています。 | ファイル内のすべての列に値が必要です。 | 設定したヘッダーに合わせて、ファイル内の値を修正してください。 |
| ファイルのヘッダーに「media-source」がありません。 |
|
ヘッダー名としてmedia-sourceを追加してください。 |
| ファイルに含められるメディアソースは1つのみです。ファイル内に複数のメディアソースが見つかりました:[number of media sources]。 | ファイルに複数のメディアソースが含まれています。 Excel上では見えない空の行や、形式が不正な行がCSV内にある場合も、このエラーが発生することがあります。 | Notepad++などのテキストエディターでファイルを開き、空の行や形式が不正な行を削除してください。ファイルを保存し、再度アップロードしてください。ファイルに複数のメディアソースが含まれる場合は、メディアソースごとにファイルを分けてください。 |
| [field]に指定された値[value]は、この列で使用できません。 | 列のデータ形式が正しくありません。例えば、日付がyyyy-mm-ddではなくdd-mm-yyになっています。 | 形式を修正して再送信してください。 |
| 1つのアプリに複数の通貨が指定されています。ファイル内では、アプリごとに1つの通貨を使用してください。検出された通貨数:%number of currencies%。 | 1つのアプリで使用できる通貨は1つのみです。 | 通貨を1つに揃えて再送信してください。 |
| ファイルのヘッダーに、対応していない列があります:[file headers] | ファイルのヘッダーがスキーマと一致していません。列名は、スキーマに示す名前と完全に一致している必要があります。 | 対応していない列を削除して再送信してください。 |
| ファイルのヘッダーに必須の列がありません:[file headers] | ファイルのヘッダーに必須の列がありません。 | 不足している列と値を追加して再送信してください。 |
| アプリのデータに未来の日付が含まれています:[date] | 未来の日付は使用できません。 | 日付を本日以前に修正し、再送信してください。 |
| ファイルが空です。処理するデータがありません。 | ファイルが空です。 | ファイルにデータを入力して再送信してください。 |
| 次の2行は、ディメンションが同じため競合しています。同じディメンションの組み合わせに対する広告費は、1行にまとめてください。 [conflicting rows] | キー(必須)フィールドが同じ行が複数あります。 | 重複する行を削除して再送信してください。 |
| ファイルに含められるのは、1つの広告主アカウントのデータのみです。ファイル内に異なる広告主が見つかりました:[advertiser names] | パートナーによるアップロードでは、複数の広告主のデータをまとめることはできません。 | 広告主ごとにファイルを分けてアップロードしてください。 |
| アカウントにアプリ[app ID]が存在しません。アプリIDを確認してください。 | アプリIDが存在しません。 | アプリIDを修正して再送信してください。 |
| アプリ[app ID]の地域(国)コードが見つかりませんでした。 ISO 3166の2文字のコードを使用してください。 | 地域が存在しません。 | 地域コードを修正して再送信してください。 |
| アプリ[app ID]の通貨コードが見つかりませんでした。 ISO 4217の3文字のコードを使用してください。 | 通貨が存在しません。 | 有効な通貨に変更して再送信してください。 |
| ファイル内の1つ以上のアプリに検証エラーがありました。詳しくは、ファイルの情報を確認してください。 | ファイルに複数のエラーがあります。 | ファイルをダウンロードし、エラーを確認してください。 |
| ファイルの処理中に内部エラーが発生しました。再度アップロードしてください。 |
|
1時間待ってから、再度アップロードしてください。 |
仕様と制限事項
| 項目 | 補足 |
|---|---|
| アドネットワーク |
対応。 例外:
|
| 代理店 |
|
| 運用媒体の開示設定 | 非対応 |
| アプリ固有のタイムゾーン | 対応 |
| アプリ固有の通貨 | 対応。キャンペーンの広告費は、アプリ固有の通貨に換算されます。 |
| キャンペーン名 | 複数のアプリで同じキャンペーン名を使用すると、一方のアプリの広告費が両方に適用されるため、同じ名前は使用できません。 |
| フィールド名 |
キャンペーン階層のフィールド名がアトリビューションデータの表記と一致しない場合、別々に集計されます。 例えば、キャンペーンIDが同じでも、キャンペーン名が一致しない場合は、異なるキャンペーンとして集計されます。 |
| ファイルサイズ |
コストインポート用CSVファイルのサイズ上限は以下のとおりです。
|
| オーガニックデータ | 対応 |
| ノンオーガニックデータ | 対応 |
| データの更新・反映 | 広告費 |
| 過去のデータ | 対応。報告済みの広告費の取り消しと、修正データの再送信は、最大90日前のデータまで可能です。 |
| リターゲティング | 非対応。 |
| アカウントユーザーのアクセス権 | 地域またはメディアソースによるアクセス制限があるユーザーは利用できません。 |