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

제품 평가

Merchant Reports API를 사용하여 실적 데이터를 확인하고, 특정 속성별로 제품을 필터링하고, 가격을 개선할 수 있습니다.

성능 측정

Merchant Reports API product_performance_view를 사용하여 계정의 실적 측정항목을 검색할 수 있습니다.

요구사항

이 보고서를 검색하려면 실적 및 통계 역할이 있어야 합니다.

기존 사용자에게 실적 및 통계 역할을 할당하려면 패치 요청을 만들고 사용자에게 PERFORMANCE_REPORTING 액세스 권한을 할당합니다. 다음 요청은 PERFORMANCE_REPORTING 액세스 권한을 할당하기 위한 패치 요청을 만드는 방법을 보여줍니다.

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/users/{EMAIL_ID}

{
  "accessRights": [
    "PERFORMANCE_REPORTING"
  ]
}

다음을 바꿉니다.

{ACCOUNT_ID}: 판매자 센터 계정의 고유 식별자입니다.
{EMAIL_ID}: 역할을 할당할 사용자의 이메일 주소입니다.

샘플 쿼리

다음 쿼리는 특정 30일 동안 계정의 모든 제품에 대한 impressions, clicks, click_through_rate를 검색합니다. 요청하려면 다음 판매자 센터 쿼리 언어 문을 accounts.reports.search 메서드에 전달합니다.

SELECT impressions, clicks, click_through_rate
FROM product_performance_view
WHERE date BETWEEN '2020-12-01' AND '2020-12-30'

실적 보고서에 대한 자세한 내용은 실적 보고서 가이드를 참고하세요.

제품 필터링

Merchant Reports API의 product_view를 사용하여 제품 상태를 비롯하여 제품 데이터의 필터링된 보기를 표시할 수 있습니다. 예를 들어 product_view를 쿼리하여 문제가 있는 제품을 나열하거나 새 제품 목록을 가져와 게재를 확인할 수 있습니다.

쿼리의 SELECT 절에 id 필드를 포함해야 합니다. id는 제품의 REST ID와 동일한 값을 갖습니다.

item_issues를 제외한 모든 사용 가능한 필드를 기준으로 필터링할 수 있습니다. 다음을 제외한 사용 가능한 모든 필드를 기준으로 응답을 정렬할 수 있습니다.

gtin
item_issues

다음은 NOT_ELIGIBLE_OR_DISAPPROVED 상태로 제품을 반환하는 예입니다. 요청하려면 다음 판매자 센터 쿼리 언어 문을 accounts.reports.search 메서드에 전달합니다.

SELECT
  id,
  offer_id,
  feed_label,
  title,
  aggregated_reporting_context_status,
  item_issues
FROM product_view
WHERE aggregated_reporting_context_status = 'NOT_ELIGIBLE_OR_DISAPPROVED'

다음은 위 쿼리의 샘플 응답입니다.

{
  "results": [
    {
      "productView": {
        "id": "en~US~id0",
        "offerId": "id0",
        "feedLabel": "US",
        "aggregatedReportingContextStatus": "NOT_ELIGIBLE_OR_DISAPPROVED",
        "itemIssues": [
          {
            "type": {
              "code": "invalid_string_value",
              "canonicalAttribute": "n:product_code"
            },
            "severity": {
              "severityPerReportingContext": [
                {
                  "reportingContext": "SHOPPING_ADS",
                  "disapprovedCountries": [
                    "US"
                  ]
                },
                {
                  "reportingContext": "FREE_LISTINGS",
                  "disapprovedCountries": [
                    "US"
                  ]
                }
              ],
              "aggregatedSeverity": "DISAPPROVED"
            },
            "resolution": "MERCHANT_ACTION"
          },
          {
            "type": {
              "code": "apparel_missing_brand",
              "canonicalAttribute": "n:brand"
            },
            "severity": {
              "severityPerReportingContext": [
                {
                  "reportingContext": "SHOPPING_ADS",
                  "disapprovedCountries": [
                    "US"
                  ]
                }
              ],
              "aggregatedSeverity": "DEMOTED"
            },
            "resolution": "MERCHANT_ACTION"
          }
        ]
      }
    }
  ]
}

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

가격 책정 개선

가격 정보 보기를 사용하여 제품의 추천 할인가와 제품 가격을 업데이트할 때 예상되는 실적 예측을 확인할 수 있습니다. 가격 정보 보고서를 사용하면 제품의 가격을 더욱 효과적으로 책정할 수 있습니다.

자세한 내용은 가격 정보 보고서로 제품 가격 책정 개선을 참고하세요.

price_insights_product_view를 쿼리하여 제품의 추천 할인가를 확인하세요.

다음은 제품의 추천 할인가를 확인하는 데 사용할 수 있는 샘플입니다. 요청하려면 다음 Merchant Center 쿼리 언어 문을 accounts.reports.search 메서드에 전달합니다.

SELECT
  id,
  title,
  brand,
  price,
  suggested_price,
  predicted_impressions_change_fraction,
  predicted_clicks_change_fraction,
  predicted_conversion_change_fraction
FROM price_insights_product_view