이 페이지는 Cloud Translation API를 통해 번역되었습니다.

개요

Reporting API

Reporting API를 사용하면 판매자가 판매자 센터 쿼리 언어를 통해 프로그래매틱 방식으로 실적 데이터에 참여할 수 있습니다. 이는 판매자 센터에서 직접 맞춤 보고서를 만드는 기능과 유사합니다. Reporting API에는 다음과 같은 이점이 있습니다.

대형 판매자가 제품 등록정보의 실적 데이터를 내부 또는 서드 파티 보고 시스템으로 가져올 수 있습니다.
판매자 센터 계정 액세스 보고를 관리하는 사용자, 서드 파티 파트너, 애그리게이터를 허용합니다.

API 사용자는 다음과 같이 검색 호출 응답에서 검색할 성능 데이터를 지정할 수 있습니다.

반환될 측정항목 (예: 클릭수, 노출수)
데이터를 분류할 측정기준 (예: OfferId, 날짜)
충족해야 하는 조건 (예: 클릭수 > 100)

Reporting API 쿼리 언어는 Reports 서비스의 Search 메서드를 사용하여 Content API for Shopping에 실적 측정항목 (클릭수, 노출수)을 쿼리할 수 있습니다. 이러한 측정항목은 Reports 서비스의 Search 메서드를 사용하여 다양한 측정기준 (프로그램 및 날짜와 같은 보고된 이벤트 속성 및 브랜드, 카테고리 등의 제품 속성)별로 세분화될 수 있습니다.

Reports 서비스에 대한 쿼리 결과는 ReportRow 인스턴스의 목록으로, 각 ReportRow은 쿼리에서 지정한 세그먼트의 요청된 측정항목 값을 나타냅니다. 세그먼트를 지정하지 않으면 모든 세그먼트에서 집계된 측정항목과 함께 단일 행이 반환됩니다. 그렇지 않고 측정항목이 측정항목과 함께 요청되면 응답은 고유한 세그먼트 튜플마다 하나의 행을 표시합니다. 단일 쿼리에서 여러 세그먼트와 측정항목을 선택할 수도 있습니다

측정항목 쿼리

반환하려는 측정항목 (클릭수, 노출수, CTR 등)을 쿼리할 수 있습니다. 보고서 서비스를 쿼리하려면 기간에 필터를 추가해야 합니다. 아래의 샘플 쿼리는 단일 행을 반환합니다. 즉, 기간에 추가된 조건 내에서 집계된 클릭수입니다.

SELECT metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-21';

샘플 응답

아래의 샘플 JSON 코드 응답은 이 판매자가 2020년 12월 1일부터 2020년 12월 21일 사이에 모든 대상 유형의 모든 제품에서 합산된 클릭수 4,440회를 보여줍니다.

{"results": [
    {
      "metrics": {
        "clicks": "4,440"
      }
    }
]}

세그먼트 쿼리

측정항목과 함께 제품 속성 (offer_id, brand, category 등) 또는 보고된 이벤트의 속성 (date, program)일 수 있는 세그먼트를 쿼리할 수도 있습니다. 보고된 이벤트는 제품의 노출 또는 클릭입니다.

세그먼트는 SQL의 GROUP BY와 유사하게 작동합니다. 세그먼트는 SELECT 절에서 각 세그먼트별로 그룹화하여 선택된 측정항목을 분할합니다. 아래의 샘플 쿼리는 일일 클릭수를 반환하며, 기간이 추가된 조건 내 클릭수에 따라 내림차순으로 정렬됩니다. 최소 하나의 요청된 측정항목이 0이 아닌 행만 반환됩니다.

SELECT
  segments.date,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-03'
ORDER BY metrics.clicks DESC;

샘플 응답

아래의 샘플 JSON 코드 응답은 이 판매자가 2020년 12월 1일에는 전체 대상 유형에서 발생한 클릭수 1,546회, 2020년 12월 2일에는 모든 대상 유형에서 발생한 클릭수 829회를 보여줍니다. 2020년 12월 3일에는 판매자가 클릭하지 않았기 때문에 객체가 반환되지 않습니다.

{
  "results": [
    {
      "segments": {
        "date": {
          "year": 2020,
          "month": 12,
          "day": 1
        }
      },
      "metrics": {
        "clicks": "1546"
      }
    },
    {
      "segments": {
        "date": {
          "year": 2020,
          "month": 12,
          "day": 2
        }
      },
      "metrics": {
        "clicks": "829"
      }
    }
]}

쿼리 문법