どのようにお手伝いできますか?

コストデータのインポート プレミアム機能

  • 更新

概要:AppsFlyer ROI360の一部であるコストインポート機能を使用し、アップロードまたはメールでCSVファイルをインポートすることで、マーケティングコストを完全かつ正確に把握できます。

Overview

コストインポート:

  • あらゆるマーケティング活動(モバイルキャンペーン、インフルエンサーキャンペーン、CTVなど)のキャンペーンコストをAppsFlyerで取得します。これは、APIや計測リンクでコストをレポートしないメディアソースにとって特に重要です。
  • 既存のコストデータをさかのぼって上書きし、修正します。

コストは、AppsFlyerにアップロードまたはメールで送信されるCSVファイルでレポートされます。 AppsFlyerがファイルを受信すると、データは処理され、数時間以内にダッシュボードとレポートで利用できるようになります。これにより、キャンペーンのコストとROIの全体像を把握できます。

メディアソース名(AppsFlyerに表示されている通り)- 注意:必要に応じて、末尾に _int サフィックスを含めます。

  • アドネットワークは、関連する権限が提供されている場合、顧客のコストファイルをインポートできます。
  • 代理店アカウントでは、広告費データのアップロードを行うことはできません。ファイルを準備し、広告主に送信して、広告主アカウントからのみアップロードできます。

手順

コストインポートを使用してAppsFlyerにコストデータを送信するには、次のことを行う必要があります:

  1. 送信するコストデータのCSVファイルを準備します。
  2. 次のいずれかの方法でAppsFlyerにファイルを送信します:

詳細な手順については、以下のセクションを参照してください。

コストデータを含む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
  • コストが発生した日付
  • 形式:文字列
    (ベストプラクティス):
    • YYYY-MM-DD
    • MM/DD/YYYY 
    • MM/DD/YYYY
    • ISO 3166に準拠した2文字の国コード注:空白にせず、必ず2文字を送信してください。
       
  • 将来の日付は不可です。
  • ベストプラクティス :アプリ設定画面で設定されているタイムゾーンと同じタイムゾーンを使用してください。
  • 注:ファイルの準備にExcel / Googleスプレッドシートを使用していますか?こちらを確認してください。 
  • 2019-05-30
  • 2019/05/30
  • 5-30-2019
  • 5/30/2019
  • 05-30-2019
  • 05/30/2019

 

✓
app-id
  • 形式:文字列
  • AppsFlyerに表示されているアプリID
  • 1つのファイルで複数のアプリIDを使用できます。
  • すべてのアプリIDは、同じ広告主アカウントに属している必要があります。
  • com.app.name 
  • id12356789
✓
media-source
  • 形式:文字列
  • Media source name exactly as it appears in AppsFlyer. Note: Include the _int suffix if relevant.
  • 1ファイルにつき、つのメディアソースデータのみインポート可能です。同じメディアソースでの複数アプリのデータは可能です。
network_x_int ✓
campaign
  • 形式:文字列
  • Campaign name. campaign_nameアドネットワークにキャンペーン名が表示される場合は、このファイル内の名前と一致する必要があります(大文字と小文字が区別されます)。
  • 複数のアプリで同じキャンペーン名を使用しないでください。
campaign_a

✓

注:アトリビューションデータに名前とIDの存在する場合は、CSVには両方を含める必要があります。

spend
  • コスト
  • 小数点以下5桁まで入力可能です。
  • 0 (ゼロ)の値も入力可能です。
  • 注意: 
    • 1000個のコンマ区切り文字は使用できません。 例:"2,874.12".
    • ファイルの準備にExcel / Googleスプレッドシートを使用していますか?こちらを確認してください。

2874.12345

 

 

✓
reported-clicks
  • 注:
  • The number of clicks reported by the ad network.
  • Whole numbers only. No decimals, comma separators, currency symbols, or scientific notation.
  • The value must be 0 or greater. The value 0 is permitted.
1200 任意
reported-impressions
  • スペンド(広告費)セルを書式化します。
  • The number of impressions reported by the ad network.
  • Whole numbers only. No decimals, comma separators, currency symbols, or scientific notation.
  • The value must be 0 or greater. The value 0 is permitted.
45000 いいえ:
geo
  • 形式:文字列
  • ISO 4217に準拠した3文字の通貨コード。注:先頭や末尾に空白がない3文字を送信するようにしてください。
  • 英国の場合はUKを使用します。  GBではありません。
     

US, CN, AU

 

