개요

물리적 아키텍처

CitrusAd 보고 API는 CitrusAd 데이터 웨어하우스에 대한 보안 액세스를 제공합니다. 데이터 웨어하우스에는 CitrusAd 플랫폼에서 가져온 데이터와 인사이트가 포함되어 있습니다.

CitrusAd 데이터 웨어하우스는 분산형 모델입니다. 일부 데이터는 CitrusAd 플랫폼 인스턴스 내에 로컬로 보관되며 기타 데이터는 중앙 집중식 글로벌 데이터 웨어하우스에 보관됩니다.

다음 다이어그램은 데이터 모델의 구조입니다.

레이어설명
플랫폼 데이터CitrusAD 플랫폼에서 가져온 소스 데이터입니다. 플랫폼은 자체적으로 여러 물리적 인스턴스에 분산되어 있습니다. 인스턴스는 대형 소매업체별로 존재하거나 경우에 따라 여러 소규모 소매업체 간에 안전하게 공유됩니다.
플랫폼 데이터에 대한 직접 액세스는 외부 연결에 허용되지 않습니다.
스테이징 데이터관련 플랫폼 데이터는 거의 실시간으로 데이터 웨어하우스에 스테이징됩니다. 스테이징 데이터는 플랫폼 인스턴스별로 플랫폼 데이터와 동일한 물리적 위치에 보관됩니다.
스테이징 데이터에 대한 직접 액세스는 일반적으로 외부 연결에 허용되지 않습니다.
코어 데이터 세트배치 프로세스는 매일 스테이징 데이터를 사용하여 코어 데이터세트라 하는 사용하기 쉬운 눈송이 스키마로 모델링합니다. 또한 코어 데이터세트는 플랫폼 인스턴스별로 스테이지 데이터 및 플랫폼 데이터와 동일한 물리적 위치에 보관됩니다.
각 코어 데이터세트 사실은 개별 거래 및 세부 집계 레벨 모두에서 제공됩니다.
또한 변경 사항 추적은 여러 차원에서 가능합니다.
코어 데이터세트에 대한 직접 액세스는 주로 소매업체 수준(승인 대상)에서 특정 클라이언트에게(요청 시) 허용됩니다.
집계된 코어 데이터 세트코어 데이터세트가 업데이트되면 배치 프로세스는 개별 코어 데이터세트를 가져와 중앙 위치(글로벌 데이터 웨어하우스)로 전송합니다. 그 후 개별 코어 데이터세트는 단일 통합 집계 코어 데이터세트로 통합됩니다.
참고: 글로벌 데이터 웨어하우스에는 집계된 사실 데이터(거래 데이터 아님)만 저장됩니다.
일반적으로 집계 코어 데이터세트에 대한 직접 액세스는 외부 연결에 허용되지 않습니다.
데이터마트 보고집계된 코어 데이터 세트가 업데이트된 후 일일 배치 프로세스는 더욱 단순화되고 집계된 보고 데이터마트를 계산합니다.
코어 데이터 세트와 마찬가지로 보고 데이터마트 또한 눈송이 스키마입니다. 현재 버전의 차원만 제공됩니다. 클라이언트는 일일 스냅샷을 기반으로 필요에 따라 자체 데이터 웨어하우스 내에서 변경 내역을 로컬로 유지해야 합니다.
보고 데이터마트에는 특정 사실을 데코레이팅하고 클라이언트 쿼리를 보다 단순화하는 보기도 포함되어 있습니다.
보고 데이터마트에 대한 직접 액세스는 소매업체와 공급업체를 포함한 다양한 클라이언트(승인 대상)에게 허용됩니다(요청 시).
인사이트
[출시 예정]
보고 데이터마트에 추가적으로 구성된 보기 기능으로 클라이언트가 자주 요청하는 사전 설정된 인사이트가 제공됩니다. 예:
캠페인 효과(실현된 광고 통계 예: CTR/ROAS)
인벤토리 실제 노출률(유료 광고로 채워지는 요청 %)
음성 점유(카테고리/검색어별 공급업체 노출률 등)
청구(기간별 캠페인당 지갑 지출)

