広告費インポートガイド

広告費のCSVファイルのフォーマット、スキーマ、および検証のルールについてはこちらをご覧ください。ExcelまたはGoogleスプレッドシートを使用してファイルを作成する場合には、Excelフォーマットの手順 を確認してください。

サンプルファイルを参照してください。

読み進める前に、次のスクリーンショットに示すように、CSVファイルの準備で発生する最も一般的なエラーに注意してください。

広告費のCSVファイルのフォーマット、スキーマ、および検証のルールについては以下のセクションをご覧ください。ExcelまたはGoogleスプレッドシートを使用してファイルを作成する場合には、 Excelフォーマットの手順を確認してください。

コンテンツのルールと広告費CSVファイルのスキーマ

広告費CSVのスキーマ

広告費トークンは、メール送信者が広告費ファイルの送信を承認されていることを確認するために使用されます。広告主とアドネットワークで、広告費トークンは異なります。 

• 広告主の広告費トークン ：
  • 同じトークンがアカウント内のすべてのアプリに有効です。
  • どのアカウント・ユーザーでも広告費トークンを取得できます。
• アドネットワークの広告費トークン ：
  • 同じトークンがすべての広告主に対して使用されます。 
  • また、広告主は アドネットワークに対して 広告費のインポートファイルを送信する権限を付与する必要があります。 

広告費トークンを取得するには：

1. AppsFlyerで、 ROI360 > 広告費インポート画面へ移動します。
2. ページの右上にある [広告費トークンを表示] をクリックします。
   広告費トークンが表示されます。 
3. 広告費トークンをコピーして保存してください。

アドネットワークに広告費のインポート権限を付与するには：

1. 広告主アカウントで、AppsFlyer管理画面 > 設定 >連携済みパートナーへ移動します。
2. 連携済みパートナーを選択してください。
3. 権限タブへ移動してください。 
   
4. もしまだであれば、 アドネットワーク(パートナー)権限 を有効にしてください。
5. (オプション) アカウントユーザーを追加します。
6. コストデータのアップロードを許可する を有効にしてください。

前提条件 ：

• 広告主: 広告費トークンが必要です。
• アドネットワーク:
  
  • 広告費トークンが必要です。 
  • 広告主はパートナー（アドネットワーク）に対して広告費の取り込み権限を付与する必要があります。

広告費ファイルをメールで送信するには ：

1. メールアドレスのフィールドを埋めてください： 
   • To:adspend-upload@appsflyer.com
   • CC： 自動フィードバックのコピーを取得する必要があるユーザーのメールアドレスを入力してください。
   • 件名：  広告費トークン を貼り付けてください。 
   • 添付ファイル： 広告費データを含むCSVファイル
2. メールを送信してください。
   • 処理が完了すると、アップロードの概要と処理中に見つかった問題またはエラーの詳細を示すステータスメールが送信されます。メールは、送信メールに含まれていた宛先と広告主のAdminアカウントへ送信されます。エラーが検知された場合は、修正対応を行う必要があります。 注意：ステータスメールが受信されなかった場合は、 こちらをご覧ください。
   • 広告費インポートのページにて、送信されたファイルのステータスを確認できます。

広告費ファイルをアップロードするには ：

1. AppsFlyer管理画面 左メニュー ROI360 > 広告費インポート画面へ移動します。
   広告費のインポートのページが表示されます。 
2. + 広告コストファイルをアップロードするをクリックしてください。
   広告コストのアップロード画面が開きます。
   
3. CSVファイルを広告費ファイルのインポート画面にドラッグしてください。
   ファイルを処理しているメッセージが表示されます。
4. アップロード中にエラーメッセージが表示された場合：エラーを修正して、関連する手順を繰り返してください。
5. 広告費インポート：ファイルサマリー画面が開きます。

   

6. 以下を実行してください。
   • アップロードを中止し、[インポートのキャンセル] をクリックしてください。 
   • インポート処理を完了し、[ファイルのインポート]をクリックしてください。
     All set! というメッセージが表示されます。
7. [別のファイルをインポートする] もしくは [完了] をクリックしてください。

ファイル単位でインポートステータスを確認する方法：

• ROI360 >  広告インポート画面へ移動します。
  [広告費インポート] のページで、インポートされたファイルのリストが表示されます。
• ファイルに含まれるすべてのアプリに対するアクセス権限がある場合には、 Actionのコマンドを使用して次のことが行えます。
  
  • CSVファイルのダウンロード ：アップロードされたCSVファイルのコピーが取得できます。
  • 不一致レポートのダウンロード：ファイル内のすべてのアプリに関するデータです。

アプリ単位でインポートステータスを確認するには ：

• ファイルを選択してください。
  アプリ単位のページが表示されます。広告費ファイル内のアプリのリストが表示されます。

  

• 以下のように、ファイルレベルもしくはアプリレベルのアクションを実行してください。
• ファイルレベル: ファイルに含まれるすべてのアプリに対するアプリのアクセス許可がある場合は、ページの右上にあるコントロールを使用して次の操作を行うことができます。
  • ファイル内のすべてのアプリの広告費インポートを元に戻す （キャンセルする）。
  • インポートされたCSVファイルのコピーをダウンロードする。
• アプリレベル：特定のアプリに対するアプリのアクセス許可がある場合は、アクションコマンドを使用して同様の操作が可能です。
  • アプリのデータをダウンロードしてください。
  • アプリ毎の不一致レポートをダウンロードする。
  • 選択したアプリの広告費インポートを元に戻す（キャンセルする）。

