Performance reports

Merchant API는 product_performance_view과 같은 실적 보고서를 제공합니다. 이 페이지에서는 실적 보고서의 구조를 설명합니다.

측정항목

반환할 측정항목 (예: clicks 및 impressions)을 쿼리할 수 있습니다. 실적 데이터를 쿼리하려면 기간에 필터를 추가해야 합니다.

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

SELECT clicks
FROM product_performance_view
WHERE date BETWEEN '2023-12-01' AND '2023-12-21'

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

다음 샘플 응답은 2023년 12월 1일부터 2023년 12월 21일까지 모든 제품, 모든 마케팅 방법에서 총 4,440회의 클릭이 발생했음을 보여줍니다.

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

세그먼트

실적 보고서에서 분류를 위해 세그먼트 필드를 사용할 수 있습니다. 예를 들어 marketing_method를 쿼리하면 각 마케팅 방법의 행과 SELECT 절에서 해당 마케팅 방법에 대해 지정한 측정항목이 포함된 보고서가 반환됩니다.

세그먼트 필드는 제품 속성 (예: offer_id, brand, category) 또는 이벤트 속성 (예: date, marketing_method)일 수 있습니다.

세그먼트 필드는 SQL의 GROUP BY와 유사하게 작동합니다. 세그먼트 필드는 선택한 측정항목을 분할하여 SELECT 절의 각 세그먼트별로 그룹화합니다.

다음은 날짜 범위의 추가된 조건 내에서 clicks별로 내림차순으로 일별 클릭수를 반환하는 샘플 쿼리입니다. 요청된 측정항목 중 하나 이상이 0이 아닌 행만 반환됩니다.

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

다음 샘플 응답은 2023년 12월 1일에 판매자가 모든 제품, 모든 마케팅 방법에서 1,546회의 클릭을 기록했고 2023년 12월 2일에 모든 제품, 모든 마케팅 방법에서 829회의 클릭을 기록했음을 보여줍니다. 판매자는 2023년 12월 3일에 클릭이 없었으므로 해당 날짜에 반환되는 항목이 없습니다.

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

판매자 센터의 맞춤 보고서와 마찬가지로 판매자 보고서 API를 사용하면 동일한 쿼리에서 여러 세그먼트를 지정할 수 있습니다.

다음은 30일 동안 계정의 모든 제품에 대한 클릭수를 marketing_method 및 offer_id로 분류하여 반환하는 샘플 쿼리입니다.

SELECT marketing_method, offer_id, clicks
FROM product_performance_view
WHERE date BETWEEN '2023-11-01' AND '2023-11-30'

이 쿼리의 응답에는 offer_id 및 marketing_method의 각 조합에 대한 행이 해당 조합의 클릭수와 함께 포함됩니다.

{
  "results": [
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12345",
        "clicks": "38"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12346",
        "clicks": "125"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ORGANIC",
        "offerId": "12346",
        "clicks": "23"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12347",
        "clicks": "8"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ORGANIC",
        "offerId": "12347",
        "clicks": "3"
      }
    }
  ]
}

카테고리 및 제품 유형

판매자 센터 쿼리 언어는 인벤토리를 구성하기 위해 정의할 수 있는 두 그룹의 속성별로 측정항목을 분류하는 기능을 지원합니다.

카테고리 수준
Google 제품 분류의 카테고리입니다. 카테고리가 제공되지 않은 경우 Google에서 제품에 카테고리를 자동 할당하거나 제공된 카테고리를 추가로 세분화할 수 있습니다.
제품 유형 수준
카테고리 지정을 기준으로 할당하는 제품 유형입니다. 카테고리 수준과 달리 지원되는 값의 사전 정의된 집합은 없습니다.

카테고리 및 제품 유형 속성은 모두 여러 수준의 계층 구조로 구성됩니다. 제품 사양은 각 수준을 > 문자로 구분하지만 보고서에서는 계층 구조의 각 수준을 별도로 선택합니다.

예를 들어 다음과 같은 제품 유형 수준이 있는 제품을 생각해 보겠습니다.

Home & Garden > Kitchen & Dining > Kitchen Appliances > Refrigerators

보고서는 각 수준을 자체 필드에 반환합니다.

세그먼트 값
product_type_l1 Home & Garden
product_type_l2 Kitchen & Dining
product_type_l3 Kitchen Appliances
product_type_l4 Refrigerators

통화 및 가격 측정항목

conversion_value와 같은 가격 측정항목은 Price 유형을 사용하여 표시됩니다. 측정항목을 여러 통화로 사용할 수 있는 경우 각 통화의 값이 별도의 행에 반환됩니다. 예를 들면 다음 쿼리와 같습니다.

SELECT conversion_value
FROM product_performance_view
WHERE date = '2023-11-01'

다음 결과를 반환합니다.

{
  "results": [
    {
      "productPerformanceView": {
        "conversionValue": {
          "amountMicros": "150000000",
          "currencyCode": "USD"
        }
      }
    },
    {
      "productPerformanceView": {
        "conversionValue": {
          "amountMicros": "70000000",
          "currencyCode": "CAD"
        }
      }
    }
  ]
}

쿼리에서 가격 측정항목과 비가격 측정항목을 모두 요청하면 가격 측정항목은 비가격 측정항목과 별도의 결과 행에 반환되며, 통화 코드당 하나의 결과 행이 반환됩니다. 예를 들면 다음 쿼리와 같습니다.

SELECT conversions, conversion_value
FROM product_performance_view
WHERE date = '2020-11-01'

다음과 같은 응답을 반환합니다.

{
  "results": [
    {
      "productPerformanceView": {
        "conversions": "27",
        "conversionValue": {
          "amountMicros": "0",
          "currencyCode": ""
        }
      }
    },
    {
      "productPerformanceView": {
        "conversions": "0",
        "conversionValue": {
          "amountMicros": "150000000",
          "currencyCode": "USD"
        }
      }
    },
    {
      "productPerformanceView": {
        "conversions": "0",
        "conversionValue": {
          "amountMicros": "70000000",
          "currencyCode": "CAD"
        }
      }
    }
  ]
}

값이 기본값 또는 0인 경우에도 선택한 모든 필드가 응답에 반환됩니다.

쿼리에 사용할 수 있는 필드에 대한 자세한 내용은 productPerformanceView 테이블의 필드를 참고하세요.