地域が存在しません。
currency
  • 形式:文字列
  • Three-letter currency code compliant with ISO 4217. Note: Make sure that you send three characters with no leading or trailing blanks.
  • ファイル内のアプリごとに1つの通貨コードを使用できます。アプリごとに、異なる通貨コードを設定できます。 
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
  • 形式:文字列 
  • 広告が表示されているパブリッシャーを識別する一意のID。  詳細はこちら
id1213mno 任意
channel 形式:文字列   video 任意
keywords 形式:文字列
  • better
  • better you app
  • better you online
任意
agency

 

  • 形式:文字列
  • The agency name. The value in the af_prt parameter.
  • 1つのファイルに含めることができる代理店は 1社のみです。 また、その代理店が管理するキャンペーンのみをファイルに含めることができます。
  • 代理店名は行ごとに必須です。代理店列に空白のセルは使用できません。
  • 代理店は、ファイルに含まれるすべてのアプリに対する権限を持っている必要があります。
  • ファイルをアップロードできるのは広告主のみです。代理店アカウントでは、広告費データのアップロードを行うことはできません。ファイルを準備し、広告主に送信して、広告主アカウントからのみアップロードできます。
  • If cost data is re-sent for the same dates and the agency name (af_prt) is included in a subsequent submission when it was absent in the original, this results in duplicated cost data.
AgencyName 任意
注意:英語以外の文字を含む名前は、UTF-8 を使用してエンコードする必要があります。

CSV形式とルール

ルール 要件
禁止文字 文字列形式の項目の最初の文字として、 = , + , - , また @ を含めることはできません。たとえば、 @example_campign や =123 は禁止されています。
アプリ所有者  1ファイルごとに1つのアプリ所有者のデータ。同一アカウント内の複数のアプリのデータ送付も可能です。 
ファイル名の拡張子 CSV例: abc123.csv
ファイル構造
  • 形式:ファイルはCSV形式で、各列をコンマで区切ります。
  • ヘッダー行:最初の行は、スキーマに一致するヘッダー行です。
  • データ行: 必須の列が含まれます。 注:データに、末尾の空白がないことを確認してください。例えば、[USD ](Dの後に空白がある)は、[USD]に変更する必要があります。
  • 空白行:許可されていません。
  • 同じキーを持つ重複する行:許可されていません。キーは必須フィールドのものを使用してください。
  • 空白セル:ファイル内で空の値は許可されません。特定の項目をアップロードしない(必要ない)場合には、ファイルに含めないでください。
広告パラメータの階層 

コストはキャンペーンレベルで記録する必要があり、広告階層の他のディメンションはあくまでオプションです。

下位階層でアップロードされる部分的なデータは、キャンペーンレベル以降のデータをすべて上書きします。

例:広告セット1のキャンペーンコストを含むファイルをインポートし、同じキャンペーンの広告セット2の別のファイルを別々にインポートすると、キャンペーンの合計費用が置き換えられ、広告セット2のデータのみが表示されます。インポートするファイルにadset1とadset2のデータを含める必要があります。 

ファイルのアップロード

広告主とアドネットワークが、コストインポートCSVファイルをアップロードできます。

添付ファイル:CSVファイルとデータ。 

AppsFlyer管理画面からCSVファイルをアップロードする方法:

  1. AppsFlyer管理画面 左メニュー 設定 > コストインポートを選択します。
    コストインポート画面が表示されます。 
  2. クリック + コストファイルのインポート
    インポートコスト画面が開きます。
     
  3. CSVファイルをコストファイルのインポート画面にドラッグします。
    ファイルを処理しているメッセージが表示されます。
  4. アップロード中にエラーメッセージが表示された場合:エラーを修正して、関連する手順を繰り返してください。 
  5. コストインポート:ファイルの概要ウィンドウが開きます。
  6. 次のいずれかを実行してください:
    • アップロードを中止し、インポートのキャンセルをクリックします。 
    • インポートプロセスを完了し、ファイルのインポートをクリックします。
      All set! というメッセージが表示されます。
    • If an error message displays, follow the error message instructions.
  7. 別のファイルをインポートまたは完了をクリックします。 

メールファイル

広告主とアドネットワークは、コストインポートCSVファイルをメールで送信できます。

前提条件:

  • 広告主: 
    • 送信者のメールアドレスは、AppsFlyerアカウントを所持しているユーザーである必要があります。
  • アドネットワーク:
    • Sender email must be for a registered AppsFlyer user.
    • 件名:メールのインポート用のトークンを件名フィールドに貼り付けます。 

