Performance reports

판매자 API는 다음과 같은 실적 보고서를 제공합니다. ProductPerformanceView 이 페이지에서는 실적 보고서의 구조를 설명합니다.

측정항목

Google Cloud에서 실행 중인 측정항목 (예: clicks 및 impressions)을 반환합니다. 보고서를 쿼리하려면 기간에 필터를 추가해야 합니다. 서비스도 제공합니다

다음은 총 클릭수와 함께 단일 행을 반환하는 샘플 쿼리입니다. 지정된 기간 내:

SELECT clicks
FROM ProductPerformanceView
WHERE date BETWEEN '2020-12-01' AND '2020-12-21'

반환받을 데이터를 지정해야 합니다. 와일드 카드 (예: SELECT *)는 오류를 반환합니다.

다음 샘플 응답은 판매자가 총 4,440개의 12월 1일 사이에 모든 제품, 모든 마케팅 방법의 클릭수 2020년 12월 21일까지입니다.

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

세그먼트

MCQL을 사용하여 세그먼트 필드를 쿼리할 수 있습니다. 세그먼트 필드는 제품 속성 (예: offerId, brand, category) 또는 이벤트 속성 (예: date 및 marketingMethod)

세그먼트 필드는 SQL의 GROUP BY와 유사하게 작동합니다. 세그먼트 필드에서는 선택된 측정항목(SELECT 절에서 각 세그먼트별로 그룹화)

다음은 일일 클릭수를 기간의 추가된 조건 내 clicks 다음 값 이상의 행만 요청된 측정항목 1개가 0이 아닌 경우 반환됩니다.

SELECT
  date,
  clicks
FROM ProductPerformanceView
WHERE date BETWEEN '2020-12-01' AND '2020-12-03'
ORDER BY clicks DESC

다음 샘플 응답은 판매자 사이트에서 1,546회의 클릭이 발생했으며 2020년 12월 1일부터 모든 마케팅 방법의 모든 제품 2020년 12월 2일 기준으로 모든 마케팅 방법에 걸친 전 제품의 클릭수 판매자가 2020년 12월 3일에 클릭이 없었으므로 해당 날짜입니다.

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