概要:AppsFlyer ROI360の一部であるコストインポート機能を使用し、アップロードまたはメールでCSVファイルをインポートすることで、マーケティングコストを完全かつ正確に把握できます。
Overview
コストインポート:
- あらゆるマーケティング活動(モバイルキャンペーン、インフルエンサーキャンペーン、CTVなど)のキャンペーンコストをAppsFlyerで取得します。これは、APIや計測リンクでコストをレポートしないメディアソースにとって特に重要です。
- 既存のコストデータをさかのぼって上書きし、修正します。
コストは、AppsFlyerにアップロードまたはメールで送信されるCSVファイルでレポートされます。 AppsFlyerがファイルを受信すると、データは処理され、数時間以内にダッシュボードとレポートで利用できるようになります。これにより、キャンペーンのコストとROIの全体像を把握できます。
メディアソース名(AppsFlyerに表示されている通り)- 注意:必要に応じて、末尾に _int サフィックスを含めます。
- アドネットワークは、関連する権限が提供されている場合、顧客のコストファイルをインポートできます。
- 代理店アカウントでは、広告費データのアップロードを行うことはできません。ファイルを準備し、広告主に送信して、広告主アカウントからのみアップロードできます。
手順
コストインポートを使用してAppsFlyerにコストデータを送信するには、次のことを行う必要があります:
- 送信するコストデータのCSVファイルを準備します。
- 次のいずれかの方法でAppsFlyerにファイルを送信します:
- AppsFlyer管理画面でアップロードします。
- メール経由でアップロードします。注:CTV、PC、コンソール プラットフォームのアプリの場合は、この方法のみを使用します。
詳細な手順については、以下のセクションを参照してください。
コストデータを含むCSVファイルの準備
広告主、アドネットワーク、代理店は、コストインポートCSVファイルを準備できます。参照:サンプルファイル
CSVファイルを準備するには:
- 次の表で詳しく説明されているファイルスキーマ、形式、およびルールに従います。You can optionally include the ad network's reported clicks and reported impressions alongside your cost data.
注: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 |
いいえ。 Will default to USD if left empty. |
| 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_campign や =123 は禁止されています。 |
| アプリ所有者 | 1ファイルごとに1つのアプリ所有者のデータ。同一アカウント内の複数のアプリのデータ送付も可能です。 |
| ファイル名の拡張子 | CSV例: abc123.csv |
| ファイル構造 |
|
| 広告パラメータの階層 |
コストはキャンペーンレベルで記録する必要があり、広告階層の他のディメンションはあくまでオプションです。 下位階層でアップロードされる部分的なデータは、キャンペーンレベル以降のデータをすべて上書きします。 例:広告セット1のキャンペーンコストを含むファイルをインポートし、同じキャンペーンの広告セット2の別のファイルを別々にインポートすると、キャンペーンの合計費用が置き換えられ、広告セット2のデータのみが表示されます。インポートするファイルにadset1とadset2のデータを含める必要があります。 |
ファイルのアップロード
広告主とアドネットワークが、コストインポートCSVファイルをアップロードできます。
添付ファイル:CSVファイルとデータ。
AppsFlyer管理画面からCSVファイルをアップロードする方法:
- AppsFlyer管理画面 左メニュー 設定 > コストインポートを選択します。
コストインポート画面が表示されます。 - クリック + コストファイルのインポート
インポートコスト画面が開きます。
- CSVファイルをコストファイルのインポート画面にドラッグします。
ファイルを処理しているメッセージが表示されます。 - アップロード中にエラーメッセージが表示された場合:エラーを修正して、関連する手順を繰り返してください。
- コストインポート:ファイルの概要ウィンドウが開きます。
- 次のいずれかを実行してください:
- アップロードを中止し、インポートのキャンセルをクリックします。
- インポートプロセスを完了し、ファイルのインポートをクリックします。
All set! というメッセージが表示されます。 - If an error message displays, follow the error message instructions.
- 別のファイルをインポートまたは完了をクリックします。
メールファイル
広告主とアドネットワークは、コストインポートCSVファイルをメールで送信できます。
前提条件:
-
広告主:
- 送信者のメールアドレスは、AppsFlyerアカウントを所持しているユーザーである必要があります。
-
アドネットワーク:
- Sender email must be for a registered AppsFlyer user.
- 件名:メールのインポート用のトークンを件名フィールドに貼り付けます。
CSVファイルをメールで送信する:
-
メールインポート用のトークンを取得します。
- AppsFlyer管理画面 左メニュー 設定 > コストインポートへ進みます。
- ページの右上にある メールインポート用のトークンをクリックします。
- トークンをコピーして保存します。
- 次のフィールドを使用してEメールを作成します:
-
宛先:
adspend-upload@appsflyer.com - CC:自動返信によるコピーを取得する必要があるユーザーのメールアドレスを入力してください。
- 送信者のメールアドレスは、AppsFlyerアカウントを所持しているユーザーである必要があります。
- 前提条件:アドネットワークは、広告主からのコストインポート許可権限を得ている必要があります。
-
宛先:
-
メールを送信してください。
- ファイルが受信されて処理されると、処理中に見つかった詳細、問題、またはエラーをまとめたステータスメールが送信されます。メールは、送信メールに含まれていた宛先と広告主のアドミンアカウントへ送信されます。エラーが特定された場合は、 エラーメッセージの指示に従ってください。
- 送信されたファイルのステータスは、コストインポート画面で確認できます。
Dashboard
コストインポート画面では、ファイルをアップロードしたり、以前にアップロードしたファイルの詳細を表示したりできます。
コストインポートダッシュボード
コストインポートダッシュボードを表示するには、AppsFlyerのサイドメニューから、 設定 > コストインポートへ移動します。
以前にインポートしたファイルで使用可能な情報の詳細については、次の表で説明します。
| カラム名 | 説明 |
|---|---|
| CSVファイル名 | AppsFlyerにインポートされたコストファイルの名前 |
| アップロード日 | ファイルがインポートされた日付 |
| メディアソース | ファイルに含まれるメディアソース |
| データ期間 | 広告費が発生したファイル内の最初と最後の日付 |
| 一致した行 (%) | The percentage of rows in the file where cost was matched to attribution. コストがアトリビューションと一致したファイル内の行の割合(Learn more) |
| ステータス |
インポートされたファイルのステータス:
|
| アクション |
|
一致した行数
行マッチングとは、インポートによってレポートされたコストがAppsFlyerに記録されたアトリビューションデータとマッチングされるプロセスです。これは、メディアソース、キャンペーン、広告セット、広告など、利用可能なすべてのディメンション名(IDではない)を使用して行われます。全てが一致する場合、行は is-matching=TRUE と指定されます。
コストは記録され、一致したステータスに関係なく、AppsFlyerの管理画面とレポートで確認できます。
一致した行の割合がインポート画面に表示されます。一致しない行が予期しない場合、または一致した行の数 (%) が予想よりも多い場合は、次のようになります:
- 不一致レポートをダウンロードして、原因を調査します。不一致レポートには、is-matched という列が含まれており、TRUE(一致)または FALSE(不一致)という値が記載されます。
- 必要に応じて、インポートを元に戻してキャンセルします。
- 詳細については、この表の「アクション」セクションを参照してください。
追加情報
ExcelやGoogleスプレッドシートを使ってCSVファイルを作成
Excel または Google スプレッドシートを使用して CSV ファイルを準備する場合、ファイルを CSV ファイルとして保存する前に、日付列と支出列の形式を正しく設定する必要があります。 CSV ファイルを保存した後、コンテンツが正しくフォーマットされていることを確認します。次のガイドラインを使用して、次のことを行います:
- 日付セルを書式設定します。
- Format the spend cells.
- コンテンツの形式を確認します。
日付セルの書式
Excelで日付セルをYYYY-MM-DDの形式でフォーマットするには :
- フォーマットするセルを選択してください。
- 右クリックして、 セルの書式設定を選択します。
セルの書式設定の画面が開きます。 - カスタムを選択してください。
- タイプフィールドに、 YYYY-MM-DDと入力してください。
-
OKをクリックしてください。
日付がフォーマットされます。
コストセルの書式設定
図に示すように、Excelでは通常、値のセルをコンマでフォーマットして千の値を区切ります。この形式は、コストインポートファイルには適していません。
1000 コンマ区切り文字なしでセルを書式設定するには:
- フォーマットするセルを選択してください。
- 右クリックして、 セルの書式設定を選択します。
セルの書式設定の画面が開きます。 -
数値を選択してください。
- 1000の区切り記号を使用 (,) をオフにしてください。
- (任意) 小数点以下の桁数を設定してください。デフォルト値は 2です。最大許容値は 5です。
-
OKをクリックしてください。
セルは正しくフォーマットされています。
コンテンツ形式を確認する
コンテンツの形式を確認するには:
- エディタを使用してファイルを表示します。
- Windows:メモ帳、メモ帳++
- MacOS:TextEdit
- 特に、次の点に注意してください。
- 空白:項目を区切るコンマの前後に、空白スペースがないことを確認してください。 Excelでは、@trimのコマンドを使用して空白スペースを削除してください。
- 日付:日付セルの形式が YYYY-MM-DD であることを確認します。
- 広告費:コストセルにカンマがないことを確認します。
-
区切り記号:コンマにする必要があります。セミコロンの場合:
- これは、コンピューターの地域設定が英語以外の言語 / 地域 (特にドイツ語) に設定されている場合に発生する可能性があります。
- 解決策は、お使いのコンピューターのオペレーティングシステム(macOSまたはWindows)によって異なります。
- この問題を解決するには、 Microsoftまたはその他のフォーラムからの最新のガイダンスを検索してください。次の検索ワードを使用します:オペレーティングシステム (macOS または Windows) CSVファイルの Excel 変更区切り文字。
以下は、エディターに表示されたCSVファイルのサンプルのスクリーンショットです。
メールインポートのトークン
The token for email import is used to verify that the email sender is authorized to submit the Cost Import file.
広告主とアドネットワークのトークンは異なります。
-
広告主のトークン:
- 同じトークンがアカウント内のすべてのアプリに有効です。
- トークンは、どのアカウントユーザーでも取得できます。
-
アドネットワークの広告費トークン :
- 同じトークンがすべての広告主に対して使用されます。
広告主と広告アドネットワークは、トークンを互いに共有すべきではありません。
アドネットワークのコストインポート権限
アドネットワークは、コストインポートにアクセスするために、アプリごとに広告主の許可が必要です。
アドネットワークにコストインポート権限を付与するには:
- AppsFlyerでは、 広告主 はAppsFlyer管理画面 左メニュー 連携 > 連携済みパートナー を選択する必要があります。
The Integrated Partner page displays. - Select the integrated partner.
- 権限タブへ進んでください。
- もしまだであれば、 アドネットワーク(パートナー)権限 を有効にしてください。
- (オプション) アカウントユーザーを追加します。
- コストインポートを使用を有効に設定します。
- 最後に、権限を保存をクリックしてください。
トラブルシューティング、特性、制限事項
エラーメッセージと解決策
次の表に、考えられるすべてのコストインポートエラーメッセージと対応する解決策を示します。
| エラーメッセージ | 説明 | 解決策 |
|---|---|---|
| ファイルに指定されたアプリIDはAppsFlyerに存在しません。正しいアプリIDが指定されているか確認してください。 | アカウントにアプリIDが存在しません。 | アプリIDを変更して再提出してください。 |
| 行 [行名] の列数が間違っています。期待される列数:[数値] 列、受信した列数:[数値] 列。 | ファイル内のすべての列に値が必要です。 | 定義したヘッダーに基づいてファイル内の値を変更してください。 |
| ファイルのヘッダーに 'media-source' がありません。 |
|
ヘッダー名にmedia-source を追加します。 |
| ファイルには1つのみのメディアソースを含めることができます。複数のメディアソースがファイルに存在します:[メディアソースの数] | ファイルに複数のメディアソースが含まれています。 CSV内に空行や不正な行が含まれている場合、Excel上では見えなくてもこのエラーが発生することがあります。 | Notepad++などのテキストエディタでファイルを開き、空行や不正な行を削除してください。ファイルを保存し、再度アップロードしてください。ファイルに複数のメディアソースが含まれている場合は、メディアソースごとにファイルを分割してください。 |
| [項目] に指定された値 [値] はこの列に対して有効な値ではありません。 | 列のデータ形式が正しくありません。例えば、日付が yyyy-mm-dd ではなく dd-mm-yy になっています。 | 形式を修正して再アップロードしてください。 |
| アプリに対して複数の通貨が見つかりました。ファイル内の各アプリには1つの通貨を使用してください。検出された通貨:%number of currencies% | アプリで使用できる通貨は1つのみです。 | アップロード内で1つの通貨のみを使用して再提出してください。 |
| ファイル内の次の列のヘッダーはサポートされていません:[ファイルヘッダー] | ファイルのヘッダーがスキームに一致しません。つまり、列名はスキームと完全に同じである必要があります。 | サポートされていない列を削除して再提出してください。 |
| ファイルヘッダーに必要な列がありません:[ファイルヘッダー] | ファイルヘッダーに必須の列が抜けています。 | 欠落している列とその値を追加して再提出してください。 |
| アプリに将来の日付が含まれています:[日付] | 将来の日付は使用できません。 | 日付を今日の日付またはそれ以前の日付に修正し、再提出してください。 |
| ファイルが空です。処理するデータがありません。 | ファイルが空です。 | ファイルにデータを入力し、再提出してください。 |
| 次の2つの行は、同じディメンションのため矛盾しています。ディメンションセットごとに1行分のコストを入力してください。 [conflicting rows] | 同じキー (必須) フィールドを持つ複数の行があります。 | 重複している行を削除し、再提出してください。 |
| ファイルには1つの広告主アカウントからのデータのみを含めることができます。ファイルに異なる広告主が含まれています:[広告主名] | パートナーの場合、複数の広告主を一度にアップロードすることはできません。 | 広告主ごとにファイルを分割してアップロードしてください。 |
| アプリ [アプリID] がアカウントに存在しません。アプリIDを確認してください。 | アプリIDが存在しません。 | アプリIDを修正し、再提出してください。 |
| アプリ [アプリID] で地域(国)コードが見つかりませんでした。 ISO 3166 の2文字のコードを使用してください。 | Geo does not exist. | 地域を修正し、再提出してください。 |
| アプリ [アプリID] で通貨コードが見つかりませんでした。 ISO 4217 3文字のコードを使用してください。 | 通貨が存在しません。 | 有効な通貨に変更し、再提出してください。 |
| ファイル内の1つまたは複数のアプリの検証エラーが発生しました。詳細については、ファイル情報を参照してください。 | ファイル内に複数のエラーがあります。 | ファイルをダウンロードして、エラーを確認してください。 |
| ファイルの処理中に内部エラーが発生しました。 もう一度アップロードしてください。 |
|
1時間待ってから、もう一度アップロードしてください。 |
特性と制限
| Trait | 備考 |
|---|---|
| アドネットワーク |
サポート対象 例外:
|
| 代理店 |
|
| Agency transparency | Not supported |
| アプリ固有のタイムゾーン | サポート対象 |
| App-specific currency | Supported. Campaign costs are converted to the app-specific currency. |
| キャンペーン名 | サポート対象キャンペーンコストはアプリ毎に設定された通貨単位に換算されます。 |
| 項目名 |
キャンペーン階層のフィールド名が計測データに表示されているフィールド名と一致しない場合、それらは個別にカウントされます。 たとえば、キャンペーン名が一致していない場合、キャンペーンIDが同じであっても異なるキャンペーンとしてカウントされます。 |
| ファイルサイズ |
CSVコストインポートファイルのサイズ制限:
|
| オーガニックデータ | サポート対象 |
| 非オーガニックデータ | サポート対象 |
| Data freshness | 広告費 |
| 過去データ | Supported. サポート対象レポートされたコストは、最大90日間送信したデータを元に戻して修正できます。 |
| リターゲティング | Not supported. |
| アカウントユーザーのアクセス | 地域やメディアソースの制限があるユーザーは利用できません。 |