CSVファイルをメールで送信する:

  1. メールインポート用のトークンを取得します。
    1. AppsFlyer管理画面 左メニュー 設定 > コストインポートへ進みます。 
    2. ページの右上にある メールインポート用のトークンをクリックします。
    3. トークンをコピーして保存します。
  2. 次のフィールドを使用してEメールを作成します: 
    • 宛先:adspend-upload@appsflyer.com
    • CC:自動返信によるコピーを取得する必要があるユーザーのメールアドレスを入力してください。
    • 送信者のメールアドレスは、AppsFlyerアカウントを所持しているユーザーである必要があります。 
    • 前提条件:アドネットワークは、広告主からのコストインポート許可権限を得ている必要があります。
  3. メールを送信してください。
    • ファイルが受信されて処理されると、処理中に見つかった詳細、問題、またはエラーをまとめたステータスメールが送信されます。メールは、送信メールに含まれていた宛先と広告主のアドミンアカウントへ送信されます。エラーが特定された場合は、 エラーメッセージの指示に従ってください。
    • 送信されたファイルのステータスは、コストインポート画面で確認できます。

Dashboard

コストインポート画面では、ファイルをアップロードしたり、以前にアップロードしたファイルの詳細を表示したりできます。

コストインポートダッシュボード

コストインポートダッシュボードを表示するには、AppsFlyerのサイドメニューから、 設定 > コストインポートへ移動します。

以前にインポートしたファイルで使用可能な情報の詳細については、次の表で説明します。

カラム名 説明
CSVファイル名 AppsFlyerにインポートされたコストファイルの名前
アップロード日 ファイルがインポートされた日付
メディアソース ファイルに含まれるメディアソース
データ期間 広告費が発生したファイル内の最初と最後の日付
一致した行 (%) The percentage of rows in the file where cost was matched to attribution. コストがアトリビューションと一致したファイル内の行の割合(Learn more) 
ステータス

インポートされたファイルのステータス:

  • 成功:アクションは正常に完了しています。コストは記録され、AppsFlyerの管理画面とレポートで確認できます。
  • 認証エラー:AppsFlyerのシステム側で不具合が発生しています。 10分後にもう一度やり直してください。再度失敗する場合は、AppsFlyerサポートへお問合せください。
  • 権限なし:トークンがこのアプリでは承認されていません。
    • 広告主:アプリIDが正しいことを確認してください。
    • アドネットワーク:広告主から、コストインポートの許可を付与されていることを確認してください。
  • 上書き済み:アクションは正常に完了しています。ファイルが上書き、もしくは他のデータに置き換えられました。
アクション
  • ファイルレベル:ファイルに含まれるすべてのアプリに対するアプリのアクセス許可がある場合は、次のことができます:
    • CSVファイルのダウンロード:これは、インポートされた CSVファイルのコピーです。
    • 不一致レポートのダウンロード:ファイル内のすべてのアプリに関するデータです。詳細については、この表の「一致した行」セクションを参照してください。
  • アプリレベル:特定のファイルをクリックすると、その特定のファイルからのアプリのすべてのコストインポートに関する情報と、他のファイルが表示されます。アプリに対するアクセス許可がある場合は、次のことができます:
    • アプリのデータをダウンロード
    • アプリ毎の不一致レポートをダウンロード
    • 選択したアプリのコストインポートを元に戻す(キャンセル)

一致した行数

行マッチングとは、インポートによってレポートされたコストが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の形式でフォーマットするには :

  1. フォーマットするセルを選択してください。
  2. 右クリックして、 セルの書式設定を選択します。
    セルの書式設定の画面が開きます。
    Formatdate..png
  3. カスタムを選択してください。
  4. タイプフィールドに、 YYYY-MM-DDと入力してください。
  5. OKをクリックしてください。
    日付がフォーマットされます。

コストセルの書式設定

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

mceclip1.png

1000 コンマ区切り文字なしでセルを書式設定するには: 

  1. フォーマットするセルを選択してください。
  2. 右クリックして、 セルの書式設定を選択します。
    セルの書式設定の画面が開きます。
  3. 数値を選択してください。
    Formatnumbers.png
  4. 1000の区切り記号を使用 (,) をオフにしてください。
  5. (任意) 小数点以下の桁数を設定してください。デフォルト値は 2です。最大許容値は 5です。
  6. OKをクリックしてください。
    セルは正しくフォーマットされています。

コンテンツ形式を確認する

