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

개요

Reporting API

Reporting API를 사용하면 판매자가 실적 데이터를 활용할 수 있습니다. 판매자 센터 쿼리 언어를 통해 프로그래매틱 방식으로 쿼리할 수 있습니다 이것은 GCP 콘솔에서 맞춤 보고서 만들기 판매자 센터에서 바로 찾을 수 있습니다 Reporting API에는 다음과 같은 이점이 있습니다.

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

API 사용자는 가져올 실적 데이터를 지정할 수 있습니다. 통화 응답 검색. 예:

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

Reporting API 쿼리 언어는 다음과 같은 용도로 Content API for Shopping을 쿼리할 수 있습니다. 다양한 기준으로 분류될 수 있는 클릭수, 노출수, 측정기준 (프로그램, 날짜, 제품 등 보고된 이벤트 속성) Search 메서드를 사용하여 Reports 서비스.

Reports 서비스에 대한 쿼리 결과는 ReportRow 목록입니다. 인스턴스(각 ReportRow는 요청된 측정항목의 값을 나타냄) 세그먼트로 구성할 수 있습니다. 세그먼트를 지정하지 않으면 행은 모든 세그먼트에서 집계된 측정항목과 함께 반환됩니다. 기타(있는 경우) 세그먼트가 측정항목과 함께 요청되면 응답에서 각 고유 세그먼트 튜플을 기반으로 합니다. 여러 세그먼트를 선택하거나 여러 측정항목을 검색할 수 있습니다

측정항목 쿼리

원하는 측정항목 (클릭수, 노출수, CTR 등)을 반환합니다. 보고서를 쿼리하려면 기간에 필터를 추가해야 합니다. 서비스도 제공합니다 아래의 샘플 쿼리는 단일 행을 반환합니다. 총 금액 기간 중 추가된 조건 내 클릭수

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

샘플 응답

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

{"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 코드 응답은 이 판매자의 클릭수가 1,546회인 방식을 보여줍니다. 2020년 12월 1일 기준으로 모든 대상 유형의 모든 제품에 적용 모든 도착 페이지의 제품 전반에서 829회의 클릭이 발생했습니다. 2020년 12월 2일 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"
      }
    }
]}

쿼리 문법