概要:AppsFlyer ROI360の一部であるコストETLは、メディアソースごとに利用可能な最高の粒度を持つキャンペーンコストデータを広告主に提供します。毎日4回更新されるデータは、広告主のBIシステムに格納できるようクラウドサービス経由で格納できます。
コストETLについて
AppsFlyer ROI360の一部であるコストETLは、メディアソースごとに利用可能な最高の粒度を持つキャンペーンコストデータを広告主に提供します。毎日最大4回、データが更新され、Data Lockerクラウドサービスに配信され、広告主のBIシステムにロードする準備が整います。
広告主は、一度に複数のクラウド接続先にレポートを簡単に格納できます。例えば、あるクラウドサービスから別のクラウドサービスに移行する際、データが複数のサービスで同時にアクセスできるため、各作業を簡素化・強化できます。
レポートタイプ
AppsFlyerは、異なる分析ニーズをサポートするために2種類のレポートを提供します。
1. コストETLレポート
コストETLレポートには、インストール、リアトリビューションCV、リエンゲージメントCVなどのアトリビューション指標を含む、AppsFlyerアトリビューションに紐付けられたコストデータが含まれています。
- サマリーレポート:(デフォルト)メディアソース別に集計されたハイレベルのコストデータ。コストとパフォーマンス指標を広範囲に分析するために推奨されます。
- 国別レポート:(オプション)国(2文字コード)別に分解されたコストデータ、例えばUS、CA、FRなど。国レベルのパフォーマンスとコスト分析に推奨されます。
- チャネルレポート:(オプション)チャネル(例:YouTube、ショッピング)別にセグメント化されたコストデータ。チャネルレベルのパフォーマンスとコスト分析に最適です。
レポートの設定と構成
- レポートを構成するには、コストETLの設定を参照してください。
- クラウドサービスのレポートパスについては、ディレクトリとファイル名の構造を参照してください。
レポート項目の確認
- サンプルはCSVファイルです。コストETLファイルはパーケットファイルとしてバケットに送られます。
- レポートのディメンションと指標の詳細は、ファイル項目テーブルを参照してください。分析ニーズに最も適したディメンションを使用してください。メディアソースにより異なる場合があります。
2. すべてのコストレポート
すべてのコストレポートは、アドネットワークから直接取得したモバイルおよびウェブのコストデータの包括的なビューを提供し、アトリビューション統合はありません。すべてのコストレポートの受信を開始するには、AppsFlyerの担当者にお問い合わせください。
- アプリIDは、アドネットワークから受信した通りに表示されます。アプリIDが取得できない場合は、unknown として表示されます。
- 現在、Google Ads、Meta Ads、TikTokをサポートしています。
レポートの設定と構成
- レポートを構成するには、コストETLの設定を参照してください。
- クラウドサービスのレポートパスについては、ディレクトリとファイル名の構造を参照してください。
レポート項目の確認
- サンプルはCSVファイルです。コストETLファイルはパーケットファイルとしてバケットに送られます。
- すべてのコストレポートの次元と指標は、コストETLレポートで使用されるのと同じデータスキーマに従います。詳細については、ファイル項目テーブルを参照してください。
注意
すべてのコストレポートでGoogle AdsとMeta Adsの受信を開始するには、AppsFlyerの担当者にお問い合わせください。
レポート詳細
データ更新頻度
キャンペーンのコストデータは次のように書き込まれます:
- コストデータの表示、転送、およびシステムへのロードを行うためバケットへ配信されます。
- コストETLに含めることを選択したすべてのアプリにおいて、1日あたり、1バージョンあたり
- 1日4回まで(データ鮮度:日中)
- 当日と過去6日間(本記事では7日間と表記)のほか、14日目、29日目、88日目も同様に配信できます。データロードプロセスでは、この点を考慮に入れてください。
- 例:2024年10月14日の場合、ファイルには10月14日(当日)、10月13日(1日遡り)、10月12日(2日遡り)、10月11日(3日遡り)、10月10日(4日遡り)、10月9日(5日遡り)、10月8日(6日遡り)、9月30日(14日遡り)、9月15日(29日遡り)、7月18日(88日遡り)のデータが含まれています。
- 過去にさかのぼったデータにより、コストデータレポートの更新や訂正が可能になります。
- アトリビューション、クリック、インプレッションと一致したコスト
注意:- 過去7日分のデータは、メディアソースから新たに取得したものです。14日目、29日目、88日目のデータは再処理しています。
- コストデータのみ遡及して更新され、アトリビューションデータは更新されません。
ディレクトリとファイル名の構造
バケットに書き込まれたデータは、ディレクトリとファイル構造が記述されています。
- コストETLがディレクトリへの書き込みを完了すると、成功ファイルを作成してフラグが設定されます。これが、常にディレクトリ内の最新のタイムスタンプになります。
- フォルダ/ファイル数は、次のとおりです:
- 概要:1日4バージョンまで。
- 各バッチフォルダには、7日間のデータを含むParquetファイルが含まれています。
- 地域(国)またはチャネル別のレポート:各レポートには、1日あたり最大4つのバージョンフォルダが含まれます。
- 各バッチフォルダには、番号付けが1から始まるデータを含むParquetファイルが含まれています。
- [Closed Beta] すべてのコスト:地域(国)ディメンションに基づき、1日4ファイルまで収録。
- 概要:1日4バージョンまで。
Data Locker接続ディレクトリ構造
| 変数 | コンテンツ |
|---|---|
| client-bucket | クラウドサービスで設定されているバケット名 |
| DL-generated-partition | ユニークなパーティションを生成 |
| connection-name | Data Lockerのセットアップ時に定義された接続名 |
| t | 特定のレポートの名前。以下いずれか:
|
| dt |
|
| v |
|
| Parquet file number |
|
コストETL接続ディレクトリ構造
| 変数 | コンテンツ |
|---|---|
| advertiser_bucket_name | コストETL設定で定義された通り: af-xpend-cost-etl-<af-account-id>-[your bucket name suffix] |
| cost_etl | この値は常に「cost_etl」です |
| version | コストETLのバージョン |
| date |
コストの日付 形式: yyyy-mm-dd |
| batch | 数値 1-4 |
| ディメンション | Data dimension:
|
| file_name |
|
| Parquet file number |
|
例:2020年6月23日の最初のデータ抽出では、ディレクトリとファイル名の構造は次のようになります:/bucket-name/cost_etl/v1/dt=2020-06-23/b=1/geo/part-00001
ファイル項目
フィールド / ディメンション
| フィールド | 備考 | 常に記入 | 形式 | サマリーファイルに含まれる |
|---|---|---|---|---|
| ad | 広告階層のコンポーネント | いいえ | 文字列 | - |
| ad_account |
|
いいえ | 文字列 | - |
| ad_id | 広告階層のコンポーネント | いいえ | 文字列 | - |
| adset | 広告階層のコンポーネント | いいえ | 文字列 | - |
| adset_id | 広告階層のコンポーネント | いいえ | 文字列 | - |
| af_bid_strategy | AppsFlyerによってマッピングされ正規化された入札ストラテジー。キャンペーンプロパティのコンポーネント。詳細はこちら | いいえ | 文字列 | - |
| af_cost_model | AppsFlyerによってマッピングされ正規化されたコストモデル。キャンペーンプロパティのコンポーネント。詳細はこちら | いいえ | 文字列 | - |
| agency | 広告を配信する代理店 | いいえ | 文字列 | - |
| app_id | AppsFlyerプラットフォームのアプリID | はい | 文字列 | ✓ |
| bid_amount | キャンペーンプロパティのコンポーネント。詳細はこちら | いいえ | 整数 | - |
| bid_strategy | キャンペーンプロパティのコンポーネント。詳細はこちら | いいえ | 文字列 | - |
| campaign | 広告階層のコンポーネント | いいえ | 文字列 | - |
| campaign_id | 広告階層のコンポーネント | いいえ | 文字列 | - |
| campaign_objective | キャンペーンプロパティのコンポーネント。詳細はこちら | いいえ | 文字列 | - |
| channel | 広告階層のディメンション | いいえ | 文字列 | - |
| cost_model | キャンペーンプロパティのコンポーネント。詳細はこちら | いいえ | 文字列 | - |
| currency | AppsFlyer管理画面のアプリ設定画面で設定された通貨 | はい | ISO-4217 に準拠した3文字の文字列 | ✓ |
| date | メディアソースによってレポートされたコストの日付 | はい | String yyyy-mm-dd | ✓ |
| geo(国) | 広告階層のディメンション | いいえ | ISO 3166に準拠した2文字の文字列 | ✓ |
| keyword_id | ASAキーワード用語のID | はい | 文字列 | - |
| keyword_term | ユーザーがオンライン検索に使用する単語 | はい | 文字列 | - |
| media_source | 広告が表示すれたメディアソース | はい | 文字列 | ✓ |
| original_bid_amount | キャンペーンプロパティのコンポーネント。詳細はこちら | いいえ | 整数 | - |
| original_currency | コンバージョン前にネットワークから報告されたコストの通貨 | はい | ISO-4217 に準拠した3文字の文字列 | - |
| os | 端末のOS / 想定値:
|
はい | 文字列 | - |
| platform | キャンペーンを実行するために使用されるプラットフォーム(モバイル、タブレット、デスクトップ、CTV) | すべてのコストレポートのみ | 文字列 | - |
| site_id | パブリッシャーID | いいえ | 文字列 | - |
| timezone |
|
はい | 文字列 | - |
指標
| フィールド | 備考 | 常に記入 | 形式 | サマリーファイルに含まれる |
|---|---|---|---|---|
| ccvr |
|
整数 | - | |
| clicks |
|
整数 | ✓ | |
| clicks_discrepancy |
|
整数 | - | |
| cost | 支出額(設定されている場合は代理店手数料を含むグロスコスト) | 値(Value) | ✓ | |
| cost_without_fees | 代理店手数料を差し引いた金額。AppsFlyerにより計測 | はい | 整数 | - |
| cpi |
|
整数 | - | |
| ctr |
|
いいえ | 整数 | - |
| cvr |
|
整数 | - | |
| cvvr |
|
整数 | - | |
| ecpc |
|
整数 | - | |
| ecpm |
|
整数 | - | |
| fees | 通常の広告コストに加えて代理店が請求する手数料。AppsFlyerにより計測 | はい | 整数 | - |
| Impressions |
|
はい。 特定の指標で使用可能な値がない場合は、0が入力されます。 |
整数 | ✓ |
| impressions_discrepancy |
|
整数 | - | |
| installs | AppsFlyerにより計測 | 整数 | ✓ | |
| installs_discrepancy |
|
整数 | - | |
| original_cost | アドネットワークによってレポートされたコスト - 通貨換算前のネットワークによってレポートされた通貨(関連する場合はAppsFlyerによって計算された代理店手数料が追加されます) | 値(Value) | - | |
| original_cost_without_fees | アドネットワークからレポートされた、広告代理店手数料を含まないオリジナルコスト | はい | 整数 | - |
| re_attributions | AppsFlyerにより計測 | 整数 | ✓ | |
| re_engagements | AppsFlyerにより計測 | 整数 | ✓ | |
| reported_clicks | メディアソースにより計測 | 整数 | ✓ | |
| reported_conversions | メディアソースにより計測 | 整数 | ||
| reported_cvr |
|
整数 | - | |
| reported_impressions | メディアソースにより計測 | 整数 | ✓ | |
| video_25p_views | 動画25%再生。アドネットワークによりレポートされます。 | 整数 | - | |
| video_50p_views | 動画50%再生。アドネットワークによりレポートされます。 | 整数 | - | |
| video_75p_views | 動画75%再生。アドネットワークによりレポートされます。 | 整数 | - | |
| video_completions | アドネットワークによりレポートされます。 | 整数 | - |
手順
コストETLの設定
この設定手順は、アドミン(管理者)ユーザが行う必要があります。
はじめる前に
ETLセットアップの前提条件:
- AppsFlyerがデータの書き込みを許可するように設定されたクラウドサービス。つまり、以下のクラウドサービスのいずれか1つ以上をセットアップする必要があります:
- コストETLの設定を完了するには、 AppsFlyerの管理者権限とAppsFlyer管理画面へのアクセス権限が付与されている必要があります。
- AppsFlyer管理画面 左メニュー エクスポート > コストETLへ移動します。
-
データ接続を選択または設定します:
- すでにデータ接続が設定されている場合は、接続ドロップダウンでコストETLに必要な接続を選択します。
- まだデータ接続をお持ちでない場合は、Data Lockerの +新規接続をクリックし、そこで接続を作成してください:
- 接続に名前を付けます。
-
クラウドサービスのデータ保存先の選択してください。次のいずれかを実行してください:
-
S3を選択します。
- AWS S3バケット名を入力します。プレフィックス
af-は必須であり、手動で入力する必要があります。 - 接続テストをするをクリックしてください。
- バケットパスが無効であることを示すエラーメッセージなどが表示されないことを確認します。
- この接続をAdobe Experience Platformと互換性を持たせるかどうかを選択します。
- 保存をクリックしてください。
- コストETLセットアップで、接続ドロップダウンで、作成したクラウドサービスを選択します。
- AWS S3バケット名を入力します。プレフィックス
-
GCSを選択します。
- GCSバケット名を入力します。
- 接続テストをするをクリックしてください。
- バケットパスが無効であることを示すエラーメッセージなどが表示されないことを確認します。
- この接続をAdobe Experience Platformと互換性を持たせるかどうかを選択します。
- 保存をクリックしてください。
- コストETLセットアップで、接続ドロップダウンで、作成したクラウドサービスを選択します。
- ベータ版Azureを選択します。
- 接続名、ストレージアカウント名、キーを入力します。
- バケットパスが無効であることを示すエラーメッセージなどが表示されないことを確認します。
- この接続をAdobe Experience Platformと互換性を持たせるかどうかを選択します。
- 保存をクリックしてください。
- コストETLセットアップで、接続ドロップダウンで、作成したクラウドサービスを選択します。
- [Beta] Yandexを選択します。
- バケット名、アクセスキー、シークレットキーを入力します。
- バケットパスが無効であることを示すエラーメッセージなどが表示されないことを確認します。
- この接続をAdobe Experience Platformと互換性を持たせるかどうかを選択します。
- 保存をクリックしてください。
- コストETLセットアップで、接続ドロップダウンで、作成したクラウドサービスを選択します。
-
BigQueryを選択します。
- BigQueryプロジェクトIDとデータセット名を入力します。
- 接続テストをするをクリックしてください。
- バケットパスが無効であることを示すエラーメッセージなどが表示されないことを確認します。
- 保存をクリックしてください。
- コストETLセットアップで、接続ドロップダウンで、作成したクラウドサービスを選択します。
-
Snowflakeを選択してください。
- Snowflake地域とアカウントIDを入力します。
- 接続テストをするをクリックしてください。
- バケットパスが無効であることを示すエラーメッセージなどが表示されないことを確認します。
- 保存をクリックしてください。
- コストETLセットアップで、接続ドロップダウンで、作成したクラウドサービスを選択します。
-
S3を選択します。
- 接続に名前を付けます。
- すでにデータ接続が設定されている場合は、接続ドロップダウンでコストETLに必要な接続を選択します。
-
次へをクリックしてください。
- レポートのバージョンスケジュール(UTC)を設定:
- 毎日受信するレポートの数(1、2、3、4)を選択します。
- レポートを受け取る時間を選択します。詳細はこちら
- 次へをクリックしてください。
- レポートの詳細を設定する:
- ピボットに含めるアプリを1つ以上選択します。今後追加されるすべてのアプリを選択すると、自動的に今後追加するアプリも含まれるようになります。
- 分析ニーズに最も適したレポートを選択してください。レポートタイプセクションの説明を参照してください。
- レポートに含めるディメンションを選択します。注意:Geoレポートの受信を選択した場合、デフォルトでGeoディメンションが含まれます。チャネルレポートの受信を選択した場合、デフォルトでチャネルディメンジョンが含まれます。
- レポートに含める指標を選択します。
- ピボットに含めるアプリを1つ以上選択します。今後追加されるすべてのアプリを選択すると、自動的に今後追加するアプリも含まれるようになります。
- 適用をクリックします。
接続の編集または変更
接続を編集または変更することで、データを別の(または追加の)場所に送ることができます。
注意:既存の接続に切り替えた後、以前のコストETL接続に戻すことはできません。
接続の編集
接続の詳細を編集する:
- AppsFlyer管理画面 左メニュー エクスポート > コストETLへ移動します。
- データ接続セクションで:
- 画面の指示に従って、接続の詳細を編集します。
- プロンプトが表示されたら、変更を保存 または 適用をクリックします。
Data Lockerの接続を変更する
Data Lockerの接続を別の接続に変更する:
- AppsFlyer管理画面 左メニュー エクスポート > コストETLへ移動します。
- データ接続セクションで:
- 変更を保存をクリックします。
コストETLからData Locker接続への変更
はじめに:
-
Data Locker接続に切り替え後は、以前のコストETL接続に戻すことはできません。
-
Data Locker接続に切り替えると、フォルダーパス構造が次の形式に変更され、レポートデータには影響しません:
/ / /t= /dt= /v=<1/2/3/4>/
非推奨のコストETL接続からData Locker接続に変更するには:
AWSオブジェクトの所有権
AWSでは、デフォルトで、AppsFlyerがオブジェクトをバケットに書き込む場合、そのオブジェクトのオーナーはAppsFlyerです。データ取り込みプロセスによっては、デフォルトの所有権をあなた(バケット所有者)に変更する必要がある場合があります。
自社バケットのオブジェクトの所有権を変更する方法:
ベストプラクティス
レポート購読
レポートのスケジュール設定により、必要な時に新鮮なデータを入手することができます。
レポートのスケジュールを選ぶ際には -
- BIシステムでデータ処理を開始する時刻にできるだけ近いレポートを取得する時刻を選択します。
- 前日のデータを他より遅れて提供するアドネットワークがある場合は、そのアドネットワークのデータが準備できた時点で追加レポートを設定します。
データの上書き
データを取得し分析する際は、特定の日付とバッチのデータを取得するか、全ての過去のデータを現在のバッチのデータで上書きすることをお勧めします。そうしないと、同じデータが繰り返し表示される可能性があります。
例:2月20日のバッチ1には2月14-20日のデータが含まれています。しかし、2月19日に書かれたバッチにも、2月14日~2月19日のデータが含まれています。2月19日に受信した以前のデータを、直近の2月20日のバッチで受信したデータで上書きします。
地域 vs. チャネル
全てのネットワークが全てのディメンションのデータを一緒に提供しているわけではありません。Meta Adsの地域データやチャネルデータは、その代表的な例です。2つの別々のデータセットが提供されるのは、このためです。地域データセットには地域データが、チャネルデータセットにはチャネルデータが含まれることが保証されています。
多くの場合、大部分のメディアソースでは、地域とチャネルデータは同じになります。そのため、ビジネスニーズに応じて、いずれかのデータセット(地域またはチャネル)を取り込んでください。
メディアソースとの連携に関する契約にチャネルが含まれておらず、チャネルが空白の場合、そのデータにチャネルが含まれているものとして扱います。
集計データ
コストETLは、アドネットワークから抽出できる最も粒度の細かい、柔軟なデータを提供します。このような膨大な量のデータから実用的なインサイトを引き出すには、ビジネスニーズに最適な方法でデータを集約することをお勧めします。例えば、キャンペーンおよび国レベルでコストデータを理解する必要がある場合は、これらのディメンションを使用してください。
ネットワーク全体の標準化
すべてのネットワークが同じ粒度のデータを提供するわけではありません。例:Meta AdsはサイトIDレベルのコストデータを提供しません。コストETLデータを集計する場合は、このようなケースに注意し、ネットワークを比較する時に同様のデータを確認します。
データの比較
コストETLは、お客様のすべてのコストデータに関する情報を提供します。コストETLで提供された一部のキャンペーンは、一部の AppsFlyer 管理画面に表示されません。例えば、非アクティブなキャンペーンのデータ、つまり、 インストールが記録されていないキャンペーン です。データを比較するためには、オーバービュー管理画面で特定のキャンペーンIDを見つけ、コストETLでのコストデータと比較してください。コストデータの入手方法について詳しくはこちら
コストETLとコホートレポートを組み合わせる
BIシステムにおいて、コストETLレポートと集計された高度なコホートレポート(またはData Locker経由の通常のコホートレポート)を組み合わせることを検討します。クリック数、インプレッション数、コスト、収益、アプリ内イベントなど、新鮮で正確なデータにより、マーケティングパフォーマンスの全体像を把握することができます。)そして、この組み合わせたデータを使って、ROASやCPAなどを求めることができます。詳細はこちら
追加情報
特性と制限
| 特性 | 備考 |
|---|---|
| タイムゾーン | タイムゾーンが変更された場合、コストデータは変更された日と翌日に複製されます。詳細はこちら |
| データ更新頻度 |
|
| すべてのコストレポート |
|
| 包括的なキャンペーンのコストデータ |
|