> For the complete documentation index, see [llms.txt](https://help.citrusad.com/retail-media-interface/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.citrusad.com/retail-media-interface/integration/ja/reporting/reporting-overview.md).

# 概要

## Physical Architecture

The Epsilon Retail Media Reporting APIは、 Epsilon Retail Media データウェアハウスへの安全なアクセスを提供します。データウェアハウス自体には、 Epsilon Retail Media platform.

The Epsilon Retail Media データウェアハウスは分散モデルです。一部のデータは Epsilon Retail Media プラットフォームインスタンス内にローカルに保持され、その他のデータは中央のグローバルデータウェアハウスに保持されます。

以下の図はデータモデルの構造を示しています。

<figure><img src="/files/K9u0cOp8obNPGWUpQeqk" alt="" width="100%"><figcaption></figcaption></figure>

| レイヤー                            | 説明                                                                                                                                                                                                                                                                                                                                                                                                           |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| プラットフォームデータ                     | <p>～からのソースデータ Epsilon Retail Media プラットフォームからのソースデータ。プラットフォーム自体は複数の物理インスタンスに分散されています。インスタンスは大手小売りごとに存在するか、場合によっては複数の小規模な小売り間で安全に共有されます。<br>プラットフォームデータへの直接アクセスは、外部接続には許可されていません。</p>                                                                                                                                                                                                                         |
| ステージングデータ                       | <p>関連するプラットフォームデータは、ほぼリアルタイムでデータウェアハウスにステージングされます。ステージングデータは、プラットフォームデータと同じ物理的な場所で、プラットフォームインスタンスごとに維持されます。<br>ステージングデータへの直接アクセスは、通常、外部接続には許可されていません。</p>                                                                                                                                                                                                                                                    |
| コアデータセット                        | <p>日次ベースで、バッチプロセスがステージングデータを取得し、コアデータセットと呼ばれる使いやすいスノーフレークスキーマにモデル化します。コアデータセットも、ステージングデータおよびプラットフォームデータと同じ物理的な場所で、プラットフォームインスタンスごとに維持されます。<br>各コアデータセットのファクトは、個々のトランザクションレベルと集計された詳細レベルの両方で利用できます。<br>変更の追跡は多くのディメンションにも存在します。<br>コアデータセットへの直接アクセスは、（要求に応じて）主に小売りレベルの特定のクライアントに許可されます（承認が必要です）。</p>                                                                                                          |
| 集計済みコアデータセット                    | <p>コアデータセットが更新された後、バッチプロセスが個々のコアデータセットを取得し、中央の場所（グローバルデータウェアハウス）に転送します。その後、個々のコアデータセットは単一の統合された集計済みコアデータセットに統合されます。<br>なお、グローバルデータウェアハウスには集計されたファクトデータのみが保存され、トランザクションデータは保存されません。<br>集計済みコアデータセットへの直接アクセスは、通常、外部接続には許可されていません。</p>                                                                                                                                                                          |
| リポーティングデータマート                   | <p>集計済みコアデータセットが更新された後、日次バッチプロセスがさらに簡素化および集計されたリポーティングデータマートを計算します。<br>コアデータセットと同様に、リポーティングデータマートもスノーフレークスキーマです。ディメンションの現在のバージョンのみが提供されます。クライアントは、日次スナップショットに基づいて、必要に応じて独自のデータウェアハウス内でローカルに変更履歴を維持する必要があります。<br>リポーティングデータマートには、特定のファクトを装飾し、クライアントのクエリをさらに簡素化するビューも含まれています。<br>リポーティングデータマートへの直接アクセスは、（要求に応じて）小売りとサプライヤーの両方の幅広いクライアントに許可されます（承認が必要です）。</p>                                                   |
| <p>インサイト<br>\[近日公開]</p>         | <p>リポーティングデータマートの上に構築された一連のビューで、クライアントから一般的に要求される定義済みのインサイトを提供します。例：<br>キャンペーンの有効性（CTR/ROASなどの実績広告統計）<br>在庫充足率（有料広告で満たされているリクエストの割合）<br>シェアオブボイス（カテゴリ/検索語などごとのサプライヤーのインプレッションシェア）<br>請求（タイムペリオドごとのキャンペーンあたりのウォレット支出）<br><br>インサイトレイヤーへのアクセスは、（要求に応じて）小売りとサプライヤーの両方の幅広いクライアントに許可されます（承認が必要です）。<br>本ドキュメントでは、インサイトレイヤーの構築に使用されるSQLコードも共有しているため、リポーティングデータマートをデータウェアハウスにコピーするクライアントは、ロジックを簡単に複製する方法を理解できます。</p> |
| <p>ビジュアライゼーション<br>\[限定リリース]</p> | <p>リポーティングデータマートおよびインサイトレイヤーの上に構築された一連のビューで、従来のBIプラットフォームで表示されるものと同等のデータを提供します。<br>ビジュアライゼーションレイヤーへのアクセスは、現在、（要求に応じて）従来のBIプラットフォームで表示されていたとおりのデータへのアクセスを必要とする、小売りおよびサプライヤーのクライアントに許可されています（承認が必要です）。<br>注：従来のBIプラットフォームと正確に照合する必要がない限り、代わりにリポーティングデータマートまたはインサイトレイヤーと同等のものを使用することをお勧めします。これらには、より長い期間にわたるより詳細なデータも含まれています。</p>                                                                               |

## 論理データモデル

アクセスタイプに応じて、利用可能なデータには、次のように一般的に要求される多くの Epsilon Retail Media プラットフォームの主題領域が含まれます：

（定義の詳細については用語集を参照してください）

* ディメンションデータ
  * キャンペーン
  * 製品カタログ
  * 製品
  * チーム
    * 小売り
    * サプライヤー
  * ウォレット
  * 検索語
  * カテゴリ
  * プレイスメント
* ファクトデータ
  * 広告リクエスト統計（検索語またはカテゴリごとのリクエスト数など）
  * 実績広告統計（検索語またはカテゴリごとのインプレッション/クリック/広告支出など）
  * 拡張アトリビューション統計（設定されている場合のみ - インプレッションのビュースルー、ハロ―クリックアトリビューションなど）
  * FTAキャンペーン消化金額統計
  * 台帳取引サマリー（請求情報、ウォレットへのチャージなど）
  * 注文統計

Reporting APIは通常、Core Datasetおよび/またはReporting Datamart内のスキーマを共有するために使用されます。これら両方のスキーマは前述のサブジェクト領域をカバーしていますが、集計レベルが異なります（Core Datasetは集計値だけでなく、ファクトの取引レベルの詳細も提供します）。

<figure><img src="/files/vFhqha0jih7Nil30hjrK" alt="Namespace Diagram" width="100%"><figcaption></figcaption></figure>

## ユーザータイプ

表示できるサブジェクト領域は、組織が表示を許可されている内容に応じて制限されます。組織のアクセスレベルには4つのタイプがあります：

* ネームスペースレベル: チームのネットワーク全体（サプライヤーチームとリテールチームの両方）を制御するクライアント。ネームスペースレベルのアクセス権は、特定の導入におけるすべてのデータに対する可視性を付与します： Epsilon Retail Media.
* リテールレベル : 特定のリテールチーム（またはリテールチームのグループ）のみであるクライアント。
* サプライヤーレベル : 特定のサプライヤーチーム（またはサプライヤーチームのグループ）のみであるクライアント。
  * インテグレーターレベル: サプライヤーレベルの拡張ですが、（リテール企業の裁量のみにより）特定のリテールレベルのオブジェクトに全面的にアクセスできます。

これらはカバーされる主要なサブジェクト領域と、3つのアクセスタイプへの適用方法です。

| サブジェクト領域                         | ネームスペース | リテール企業                                                      | サプライヤー                                                             | インテグレーター                                                    |
| -------------------------------- | ------- | ----------------------------------------------------------- | ------------------------------------------------------------------ | ----------------------------------------------------------- |
| キャンペーン                           | すべてのデータ | リテールチームに関連                                                  | サプライヤーチームに関連                                                       | サプライヤーチームに関連                                                |
| 製品カタログ                           | すべてのデータ | リテールチームに関連                                                  | データなし                                                              | インテグレーターに承認を付与したリテールチームに関連                                  |
| 製品                               | すべてのデータ | リテールチームに関連                                                  | Realised Ad Statisticsのsupplier\_productテーブルに表示される商品のみ             | インテグレーターに承認を付与したリテールチームに関連                                  |
| チーム                              | すべてのデータ | リテールチームに関連                                                  | サプライヤーチームに関連                                                       | サプライヤーチームに関連                                                |
| 小売り                              | すべてのデータ | リテールチームに関連                                                  | Realised Ad Statisticsのsupplier\_retailerテーブルに表示されるリテール企業のみ        | Realised Ad Statisticsに表示されるリテール企業のみ                        |
| サプライヤー                           | すべてのデータ | Realised Ad Statisticsのretailer\_supplierテーブルに表示されるサプライヤーのみ | サプライヤーチームに関連                                                       | サプライヤーチームに関連                                                |
| ウォレット                            | すべてのデータ | リテールチームのウォレットのみ                                             | サプライヤーチームのウォレットのみ                                                  | サプライヤーチームのウォレットのみ                                           |
| 検索語                              | すべてのデータ | リテールチームに関連                                                  | Realised Ad Statisticsに表示される検索用語のみ（ファクトテーブル内にそのまま表示されるもののみ）        | Realised Ad Statisticsに表示される検索用語のみ（ファクトテーブル内にそのまま表示されるもののみ） |
| カテゴリ                             | すべてのデータ | リテールチームに関連                                                  | Realised Ad Statisticsに表示されるカテゴリのみ（ファクトテーブル内にそのまま表示されるもののみ）        | Realised Ad Statisticsに表示されるカテゴリのみ（ファクトテーブル内にそのまま表示されるもののみ） |
| 広告リクエスト統計                        | すべてのデータ | リテールチームに関連                                                  | データなし                                                              | データなし                                                       |
| 拡張アトリビューション統計                    | すべてのデータ | リテールチームに関連                                                  | サプライヤーチームに関連                                                       | サプライヤーチームに関連                                                |
| FTAキャンペーン消化金額統計                  | すべてのデータ | リテールチームに関連                                                  | サプライヤーチームに関連                                                       | サプライヤーチームに関連                                                |
| 台帳取引サマリー                         | すべてのデータ | リテールチームのウォレットのみ                                             | サプライヤーチームのウォレットのみ                                                  | サプライヤーチームのウォレットのみ                                           |
| 注文統計                             | すべてのデータ | リテールチームに関連                                                  | データなし                                                              | データなし                                                       |
| 実績広告統計（インプレッション / クリック 広告消化金額など） | すべてのデータ | リテールチームに関連                                                  | サプライヤーチームに関連                                                       | サプライヤーチームに関連                                                |
| プレイスメント                          | すべてのデータ | リテールチームに関連                                                  | Ad Request StatisticsおよびRealised Ad Statisticsに表示される配置（プレイスメント）のみ。 | インテグレーターに承認を付与したリテールチームに関連                                  |

## ユーザーアクセス方法

使用するクラウドプラットフォームに応じて、2種類のアクセス方法が存在します。

| ユーザータイプ                             | アクセス方法                                                                                                                                                                                                                                                                                      |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ネイティブGoogle Cloud Platform（GCP）ユーザー | ダイレクトアクセス 当社のデータウェアハウスはBigQuery（GCPのデータウェアハウスサービス）にデプロイされているため、ご自身でGCPを利用しているクライアントはデータセットに直接アクセスできます。これにより、自身のGCPプロジェクト内のBigQuery UIを介してオブジェクトを表示し、クエリを実行できます。GCPプロジェクトのメールアドレスをご提供いただくだけで、それに応じて権限を付与します（承認待ち）。なお、ダイレクトアクセスユーザーは（BigQuery APIの使用に加えて）スクリプトなどを介してBigQuery APIを呼び出すこともできます。 |
| その他の（GCP以外の）ユーザー                    | API GCPを利用していない場合（AzureやAWSなど）、 Epsilon Retail Media アカウント（サービスアカウント）を作成し、認証情報を提供します（承認待ち）。このアカウントでは、BigQuery APIレベルのアクセスのみが付与されます（クラウドコンソールにはアクセスできません）。                                                                                                                                   |

バージョン: 1ace13f


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.citrusad.com/retail-media-interface/integration/ja/reporting/reporting-overview.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.