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와 유사하게 작동합니다. Segments 필드는 선택한 측정항목을 분할하여 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일 클릭수가 0이므로 이 날짜에 대해 반환되는 항목이 없습니다.

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

판매자 센터의 맞춤 보고서와 마찬가지로 Merchant Reports 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"
        }
      }
    }
  ]
}

쿼리에서 가격 및 비가격 측정항목을 모두 요청하면 가격 측정항목은 비가격 측정항목과 별도의 결과 행(통화 코드당 결과 행 1개)으로 반환됩니다. 예를 들면 다음 쿼리와 같습니다.

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이더라도 선택한 모든 필드는 응답에 반환됩니다.