인사이트 계층에 대한 액세스는 소매업체 및 공급업체를 포함한 다양한 클라이언트(승인 대상)에게 허용됩니다(요청 시).
또한 이 문서에서는 인사이트 계층을 구성하는 데 사용되는 SQL 코드도 공유하므로 보고 데이터마트를 데이터 웨어하우스에 복사하는 클라이언트가 로직을 쉽게 복제하는 방법을 이해할 수 있습니다.
시각화
[제한적 출시]
보고 데이터마트 및 인사이트 계층에 추가적으로 구성된 보기 기능으로 기존 BI 플랫폼과 동일한 데이터를 제공합니다.
현재 시각화 계층에 대한 액세스(요청 시)는 기존 BI 플랫폼에 제공된 것과 정확히 동일한 데이터에 액세스해야 하는 소매업체 및 공급업체 클라이언트에게 허용됩니다(승인 필요).
참고: 기존 BI 플랫폼과 정확히 조정할 필요가 없는 경우 보고 데이터마트 또는 이에 해당하는 인사이트 계층을 사용하는 것이 좋습니다. 또한 더 긴 기간에 걸쳐 더 세분화된 데이터가 포함되어 있습니다.

논리적 데이터 모델

액세스 유형에 따라 사용 가능한 데이터에는 다음과 같은 일반적으로 요청되는 CitrusAD 플랫폼 주제 영역이 포함됩니다.

(용어에 대한 자세한 설명은 용어집을 참조하십시오.)

  • 차원 데이터
    • 캠페인
    • 제품 카탈로그
    • 제품
      • 소매업체
      • 공급업체
    • 지갑
    • 검색어
    • 카테고리
    • 게재위치
  • 사실 데이터
    • 광고 요청 통계(검색어 또는 카테고리별 요청 수 등)
    • 실현된 광고 통계(검색어, 카테고리별 노출 수/클릭 수/광고 지출액 등)
    • 향상된 어트리뷰션 통계 (구성된 경우에만 - 노출 뷰 스루, 헤일로 클릭 어트리뷰션 등)
    • FTA 캠페인 지출 통계
    • 원장 거래 요약 (청구 정보, 지갑 충전 등)
    • 주문 통계

보고 API는 일반적으로 코어 데이터세트 및/또는 보고 데이터마트 내에서 스키마를 공유하는 데 사용됩니다. 이 두 가지 스키마 모두 집계 수준만 다를 뿐 앞서 언급한 주제 영역을 다룹니다(코어 데이터세트는 집계뿐만 아니라 사실에 대한 거래 수준 세부 정보를 제공합니다).

네임스페이스 다이어그램

사용자 유형

사용자가 속한 조직에 부여된 조회 권한에 따라 사용자별로 확인할 수 있는 주제 영역이 제한됩니다. 조직 액세스에는 네 가지 유형이 있습니다.

  • 네임스페이스 레벨: 팀의 전체 네트워크(공급업체 및 소매업체 팀 모두)를 제어하는 클라이언트입니다. 네임스페이스 수준 액세스는 특정 CitrusAd 구현에 대한 모든 데이터에 가시성을 부여합니다.
  • 소매업체 레벨: 특정 소매업체 팀(또는 소매업체 팀 그룹)만 제어하는 클라이언트입니다.
  • 공급업체 레벨: 특정 공급업체 팀(또는 공급업체 팀 그룹)만 제어하는 클라이언트입니다.
    • 통합자 레벨: 특정 소매업체 레벨 개체에 대한 전체 액세스 권한이 있는 경우를 제외하고(소매업체 재량에 따라) 공급업체 레벨의 확장입니다.