コンテンツの形式を確認するには:

  1. エディタを使用してファイルを表示します。
    • Windows:メモ帳、メモ帳++
    • MacOS:TextEdit
  2. 特に、次の点に注意してください。
    • 空白:項目を区切るコンマの前後に、空白スペースがないことを確認してください。 Excelでは、@trimのコマンドを使用して空白スペースを削除してください。
    • 日付:日付セルの形式が YYYY-MM-DD であることを確認します。
    • 広告費:コストセルにカンマがないことを確認します。
    • 区切り記号:コンマにする必要があります。セミコロンの場合:
      • これは、コンピューターの地域設定が英語以外の言語 / 地域 (特にドイツ語) に設定されている場合に発生する可能性があります。
      • 解決策は、お使いのコンピューターのオペレーティングシステム(macOSまたはWindows)によって異なります。
      • この問題を解決するには、 Microsoftまたはその他のフォーラムからの最新のガイダンスを検索してください。次の検索ワードを使用します:オペレーティングシステム (macOS または Windows) CSVファイルの Excel 変更区切り文字。

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

mceclip1.png

メールインポートのトークン

The token for email import is used to verify that the email sender is authorized to submit the Cost Import file.

広告主とアドネットワークのトークンは異なります。

  • 広告主のトークン:
    • 同じトークンがアカウント内のすべてのアプリに有効です。
    • トークンは、どのアカウントユーザーでも取得できます。
  • アドネットワークの広告費トークン :
    • 同じトークンがすべての広告主に対して使用されます。

広告主と広告アドネットワークは、トークンを互いに共有すべきではありません。

アドネットワークのコストインポート権限

アドネットワークは、コストインポートにアクセスするために、アプリごとに広告主の許可が必要です。

アドネットワークにコストインポート権限を付与するには:

  1. AppsFlyerでは、 広告主 はAppsFlyer管理画面 左メニュー 連携 > 連携済みパートナー を選択する必要があります。 
    The Integrated Partner page displays.
  2. Select the integrated partner.
  3. 権限タブへ進んでください。
  4. もしまだであれば、 アドネットワーク(パートナー)権限 を有効にしてください。
  5. (オプション) アカウントユーザーを追加します。
  6. コストインポートを使用を有効に設定します。
  7. 最後に、権限を保存をクリックしてください。

トラブルシューティング、特性、制限事項

エラーメッセージと解決策

次の表に、考えられるすべてのコストインポートエラーメッセージと対応する解決策を示します。 

エラーメッセージ 説明 解決策
ファイルに指定されたアプリIDはAppsFlyerに存在しません。正しいアプリIDが指定されているか確認してください。 アカウントにアプリIDが存在しません。 アプリIDを変更して再提出してください。
行 [行名] の列数が間違っています。期待される列数:[数値] 列、受信した列数:[数値] 列。 ファイル内のすべての列に値が必要です。 定義したヘッダーに基づいてファイル内の値を変更してください。
ファイルのヘッダーに 'media-source' がありません。
  • ファイルのヘッダーに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 備考 
アドネットワーク

サポート対象

例外:

  • Meta広告
  • X Ads
  • ASA
代理店
  • 代理店アカウントでは、広告費データのアップロードを行うことはできません。準備したファイルは、広告主に共有し、広告主アカウントからのみアップロードできます。
  • そのためには、CSVファイルに代理店名を含む代理店項目が含まれている必要があります(代理店名は af_prt パラメータの値です)。参照:CSVスキーマ
Agency transparency Not supported
アプリ固有のタイムゾーン サポート対象
App-specific currency  Supported. Campaign costs are converted to the app-specific currency.
キャンペーン名 サポート対象キャンペーンコストはアプリ毎に設定された通貨単位に換算されます。
項目名

キャンペーン階層のフィールド名が計測データに表示されているフィールド名と一致しない場合、それらは個別にカウントされます。 

たとえば、キャンペーン名が一致していない場合、キャンペーンIDが同じであっても異なるキャンペーンとしてカウントされます。

ファイルサイズ

CSVコストインポートファイルのサイズ制限:

  • AppsFlyer管理画面からアップロード:2 MB
  • メール経由:1ファイルあたり5 MB
オーガニックデータ サポート対象
非オーガニックデータ サポート対象
Data freshness 広告費
過去データ Supported. サポート対象レポートされたコストは、最大90日間送信したデータを元に戻して修正できます。
リターゲティング Not supported.
アカウントユーザーのアクセス 地域やメディアソースの制限があるユーザーは利用できません。