行のマッチングは、インポート機能によって報告された広告費データの行と、管理画面上の計測データをマッチングさせるプロセスです。これは、メディアソース、キャンペーン、広告セット、広告など、ファイルのスキームで利用できる全てのディメンションを利用して実行されます。全てが一致する場合、行は is-matching=TRUE と指定されます。

名前 VS ID

広告費インポートでは、キャンペーン、広告セット、広告などのディメンションを、それらのIDではなく名前で識別します。現在、広告費用の取り込みでは、IDのみを使用した費用のレポートはサポートされていません。

注 ：一致状況に関係なく、広告費データは記録されます。

一致した行の割合がインポートページに表示されます。

不一致の行が予期しないものである場合は、 不一致レポートをダウンロードして原因を調査してください。必要であれば、インポートを元に戻してキャンセルしてください。

不一致レポートには、is-matched という列が含まれており、TRUE（一致）または FALSE（不一致）という値が記載されます。

一致した行の割合を表示する広告費インポートページ

以前に取り込んだ広告費データは、以前に取り込んだデータと同じキーを持つデータを含むCSVファイルを使用して上書きすることができます。

キーは、日付、メディアソース、およびキャンペーン名のフィールドから形成されます。キーが一致した場合、最後にインポートしたデータは、以前にインポートされたデータを上書きします。

以下は、広告費データの上書きの例です。

次の表には、すべての広告費インポートのエラーメッセージとそれに対応する解決策を示しています。

事象1：データインポートが成功したのに、コストデータが表示されない

1. 管理画面上で、キャンペーン名が重複して表示されているかどうかを確認してください。
2. もし重複している場合には、キャンペーンIDが空白になっている行を見つけてください。
   キャンペーンIDが空白の行に広告費のデータが含まれています。

事象2：インポートされたコストが、パフォーマンス（インストール）データなしで個別（追加の行）に表示されている。キャンペーンIDの行が空白です。

原因： アトリビューションデータにキャンペーンIDとキャンペーン名の両方が存在する場合、AppsFlyerがコストデータを正しく照合し、別の項目が発生しないようにするためには、CSVに両方が含まれている必要があります。

Excel / Googleシートを使用してCSVファイルを作成する場合、ファイルをCSVファイルとして保存する前に、日付(date)と支出(spend)の列を正しくフォーマットする必要があります。次の手順を使用して、日付(date)と費用(spend)のフィールドを正しくフォーマットしてください。

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

Excelでの日付セルのフォーマット

Excelで日付セルをYYYY-MM-DDの形式でフォーマットするには ：

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

   

3. カスタムを選択してください。
4. タイプフィールドに、 YYYY-MM-DDと入力してください。
5. OKをクリックしてください。
   日付がフォーマットされます。

Excelでの広告費セルのフォーマット

図に示すように、Excelでは通常、値のセルをコンマでフォーマットして千の値を区切ります。この形式は、広告費のインポートファイルには適していません。

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

1000の区切り記号なしで広告費セルをフォーマットするには ：

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

   

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

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

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

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

エディター画面

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

• 空白スペース：フィールドを区切るコンマの前後に、空白スペースがないことを確認してください。Excelでは、@trimのコマンドを使用して空白スペースを削除してください。
• 日付：日付フィールドの形式がYYYY-MM-DDであることを確認してください。
• 広告費：広告費フィールドにカンマが含まれていないことを確認してください。
  

   

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

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

おそらく、広告費用ファイルが処理されなかったことを意味します。これはさまざまな理由で発生する可能性があります：

コンテンツの種類が正しくありません

AppsFlyerは、 multipart/mixed コンテンツタイプのメッセージのみを処理します。他のタイプが処理されなかったため、ステータスメールが生成されず、返送されません。
通常の場合、添付ファイル付きのメールはメールクライアントによって multipart/mixed に自動的に設定されます。

メールのメッセージのコンテンツの種類 multipart/mixed を、メールヘッダーの content-type 値に表示するには、メールヘッダーの content-type 値を表示します。

• Gmail でメールメッセージのヘッダーを表示するには、 Gmailのドキュメントに従ってください。
• Outlook でメールメッセージヘッダーを表示するには、 Outlookのドキュメントに従ってください。

メールメッセージのHTMLの形式が正しくありません

HTMLエラーにより、メールの正しい処理が妨げられる可能性があります。たとえば、タグが空であるか、欠落しています。スクリプトに HTMLエラーがないか確認してください。

広告主や代理店は、費用データをアップロードして取り込むための CSV ファイルを準備できます。
そのためには、CSVファイルに代理店名を含む [代理店] 列が含まれている必要があります (代理店名は af_prt パラメーターの値です)。
参照：CSVスキーマ

注意事項：

• 1つのファイルに含めることができる代理店は 1社のみです。また、その代理店が管理するキャンペーンのみをファイルに含めることができます。
• 代理店名は行ごとに必須です。代理店列に空白のセルは使用できません。
• 代理店は、ファイルに含まれるすべてのアプリに対する権限を持っている必要があります。
• ファイルをアップロードできるのは広告主のみです。代理店アカウントでは、広告費データのアップロードを行うことはできません。ファイルを準備し、広告主に送信して、広告主アカウントからのみアップロードできます。