다음은 주요 주제 영역과 세 가지 액세스 유형에 적용되는 범위입니다.

주제 영역네임스페이스소매업체공급업체통합자
캠페인모든 데이터소매업체 팀 관련공급업체 팀과 관련공급업체 팀 관련
제품 카탈로그모든 데이터소매업체 팀 관련데이터 없음통합자에게 승인을 부여한 소매업체 팀 관련
제품모든 데이터소매업체 팀 관련실현된 광고 통계 supplier_product 테이블에 표시되는 제품만통합자에게 승인을 부여한 소매업체 팀 관련
모든 데이터소매업체 팀 관련공급업체 팀과 관련공급업체 팀과 관련
소매업체모든 데이터소매업체 팀 관련실현된 광고 통계 supplier_retailer 테이블에 표시되는 소매업체만실현된 광고 통계에 표시되는 소매업체만
공급업체모든 데이터실현된 광고 통계 retailer_supplier 표에 표시되는 공급업체만공급업체 팀과 관련공급업체 팀과 관련
지갑모든 데이터소매업체 팀 지갑만공급업체 팀 지갑만공급업체 팀 지갑만
검색어모든 데이터소매업체 팀 관련실현된 광고 통계에 표시되는 검색어만(사실 테이블에 있는 그대로만 표시됨)실현된 광고 통계에 표시되는 검색어만(사실 테이블에 있는 그대로만 표시됨)
카테고리모든 데이터소매업체 팀 관련실현된 광고 통계에 표시되는 카테고리만(사실 테이블에 있는 그대로만 표시됨)실현된 광고 통계에 표시되는 카테고리만(사실 테이블에 있는 그대로만 표시됨)
광고 요청 통계모든 데이터소매업체 팀 관련데이터 없음데이터 없음
향상된 어트리뷰션 통계모든 데이터소매업체 팀 관련공급업체 팀과 관련공급업체 팀과 관련
FTA 캠페인 지출 통계모든 데이터소매업체 팀 관련공급업체 팀과 관련공급업체 팀과 관련
원장 거래 요약모든 데이터소매업체 팀 지갑만공급업체 팀 지갑만공급업체 팀 지갑만
주문 통계모든 데이터소매업체 팀 관련데이터 없음데이터 없음
실현된 광고 통계(노출 수/클릭 수, 광고 지출액 등)모든 데이터소매업체 팀 관련공급업체 팀과 관련공급업체 팀과 관련
게재위치모든 데이터소매업체 팀 관련광고 요청 및 실현된 광고 통계에 나타나는 게재위치만통합자에게 승인을 부여한 소매업체 팀 관련

사용자 액세스 방법

사용하는 클라우드 플랫폼에 따라 두 가지 유형의 액세스 방법이 있습니다.

사용자 유형액세스 방법
기본 Google Cloud Platform(GCP) 사용자직접 액세스. CitrusAd 데이터 웨어하우스가 BigQuery(GCP 데이터 웨어하우스 서비스)에 배포되므로 GCP을 사용하는 클라이언트는 데이터세트에 직접 액세스할 수 있습니다. 이를 통해 자체 GCP 프로젝트에서 BigQuery UI를 통해 객체를 보고 쿼리할 수 있습니다. 사용자의 GCP 프로젝트의 이메일 주소를 제공하기만 하면 그에 따른 권한이 부여됩니다(승인 대기 중). 참고: 직접 액세스 사용자는 BigQuery API를 사용하는 것 외에도 스크립트 등을 통해 BigQuery API를 호출할 수 있습니다.
기타(GCP 외) 사용자API. GCP(예: Azure 또는 AWS) 사용자가 아닌 경우 CitrusAd에서 계정(서비스 계정)을 생성한 후 자격 증명을 제공합니다(승인 대기 중). 이 계정에는 BigQuery API 수준 액세스 권한만 부여됩니다(클라우드 콘솔에는 액세스할 수 없음).

버전: f34ea10