> 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/ko/reporting/reporting-overview.md).

# 개요

## 물리적 아키텍처

해당 Epsilon Retail Media Reporting API는 다음으로의 보안 액세스를 제공합니다. Epsilon Retail Media 데이터 웨어하우스. 데이터 웨어하우스 자체에는 다음으로부터 소스된 데이터 및 인사이트가 포함되어 있습니다. Epsilon Retail Media 플랫폼.

해당 Epsilon Retail Media 데이터 웨어하우스는 분산 모델입니다. 일부 데이터는 다음 내부의 로컬에 보관됩니다. Epsilon Retail Media 플랫폼 인스턴스, 기타 데이터는 중앙 집중식 글로벌 데이터 웨어하우스에 보관됩니다.

다음 다이어그램은 데이터 모델의 구조를 보여줍니다.

<figure><img src="/files/fSOHOFcg2viuqDK45LGH" 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 캠페인 지출 통계
  * 원장 거래 요약(청구 정보, 지갑 충전 등)
  * 주문 통계

리포팅 API는 일반적으로 핵심 데이터세트 및/또는 리포팅 데이터마트 내의 스키마를 공유하는 데 사용됩니다. 이 두 스키마는 언급된 주제 영역을 포함하지만 집계 수준이 다릅니다(핵심 데이터세트는 집계뿐만 아니라 팩트에 대한 거래 수준 세부 정보를 제공함).

<figure><img src="/files/p2Gd0aXnJEtuASGILi77" 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 및 Realised Ad Statistics에 나타나는 지면/위치에만 해당합니다.      | 통합업체에 승인을 부여한 리테일러 팀 관련                                     |

## 사용자 액세스 방식

사용하는 클라우드 플랫폼에 따라 두 가지 유형의 액세스 방식이 존재합니다.

| 사용자 유형                             | 액세스 방식                                                                                                                                                                                                                                                                                         |
| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 기본 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/ko/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.
