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": "4440"
      }
    }
  ]
}

세그먼트

실적 보고서에서 실적 보고서의 세분화에 세그먼트 필드를 사용할 수 있습니다. 예를 들어 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"
      }
    }
  ]
}

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

카테고리 및 제품 유형

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

카테고리 수준
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