収益ETL
ROI360の収益ETLは、収益データをBIシステムに取り込めるよう、Data Locker経由でクラウドストレージに配信します。
利用できる収益レポートを、以下の表に示します。注意:旧版の広告収益レポート[単一バージョン]を除き、すべてのレポートにROI360 Advancedパッケージの契約が必要です。
| レポート | 連携方式 | 説明 | データの更新・反映 |
|---|---|---|---|
|
|
|
|
|
|
|
|
| 広告収益[SDK広告表示単位] |
|
|
1時間ごと。詳細はこちら |
| 取引単位のストア収益 | ROI360のIAP・サブスクリプション収益連携 |
|
1時間ごと |
| 端末単位のストア収益[更新版あり] | ROI360のIAP・サブスクリプション収益連携 |
|
8時間ごと |
レポート
以下では、各レポートの詳細、仕組み、配信の設定方法、アクセス方法を説明します。
[旧版]広告収益(単一バージョン)
1日分の広告収益データを端末単位に集計し、1つのバージョンとして提供するレポートです。レポートはX+1日に利用できます(Xは収益イベントの発生日)。
注意:オーガニックとリターゲティングの収益データは、別々のレポートで提供されます。これらのレポートは、構造と利用可能になるタイミングが同じです。
単一バージョンの広告収益レポートのデータサンプルをダウンロード。
データの取得元
広告収益パートナーとの連携方式に応じて、レポートのデータは次のいずれかから取得します。
- SDK:ROI360の広告収益SDK Connectorから送信される、広告表示単位のデータ。
- S2S:パートナー(メディエーションまたは広告収益化ネットワーク)にAPIリクエストを送り、取得した端末単位のレポート。
連携方式の設定方法は、広告収益パートナーとの連携を参照してください。
データ処理の流れ
- データの取り込み:広告収益SDK ConnectorまたはS2S APIリクエストからデータを取得します(上記を参照)。
-
データの処理:AppsFlyer ROI360の広告収益機能が、次の処理を行います。
- データの表記・形式の統一。
- インストール元への紐づけと、関連情報の追加。
- 広告収益イベントの生成。
- イベントの端末単位への集計。
注意:同じ端末について、端末単位の集計データが複数行含まれる場合があります。端末単位の集計には、広告収益化ネットワーク、広告の掲載位置、広告の種類など、収益化に関するディメンションも使われるためです。例えば、アプリ内の2つの異なる位置に広告を表示する場合、端末単位の収益イベントは掲載位置ごとに別々に集計されます。
- データの配信:端末単位のデータを、単一バージョンのレポートに書き込みます。
レポートデータを利用できるタイミング
| 連携方式 | バージョンの配信日(X=収益イベントの発生日) | バージョンの利用開始時刻 | バージョンに含まれる収益イベントの発生期間 |
|---|---|---|---|
| SDK | X+1日 | 20:00 | 00:00 — 24:00 |
| SDK+S2S | X+1日 | 17:00 | 00:00 — 24:00 |
レポートの配信設定
- AppsFlyerのサイドメニューから[レポート]>[Data Locker]を選択します。
- [Data Lockerのコンテンツ]ペインを下にスクロールし、[ROI360収益ETL]タイルを探します。
- [アトリビューション済み収益(単一バージョン)]を選択します。
注意:リターゲティングとオーガニックについても、同じ種類のレポート(リターゲティング/オーガニック広告収益[単一バージョン])を選択できます。
バケット内のレポートへのアクセス方法
レポートのパスは、次のフォルダー階層で構成されます。
形式:<bucket-name>/t=attributed_ad_revenue/dt=<dt=yyyy-mm-dd>/h=23/
レポートのフォルダー階層
広告主のバケットに保存される、アトリビューション済み広告収益の単一バージョンレポートのフォルダー階層の例:
bucket
|
└── t=attributed_ad_revenue
|
├── dt=2023-06-02
| |
| └── h=23
| |
| ├── part-00000-4762858-d62a-446e-b499-dd05f2d5434d-c000.csv.gz
| |
| ├── part-00001-4762858-d62a-446e-b499-dd05f2d5434d-c000.csv.gz
| │
| └── part-00002-4762858-d62a-446e-b499-dd05f2d5434d-c000.csv.gz
|
├── dt=2023-06-01
| |
| └── h=23
| |
| ├── part-00000-1d295376-d024-4321-8d34-1fbb37cbb58d-c000.csv.gz
| |
| ├── part-00001-1d295376-d024-4321-8d34-1fbb37cbb58d-c000.csv.gz
| │
| └── part-00002-1d295376-d024-4321-8d34-1fbb37cbb58d-c000.csv.gz
|
├── dt=2023-05-31
| |
. .
. .
凡例:
- dt:レポートに含まれる収益イベントの発生日。
- t:レポートの種類
- h:単一バージョンを作成した時刻
広告収益(更新版あり)
同じ日付の収益データを、複数のバージョンで提供するレポートです。例えば、6月21日に発生した収益は、6月21日、22日、23日、24日、28日、7月5日に報告されます。
同じ日付のデータを複数のバージョンで取得することで、時間の経過とともに条件が変わり、収益の計算結果が変動した場合も反映できます。例えば、広告表示時に計上された収益額が、翌日には変わる場合があります。
注意:オーガニックとリターゲティングの収益データは、別々のレポートで提供されます。これらのレポートは、構造と利用可能になるタイミングが同じです。
更新版を含む広告収益レポートのデータサンプルをダウンロード。
データの取得元
パートナーとの連携方式に応じて、レポートのデータは次のいずれかから取得します。
- SDK:ROI360の広告収益SDK Connectorから送信される、広告表示単位のデータ。
- S2S:パートナー(メディエーションまたは広告収益化ネットワーク)にAPIリクエストを送り、取得した端末単位のレポート。
- S2S+SDK:SDKとS2Sの両方から送信されるデータ。
連携方式の設定方法は、広告収益パートナーとの連携を参照してください。
データ処理の流れ
- データの取り込み:SDKまたはS2S APIリクエストからデータを取得します(上記を参照)。
-
データの処理:AppsFlyer ROI360の広告収益機能が、次の処理を行います。
- データの表記・形式の統一。
- インストール元への紐づけと、関連情報の追加。
- 広告収益イベントの生成。
- イベントの端末単位への集計。
注意:同じ端末について、端末単位の集計データが複数行含まれる場合があります。端末単位の集計には、広告収益化ネットワーク、広告の掲載位置、広告の種類など、収益化に関するディメンションも使われるためです。例えば、アプリ内の2つの異なる位置に広告を表示する場合、端末単位の収益イベントは掲載位置ごとに別々に集計されます。
- データの配信:以下に示す所定のスケジュールに従って、端末単位のデータをレポートの各バージョンに書き込みます。
各バージョンを利用できるタイミング
以下の表に、S2S版とSDK版の生成スケジュールを示します。 ROI360の広告収益機能「Freshness to Accuracy」では、両方のバージョンを受信することで、データの速報性と正確性を両立できます。
注意:S2Sのデータに基づくバージョンは、生成されない場合があります。 前回の取得以降、パートナーのデータに変更がない場合、新しいバージョンは生成されません。
| 連携方式 | バージョンの配信日(X=収益イベントの発生日) | バージョンの利用開始時刻 | バージョンに含まれる収益イベントの発生期間 |
|---|---|---|---|
| SDK | X日 | 03:00-04:00 | 00:00 — 24:00 |
| SDK | X日 | 07:00-08:00 | 00:00 — 07:00 |
| SDK | X日 | 11:00-12:00 | 00:00 — 11:00 |
| SDK | X日 | 15:00-16:00 | 00:00 — 15:00 |
| SDK | X日 | 19:00-20:00 | 00:00 — 19:00 |
| SDK | X日 | 23:00-24:00 | 00:00 — 23:00 |
| SDK | X+1日 | 04:00-05:00 | 00:00 — 24:00 |
| S2S | X+1日 | 10:00-11:00 | 00:00 — 24:00 |
| S2S | X+1日 | 16:00-17:00 | 00:00 — 24:00 |
| S2S | X+2日 | 00:00-01:00 | 00:00 — 24:00 |
| S2S | X+2日 | 13:00-14:00 | 00:00 — 24:00 |
| S2S | X+3日 | 06:00-07:00 | 00:00 — 24:00 |
| S2S | X+7日 | 08:00-09:00 | 00:00 — 24:00 |
| S2S | X+14日 | 11:00-12:00 | 00:00 — 24:00 |
| SDK+S2S | 上記のSDK版とS2S版のすべて |
レポートの配信設定
- AppsFlyerのサイドメニューから[レポート]>[Data Locker]を選択します。
- [Data Lockerのコンテンツ]ペインを下にスクロールし、[ROI360収益ETL]タイルを探します。
- [アトリビューション済み広告収益(更新版あり)]を選択します。
注意:リターゲティングとオーガニックについても、同じ種類のレポート(リターゲティング/オーガニック広告収益[更新版あり])を選択できます。
バケット内のレポートへのアクセス方法
レポートのパスは、次のフォルダー階層で構成されます。
<bucket-name>/t=attributed_ad_revenue_v2/dt=<dt=yyyy-mm-dd>/version=<9999999>/
レポートのフォルダー階層
広告主のバケットに保存される、レポートのフォルダー構造の例:
bucket
|
└── t=attributed_ad_revenue_v2
|
└── dt=2023-06-01
|
├── version=1685588879
| |
│ ├── part-00000-4762858-d62a-446e-b499-dd05f2d5434d-c000.csv.gz
| |
│ ├── part-00001-4762858-d62a-446e-b499-dd05f2d5434d-c000.csv.gz
| │
| └── part-00002-4762858-d62a-446e-b499-dd05f2d5434d-c000.csv.gz
|
├── version=1685603326
| |
│ ├── part-00000-1d295376-d024-4321-8d34-1fbb37cbb58d-c000.csv.gz
| |
│ ├── part-00001-1d295376-d024-4321-8d34-1fbb37cbb58d-c000.csv.gz
| │
| └── part-00002-1d295376-d024-4321-8d34-1fbb37cbb58d-c000.csv.gz
|
├── version=1685617877
.
.
.
-
凡例:
- t:レポートの種類
- dt:レポートに含まれる収益イベントの発生日。
- version:バージョン名は、そのバージョンが作成された日時のエポックタイムスタンプです。例:version=1685588879。
- バージョンの作成時刻から、SDKとS2Sのどちらのデータをもとに作成されたかを確認できます。最初のSDK版は、SDKのデータをもとに作成されます。それ以外は、S2Sのデータをもとに作成されます。
| 連携方式 | バージョンの配信日(X=収益イベントの発生日) | バージョンの利用開始時刻 | バージョンに含まれる収益イベントの発生期間 |
|---|---|---|---|
| SDK | X日 | 03:00-04:00 | 00:00 — 24:00 |
| SDK | X日 | 07:00-08:00 | 00:00 — 07:00 |
| SDK | X日 | 11:00-12:00 | 00:00 — 11:00 |
| SDK | X日 | 15:00-16:00 | 00:00 — 15:00 |
| SDK | X日 | 19:00-20:00 | 00:00 — 19:00 |
| SDK | X日 | 23:00-24:00 | 00:00 — 23:00 |
| SDK | X+1日 | 04:00-05:00 | 00:00 — 24:00 |
| S2S | X+1日 | 10:00-11:00 | 00:00 — 24:00 |
| S2S | X+1日 | 16:00-17:00 | 00:00 — 24:00 |
| S2S | X+2日 | 00:00-01:00 | 00:00 — 24:00 |
| S2S | X+2日 | 13:00-14:00 | 00:00 — 24:00 |
| S2S | X+3日 | 06:00-07:00 | 00:00 — 24:00 |
| S2S | X+7日 | 08:00-09:00 | 00:00 — 24:00 |
| S2S | X+14日 | 11:00-12:00 | 00:00 — 24:00 |
広告収益(SDK広告表示単位)
広告表示単位のデータを、発生時刻ごとのフォルダーに分けて提供するレポートです。各フォルダーには、その1時間に発生したインプレッションのみが含まれます。
広告表示単位の広告収益レポートのデータサンプルをダウンロード
データの取得元
ROI360の広告収益SDK Connectorから送信された広告表示単位のデータを使用するため、SDK方式の連携が必要です。
連携方式の設定方法は、広告収益パートナーとの連携を参照してください。
データ処理の流れ
- データの取り込み:ROI360の広告収益SDK Connectorから送信された広告表示単位のデータを使用します。SDK方式の連携が必要です。
-
データの処理:AppsFlyer ROI360の広告収益機能が、次の処理を行います。
- データの表記・形式の統一。
- インストール元への紐づけと、関連情報の追加。
- 広告表示単位の広告収益イベントの生成。
- データの配信:インプレッションイベントを発生時刻ごとのフォルダーに分け、ファイルに書き込みます。各フォルダーには、その1時間に発生したインプレッションのみが含まれます。
レポートデータを利用できるタイミング
| 連携方式 | バージョンの配信日(X=収益イベントの発生日) | バージョンの利用開始時刻 |
|---|---|---|
| SDK | X日 | 各レポート対象時間の終了時 |
レポートの配信設定
- AppsFlyerのサイドメニューから[レポート]>[Data Locker]を選択します。
- [Data Lockerのコンテンツ]ペインを下にスクロールし、[ROI360収益ETL]タイルを探します。
- [広告収益(SDK広告表示単位)]を選択します。
バケット内のレポートへのアクセス方法
レポートのパスは、次のフォルダー階層で構成されます。
<bucket-name>/t=attributed_adrevenue_sdk_impression_level/dt=<dt=yyyy-mm-dd>/h=<hh>
レポートのフォルダー階層
広告主のバケットに保存される、レポートのフォルダー構造の例:
bucket
|
└── t=attributed_adrevenue_sdk_impression_level/
|
├── dt=2023-06-01
| |
| ├── h=0
| | |
| │ ├── part-00000-4762858-d62a-446e-b499-dd05f2d5434d-c000.csv.gz
| ├── h=1
| | |
| │ ├── part-00000-4762858-d62a-446e-b499-dd05f2d5434d-c000.csv.gz
| ├── h=2
| . |
| . ├── part-00000-4762858-d62a-446e-b499-dd05f2d5434d-c000.csv.gz
| . .
| ├── h=23
| | |
| │ ├── part-00000-4762858-d62a-446e-b499-dd05f2d5434d-c000.csv.gz
| └── h=24
| |
| └── part-00000-4762858-d62a-446e-b499-dd05f2d5434d-c000.csv.gz
|
├── dt=2023-06-02
| |
| ├── h=0
. .
. .
凡例:
- t:レポートの種類
- dt:レポートに含まれる収益イベントの発生日。
- h:その1時間に発生したインプレッションのCSVファイルを含む、時間別フォルダー。
取引単位のストア収益
当日発生した取引のローデータを、取引単位で提供するレポートです。時間別フォルダーに分かれ、各フォルダーにはその1時間の取引のみが含まれます。
データの取得元
ROI360 Purchase SDK Connectorとストアのサーバー間通知を通じて収集した取引データを使用します。
データ処理の流れ
- ROI360 Purchase SDK Connectorから送信されたデータ、またはストアのS2S通知から収集した取引データを使用します。
- AppsFlyer ROI360のVIAP/サブスクリプション機能がデータを処理して獲得元に紐づけ、取引単位のイベントと値を生成します。
- 取引単位のイベントを、時間別フォルダーに分けてレポートに書き込みます。
レポートデータを利用できるタイミング
| バージョンの配信日(X=収益イベントの発生日) | バージョンの利用開始時刻 |
|---|---|
| X日 | 各レポート対象時間の終了時 |
レポートの配信設定
- AppsFlyerのサイドメニューから[レポート]>[Data Locker]を選択します。
- [Data Lockerのコンテンツ]ペインを下にスクロールし、[ROI360収益ETL]タイルを探します。
- [取引単位のストア収益レポート]を選択します。
バケット内のレポートへのアクセス方法
レポートのパスは、次のフォルダー階層で構成されます。
<bucket-name>/t=stores_rawdata/dt=<dt=yyyy-mm-dd>/h=<hh>
レポートのフォルダー階層
広告主のバケットに保存される、レポートのフォルダー構造の例:
bucket
|
└── t=stores_rawdata
|
├── dt=2023-06-01
| |
| ├── h=0
| | |
| │ ├── part-00000-4762858-d62a-446e-b499-dd05f2d5434d-c000.csv.gz
| ├── h=1
| | |
| │ ├── part-00000-4762858-d62a-446e-b499-dd05f2d5434d-c000.csv.gz
| ├── h=2
| . |
| . ├── part-00000-4762858-d62a-446e-b499-dd05f2d5434d-c000.csv.gz
| . .
| ├── h=23
| | |
| │ ├── part-00000-4762858-d62a-446e-b499-dd05f2d5434d-c000.csv.gz
| └── h=24
| |
| └── part-00000-4762858-d62a-446e-b499-dd05f2d5434d-c000.csv.gz
|
├── dt=2023-06-02
| |
| ├── h=0
. .
. .
凡例:
- t:レポートの種類
- dt:レポートに含まれる収益イベントの発生日。
- h:その1時間に発生した取引のCSVファイルを含む、時間別フォルダー。
端末単位のストア収益(更新版あり)
端末単位のストア収益レポートには、ROI360の各機能で記録したアプリ内購入と自動更新サブスクリプションのイベントが含まれます。これらのイベントには、ROI360独自の収益化関連ディメンションが含まれます。お客様が送信したアプリ内イベントは、このレポートには含まれません。
データの取得元
レポートには、次の方法で収集した取引データを使用します。
- ROI360 Purchase SDK Connector。
- ストア(App Store、Google Playなど)からのサーバー間通知。
データ処理の流れ
- ROI360 Purchase SDK Connectorから送信されたデータ、またはストアのS2S通知から収集した取引データを使用します。
- AppsFlyer ROI360のVIAP/サブスクリプション機能がデータを処理して獲得元に紐づけ、アプリ内イベントを生成します。
- アプリ内イベントを端末単位で集計し、4時間ごとにレポートの各バージョンに書き込みます。
各バージョンを利用できるタイミング
| バージョンの配信日(X=収益イベントの発生日) | バージョンの利用開始時刻 | バージョンに含まれる収益イベントの発生期間 |
|---|---|---|
| X日 | 04:00 - 05:00 | 00:00 — 04:00 |
| X日 | 12:00 - 13:00 | 00:00 — 12:00 |
| X日 | 20:00 - 21:00 | 00:00 — 20:00 |
| X+1日 | 05:00 - 06:00 | 00:00 — 24:00 |
レポートの配信設定
- AppsFlyerのサイドメニューから[レポート]>[Data Locker]を選択します。
- [Data Lockerのコンテンツ]ペインを下にスクロールし、[ROI360収益ETL]タイルを探します。
- [端末単位のストア収益レポート(更新版あり)]を選択します。
バケット内のレポートへのアクセス方法
レポートのパスは、次のフォルダー階層で構成されます。
<bucket-name>/t=stores_devicedata/dt=<dt=yyyy-mm-dd>/version=<999999999>
レポートのフォルダー階層
広告主のバケットに保存される、レポートのフォルダー構造の例:
bucket
|
└── t=stores_devicedata
|
└── dt=2023-06-01
|
├── version=1685588879
| |
│ ├── part-00000-4762858-d62a-446e-b499-dd05f2d5434d-c000.csv.gz
| |
│ ├── part-00001-4762858-d62a-446e-b499-dd05f2d5434d-c000.csv.gz
| │
| └── part-00002-4762858-d62a-446e-b499-dd05f2d5434d-c000.csv.gz
|
├── version=1685603326
| |
│ ├── part-00000-1d295376-d024-4321-8d34-1fbb37cbb58d-c000.csv.gz
| |
│ ├── part-00001-1d295376-d024-4321-8d34-1fbb37cbb58d-c000.csv.gz
| │
| └── part-00002-1d295376-d024-4321-8d34-1fbb37cbb58d-c000.csv.gz
|
├── version=1685617877
.
.
.
凡例:
- t:レポートの種類
- dt:レポートに含まれる収益イベントの発生日。
- version:バージョン名は、そのバージョンが作成された日時のエポックタイムスタンプです。例:version=1685588879。