概要:AppsFlyer ROI360の一部であるコストインポート機能を使用し、アップロードまたはメールでCSVファイルをインポートすることで、マーケティングコストを完全かつ正確に把握できます。
仕様
コストインポート:
- あらゆるマーケティング活動(モバイルキャンペーン、インフルエンサーキャンペーン、CTVなど)のキャンペーンコストをAppsFlyerで取得します。これは、APIや計測リンクでコストをレポートしないメディアソースにとって特に重要です。
- 既存のコストデータをさかのぼって上書きし、修正します。
コストは、AppsFlyerにアップロードまたはメールで送信されるCSVファイルでレポートされます。AppsFlyerがファイルを受信すると、データは処理され、数時間以内にダッシュボードとレポートで利用できるようになります。これにより、キャンペーンのコストとROIの全体像を把握できます。
注:
- アドネットワークは、関連する権限が提供されている場合、顧客のコストファイルをインポートできます。
- 代理店はファイルを準備できますが、広告主はファイルをアップロードする必要があります。
手順
コストインポートを使用してAppsFlyerにコストデータを送信するには、次のことを行う必要があります:
- 送信するコストデータのCSVファイルを準備します。
- 次のいずれかの方法でAppsFlyerにファイルを送信します:
- AppsFlyer管理画面でアップロードします。
- メール経由でアップロードします。 - 注:CTV、PC、コンソール プラットフォームのアプリの場合は、この方法のみを使用します。
詳細な手順については、以下のセクションを参照してください。
コストデータを含むCSVファイルの準備
広告主、アドネットワーク、代理店は、コストインポートCSVファイルを準備できます。参照:サンプルファイル
CSVファイルを準備するには:
- 次の表で詳しく説明されているファイルスキーマ、形式、およびルールに従います。
- 注:Excel または Google スプレッドシートを使用してファイルを作成する場合は、 ExcelとGoogle スプレッドシートの書式設定手順に従ってください。
CSVスキーマ
カラム名 (大文字と小文字を区別してください) |
フォーマット/備考 |
例 |
必須 |
---|---|---|---|
date |
|
|
✓ |
app-id |
|
|
✓ |
media-source |
|
network_x_int |
✓ |
campaign |
|
campaign_a |
✓ 注:アトリビューションデータに名前とIDの存在する場合は、CSVには両方を含める必要があります。 |
広告費 |
|
2874.12345
|
✓ |
geo |
|
US, CN, AU
|
いいえ |
通貨 |
|
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 | いいえ |
チャネル |
形式:文字列 | 動画 | いいえ |
キーワード |
形式:文字列 |
|
いいえ |
代理店 |
|
代理店名 | いいえ |
注意:英語以外の文字を含む名前は、UTF-8 を使用してエンコードする必要があります。 |
CSV形式とルール
ルール | 要件 |
---|---|
禁止文字 |
文字列形式の項目の最初の文字として、 |
アプリ所有者 |
1ファイルごとに1つのアプリ所有者のデータ。同一アカウント内の複数のアプリのデータ送付も可能です。 |
ファイル名の拡張子 |
CSV例: abc123.csv |
ファイル構造 |
|
広告パラメータの階層 |
コストはキャンペーンレベルで記録する必要があり、広告階層の他のディメンションはあくまでオプションです。 下位階層でアップロードされる部分的なデータは、キャンペーンレベル以降のデータをすべて上書きします。 例:広告セット1のキャンペーンコストを含むファイルをインポートし、同じキャンペーンの広告セット2の別のファイルを別々にインポートすると、キャンペーンの合計費用が置き換えられ、広告セット2のデータのみが表示されます。インポートするファイルにadset1とadset2のデータを含める必要があります。 |
ファイルをアップロード
広告主とアドネットワークは、コストインポートCSVファイルをアップロードできます。
前提条件:アドネットワークは、広告主からのコストインポート許可権限を得ている必要があります。
AppsFlyer管理画面からCSVファイルをアップロードする方法:
- AppsFlyer管理画面 左メニュー 設定 > コストインポートを選択します。
コストインポート画面が表示されます。 - クリック + コストファイルのインポート
インポートコスト画面が開きます。
- CSVファイルをコストファイルのインポート画面にドラッグします。
ファイルを処理しているメッセージが表示されます。 - アップロード中にエラーメッセージが表示された場合:エラーを修正して、関連する手順を繰り返してください。
- コストインポート:ファイルの概要ウィンドウが開きます。
- 次のいずれかを実行してください:
- アップロードを中止し、インポートのキャンセルをクリックします。
- インポートプロセスを完了し、ファイルのインポートをクリックします。
All set! というメッセージが表示されます。 - エラーメッセージが表示された場合は、 エラーメッセージの指示に従ってください。
- 別のファイルをインポートまたは完了をクリックします。
メールファイル
広告主とアドネットワークは、コストインポートCSVファイルをメールで送信できます。
前提条件:
-
広告主:
- 送信者のメールアドレスは、AppsFlyerの登録ユーザー宛てである必要があります。
-
アドネットワーク:
- 送信者のメールアドレスは、AppsFlyerの登録ユーザー宛てである必要があります。
- 広告主からのコストインポート許可
CSVファイルをメールで送信する:
-
メールインポート用のトークンを取得します。
- AppsFlyer管理画面 左メニュー 設定 > コストインポートへ進みます。
- ページの右上にある メールインポート用のトークンをクリックします。
- トークンをコピーして保存します。
- 次のフィールドを使用してEメールを作成します:
-
宛先:
adspend-upload@appsflyer.com
- CC:自動フィードバックのコピーを取得する必要があるユーザーのメールアドレスを入力してください。
- 件名:メールのインポート用のトークンを件名フィールドに貼り付けます。
- 添付ファイル:CSVファイルとデータ。
-
宛先:
-
メールを送信してください。
- ファイルが受信されて処理されると、処理中に見つかった詳細、問題、またはエラーをまとめたステータス メールが送信されます。メールは、送信メールに含まれていた宛先と広告主のAdminアカウントへ送信されます。エラーが特定された場合は、 エラーメッセージの指示に従ってください。
- 送信されたファイルのステータスは、コストインポート画面で確認できます。
管理画面
コストインポート画面では、ファイルをアップロードしたり、以前にアップロードしたファイルの詳細を表示したりできます。
コストインポートダッシュボード
コストインポートダッシュボードを表示するには、AppsFlyerのサイドメニューから、 設定 > コストインポートへ移動します。
以前にインポートしたファイルで使用可能な情報の詳細については、次の表で説明します。
カラム名 | 説明 |
---|---|
CSVファイル名 | AppsFlyerにインポートされたコストファイルの名前 |
データのアップロード | ファイルがインポートされた日付 |
メディアソース | ファイルに含まれるメディアソース |
期間 | 広告費が発生したファイル内の最初と最後の日付 |
一致した行 (%) |
コストがアトリビューションと一致したファイル内の行の割合(詳細はこちら) |
ステータス |
インポートされたファイルのステータス:
|
アクション |
|
一致した行数
行マッチングとは、インポートによってレポートされたコストがAppsFlyerに記録されたアトリビューションデータとマッチングされるプロセスです。これは、メディアソース、キャンペーン、広告セット、広告など、利用可能なすべてのディメンション名(IDではない)を使用して行われます。全てが一致する場合、行は is-matching=TRUE と指定されます。
コストは記録され、一致したステータスに関係なく、AppsFlyerの管理画面とレポートで確認できます。
一致した行の割合がインポート画面に表示されます。一致しない行が予期しない場合、または一致した行の数 (%) が予想よりも多い場合は、次のようになります:
- 不一致レポートをダウンロードして、原因を調査します。不一致レポートには、is-matched という列が含まれており、TRUE(一致)または FALSE(不一致)という値が記載されます。
- 必要に応じて、インポートを元に戻してキャンセルします。
- 詳細については、この表の「アクション」セクションを参照してください。
追加情報
ExcelやGoogleスプレッドシートを使ってCSVファイルを作成
Excel または Google スプレッドシートを使用して CSV ファイルを準備する場合、ファイルを CSV ファイルとして保存する前に、日付列と支出列の形式を正しく設定する必要があります。CSV ファイルを保存した後、コンテンツが正しくフォーマットされていることを確認します。次のガイドラインを使用して、次のことを行います:
- 日付セルを書式設定します。
- スペンド(広告費)セルを書式化します。
- コンテンツの形式を確認します。
日付セルの書式
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ファイルのサンプルのスクリーンショットです。
メールインポートのトークン
広告費トークンは、メール送信者が広告費ファイルの送信を承認されていることを確認するために使用されます。
広告主とアドネットワークのトークンは異なります。
-
広告主のトークン:
- 同じトークンがアカウント内のすべてのアプリに有効です。
- トークンは、どのアカウントユーザーでも取得できます。
-
アドネットワークの広告費トークン :
- 同じトークンがすべての広告主に対して使用されます。 )
広告主と広告アドネットワークは、トークンを互いに共有すべきではありません。
アドネットワークのコストインポート権限
アドネットワークは、コストインポートにアクセスするために、アプリごとに広告主の許可が必要です。
アドネットワークにコストインポート権限を付与するには:
- AppsFlyerでは、 広告主 はAppsFlyer管理画面 左メニュー 連携 > 連携済みパートナー を選択する必要があります。
連携済みパートナー画面が表示されます。 - 連携済みパートナーを選択してください。
- 権限タブへ進んでください。
- もしまだであれば、 アドネットワーク(パートナー)権限 を有効にしてください。
- (オプション) アカウントユーザーを追加します。
- コストインポートを使用を有効に設定します。
- 最後に、権限を保存をクリックしてください。
トラブルシューティング、特性、制限事項
エラーメッセージと解決策
次の表に、考えられるすべてのコストインポートエラーメッセージと対応する解決策を示します。
エラーメッセージ | 説明 | 解決策 |
---|---|---|
ファイルに指定されたアプリIDはAppsFlyerに存在しません。正しいアプリIDが指定されているか確認してください。 | アカウントにアプリIDが存在しません。 | アプリIDを変更して再提出してください。 |
行 [行名] の列数が間違っています。期待される列数:[数値] 列、受信した列数:[数値] 列。 |
ファイル内のすべての列に値が必要です。 | 定義したヘッダーに基づいてファイル内の値を変更してください。 |
ファイルのヘッダーに 'media-source' がありません。 |
|
ヘッダー名にmedia-source を追加します。 |
ファイルには1つのみのメディアソースを含めることができます。複数のメディアソースがファイルに存在します:[メディアソースの数] | 1つ以上のメディアソースを含むファイルをアップロードすることはできません。 | メディアソースごとに1つのファイルに分割してアップロードしてください。 |
[項目] に指定された値 [値] はこの列に対して有効な値ではありません。 | 列のデータ形式が正しくありません。例えば、日付が yyyy-mm-dd ではなく dd-mm-yy になっています。 | 形式を修正して再アップロードしてください。 |
アプリに対して複数の通貨が見つかりました。ファイル内の各アプリには1つの通貨を使用してください。検出された通貨:%number of currencies% | アプリで使用できる通貨は1つのみです。 | アップロード内で1つの通貨のみを使用して再提出してください。 |
ファイル内の次の列のヘッダーはサポートされていません:[ファイルヘッダー] |
ファイルのヘッダーがスキームに一致しません。つまり、列名はスキームと完全に同じである必要があります。 |
サポートされていない列を削除して再提出してください。 |
ファイルヘッダーに必要な列がありません:[ファイルヘッダー] | ファイルヘッダーに必須の列が抜けています。 | 欠落している列とその値を追加して再提出してください。 |
アプリに将来の日付が含まれています:[日付] | 将来の日付は使用できません。 | 日付を今日の日付またはそれ以前の日付に修正し、再提出してください。 |
ファイルが空です。処理するデータがありません。 | ファイルが空です。 | ファイルにデータを入力し、再提出してください。 |
次の2つの行は、同じディメンションのため矛盾しています。ディメンションセットごとに1行分のコストを入力してください。 | 同じキー (必須) フィールドを持つ複数の行があります。 | 重複している行を削除し、再提出してください。 |
ファイルには1つの広告主アカウントからのデータのみを含めることができます。ファイルに異なる広告主が含まれています:[広告主名] | パートナーの場合、複数の広告主を一度にアップロードすることはできません。 | 広告主ごとにファイルを分割してアップロードしてください。 |
アプリ [アプリID] がアカウントに存在しません。アプリIDを確認してください。 | アプリIDが存在しません。 | アプリIDを修正し、再提出してください。 |
アプリ [アプリID] で地域(国)コードが見つかりませんでした。ISO 3166 の2文字のコードを使用してください。 | 地域が存在しません。 | 地域を修正し、再提出してください。 |
アプリ [アプリID] で通貨コードが見つかりませんでした。ISO 4217 3文字のコードを使用してください。 | 通貨が存在しません。 | 有効な通貨に変更し、再提出してください。 |
ファイル内の1つまたは複数のアプリの検証エラーが発生しました。詳細については、ファイル情報を参照してください。 | ファイル内に複数のエラーがあります。 | ファイルをダウンロードして、エラーを確認してください。 |
ファイルの処理中に内部エラーが発生しました。もう一度アップロードしてください。 |
|
1時間待ってから、もう一度アップロードしてください。 |
特性と制限
特性 | 備考 |
---|---|
アドネットワーク | サポートされています |
代理店 |
|
代理店の運用媒体の開示設定 | サポートされておらず、計測対象外です |
アプリ固有のタイムゾーン | サポートされています |
App-specific currency | サポート対象です。キャンペーンコストはアプリ毎に設定された通貨単位に換算されます。 |
キャンペーン名 | 複数のアプリに対して、同じキャンペーン名を使用することはできません。 使用した場合には1 つのアプリのコストが両方に適用されます。 |
項目名 |
キャンペーン階層のフィールド名が計測データに表示されているフィールド名と一致しない場合、それらは個別にカウントされます。 たとえば、キャンペーン名が一致していない場合、キャンペーンIDが同じであっても異なるキャンペーンとしてカウントされます。 |
ファイルサイズ |
CSVコストインポートファイルのサイズ制限:
|
オーガニックデータ | サポートされています |
非オーガニックデータ | サポートされています |
データ更新頻度 | Ad spend(広告費) |
過去データ |
サポート対象です。レポートされたコストは、最大90日間送信したデータを元に戻して修正できます。 |
リターゲティング | いいえ: |
アカウントユーザーのアクセス | 地域やメディアソースの制限があるユーザーは利用できません。 |