コストインポート

プレミアム機能

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

仕様

コストインポート:

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

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

注:

  • アドネットワークは、関連する権限が提供されている場合、顧客のコストファイルをインポートできます。
  • 代理店はファイルを準備できますが、広告主はファイルをアップロードする必要があります。

手順

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

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

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

コストデータを含むCSVファイルの準備

広告主、アドネットワーク、代理店は、コストインポートCSVファイルを準備できます。参照:サンプルファイル

CSVファイルを準備するには

  • 次の表で詳しく説明されているファイルスキーマ、形式、およびルールに従います。
    - 注:Excel または Google スプレッドシートを使用してファイルを作成する場合は、 ExcelとGoogle スプレッドシートの書式設定手順に従ってください。

CSVスキーマ

カラム名 

(大文字と小文字を区別してください)

フォーマット/備考

必須

date

  • コストが発生した日付
  • 形式:文字列
    (ベストプラクティス):
    • YYYY-MM-DD
    • YYYY-MM-DD 
    • MM/DD/YYYY
    • MM/DD/YYYY 
  • 将来の日付は不可です。
  • ベストプラクティス :AppsFlyerでアプリに定義されているタイムゾーンと同じタイムゾーンを使用してください。
  • - 注:ファイルの準備にExcel / Googleスプレッドシートを使用していますか?こちらを確認してください。 
  • 2019-05-30
  • 2019/05/30
  • 5-30-2019
  • 5/30/2019
  • 5/30/2019
  • 05/30/2019

 

app-id

  • 形式:文字列
  • AppsFlyerに表示されるアプリID
  • 1つのファイルで複数のアプリIDを使用できます。
  • すべてのアプリIDは、同じ広告主アカウントに属している必要があります。
  • com.app.name 
  • id12356789

media-source

    • 形式:文字列
    • メディアソース名(AppsFlyerに表示されている通りに) - 注意:必要に応じて、末尾に _int サフィックスを含めます。
    • 1ファイルにつき、つのメディアソースデータのみインポート可能です。/span>同じメディアソースでの複数アプリのデータは可能

network_x_int

campaign

  • 形式:文字列
  • campaign_nameアドネットワークにキャンペーン名が表示される場合は、このファイル内の名前と一致する必要があります(大文字と小文字が区別されます)。
  • 複数のアプリで同じキャンペーン名を使用しないでください。

campaign_a

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

広告費

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

2874.12345

 

 

geo

  • 形式:文字列
  • ISO 3166に準拠した2文字の国コード - 注:空白にせず、必ず2文字を送信してください。
  • 英国の場合はUKを使用します。 GBではありません。

US, CN, AU

 

いいえ

通貨

  • 形式:文字列
  • ISO 4217に準拠した3文字の通貨コード。  - 注:先頭や末尾に空白がない3文字を送信するようにしてください。
  • ファイル内のアプリごとに1つの通貨コードを使用できます。アプリごとに、異なる通貨コードを設定できます。

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

  • 形式:文字列 
  • 広告を表示しているパブリッシャーを識別する一意のID。 詳細はこちら
id1213mno いいえ

チャネル

形式:文字列   動画 いいえ

キーワード

形式:文字列

  • better
  • better you app
  • better you online
いいえ

代理店

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

注意:英語以外の文字を含む名前は、UTF-8 を使用してエンコードする必要があります。

CSV形式とルール

ルール 要件

禁止文字

文字列形式の項目の最初の文字として、 = , + , - , また @を含めることはできません。たとえば、 @example_campign=123 は禁止されています。

アプリ所有者  

1ファイルごとに1つのアプリ所有者のデータ。同一アカウント内の複数のアプリのデータ送付も可能です。 

ファイル名の拡張子

CSV例: abc123.csv

ファイル構造

  • 形式:ファイルはCSV形式であり、各列はコンマで区切られます。
  • ヘッダー行:最初の行は、スキーマに一致するヘッダー行です。
  • データ行: 必須の列が含まれます。  - 注:データに、末尾の空白がないことを確認してください。例えば、[USD]( D の後に空白がある)は、[USD]に変更する必要があります。
  • 空白行:許可されていません。
  • 同じキーを持つ重複する行:許可されていません。キーは必須フィールドのものを使用してください。
  • 空白セル:ファイル内で空の値は許可されません。特定の項目をアップロードしない(必要ない)場合には、ファイルに含めないでください。

広告パラメータの階層 

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

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

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

ファイルをアップロード

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

前提条件:アドネットワークは、広告主からのコストインポート許可権限を得ている必要があります。

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

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

メールファイル

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

前提条件

  • 広告主
    • 送信者のメールアドレスは、AppsFlyerの登録ユーザー宛てである必要があります。
  • アドネットワーク:

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

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

管理画面

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

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

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

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

カラム名 説明
CSVファイル名 AppsFlyerにインポートされたコストファイルの名前
データのアップロード ファイルがインポートされた日付
メディアソース ファイルに含まれるメディアソース
期間 広告費が発生したファイル内の最初と最後の日付
一致した行 (%)

コストがアトリビューションと一致したファイル内の行の割合(詳細はこちら)

ステータス

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

  • 適用済:アクションは正常に完了しています。 コストは記録され、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 ファイルを保存した後、コンテンツが正しくフォーマットされていることを確認します。次のガイドラインを使用して、次のことを行います:

  • 日付セルを書式設定します。
  • スペンド(広告費)セルを書式化します。
  • コンテンツの形式を確認します。

日付セルの書式

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

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

広告費トークンは、メール送信者が広告費ファイルの送信を承認されていることを確認するために使用されます。

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

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

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

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

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

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

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

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

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

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

エラーメッセージ 説明 解決策
ファイルに指定されたアプリIDはAppsFlyerに存在しません。正しいアプリIDが指定されているか確認してください。 アカウントにアプリIDが存在しません。 アプリIDを変更して再提出してください。

行 [行名] の列数が間違っています。期待される列数:[数値] 列、受信した列数:[数値] 列。

ファイル内のすべての列に値が必要です。 定義したヘッダーに基づいてファイル内の値を変更してください。
ファイルのヘッダーに 'media-source' がありません。
  • ファイルのヘッダーに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時間待ってから、もう一度アップロードしてください。

特性と制限

特性 備考 
アドネットワーク サポートされています
代理店
  • 代理店アカウントでは、広告費データのアップロードを行うことはできません。ファイルを準備し、広告主に送信して、広告主アカウントからのみアップロードできます。
  • そのためには、CSVファイルに代理店名を含む代理店項目が含まれている必要があります(代理店名は af_prt パラメータの値です)。参照:CSVスキーマ
代理店の運用媒体の開示設定 サポートされておらず、計測対象外です
アプリ固有のタイムゾーン サポートされています
App-specific currency  サポート対象です。キャンペーンコストはアプリ毎に設定された通貨単位に換算されます。
キャンペーン名 複数のアプリに対して、同じキャンペーン名を使用することはできません。 使用した場合には1 つのアプリのコストが両方に適用されます。
項目名

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

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

ファイルサイズ

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

  • AppsFlyer管理画面からアップロード:2 MB
  • メール経由:5 MB
オーガニックデータ サポートされています
非オーガニックデータ サポートされています
データ更新頻度 Ad spend(広告費)
過去データ

サポート対象です。レポートされたコストは、最大90日間送信したデータを元に戻して修正できます。

リターゲティング いいえ:
アカウントユーザーのアクセス 地域やメディアソースの制限があるユーザーは利用できません。