Content API for Shopping에서 보고서 이전

Merchant Reports API를 사용하면 제공되는 데이터 보기를 통해 Google에서 제품, 제품 실적, 경쟁 환경에 대해 알아볼 수 있습니다.

판매자 보고서 API를 사용하여 다음을 수행할 수 있습니다.

• 제품 실적 측정: Merchant API에서 MerchantPerformanceView가 이제 product_performance_view입니다.
• 특정 필드로 제품 필터링: Merchant API를 사용하면 item_issues를 제외한 모든 사용 가능한 필드를 기준으로 필터링할 수 있습니다.
• 제품 가격 책정 개선: Merchant API를 사용하면 금액(마이크로) 및 통화 필드가 Price 유형의 하나의 필드로 병합됩니다.
• 시장 이해: Merchant API를 사용하면 가장 많이 판매되는 제품 및 브랜드, 경쟁력 있는 가격대, 할인가 추천, 업계의 경쟁 환경에 관한 정보를 얻을 수 있습니다.
• 경쟁 현황 살펴보기: 보고서를 통해 제품 카테고리 수준에서 경쟁 현황을 파악하고 노출 가능성을 높이기 위한 조치를 취할 수 있습니다.

Merchant Reports API를 기존 Content API for Shopping 구현과 통합하는 방법은 다음과 같습니다.

요청

Merchant Reports API에 다음 요청 URL 형식을 사용합니다.

POST https://merchantapi.googleapis.com/reports/v1/{PARENT}/reports:search

다음은 search 요청에 대한 Content API for Shopping과 Merchant Reports API의 비교 샘플입니다.

메서드

ReportService.Search 메서드를 호출하여 Merchant Reports API를 쿼리할 수 있습니다.

조회수

Merchant API에서 테이블 이름이 CamelCase에서 snake_case(으)로 변경됩니다.

MerchantPerformanceView는 이제 product_performance_view입니다.

다음은 Content API for Shopping과 Merchant API의 테이블 이름 간 매핑입니다.

Merchant API에서는 더 이상 필드 프리픽스(예: segments.offer_id)를 지정할 필요가 없습니다. 대신 필드 이름인 offer_id를 사용하세요.

다음은 Content API for Shopping과 Merchant API의 쿼리를 비교한 샘플입니다.

   SELECT
     segments.offer_id,
     metrics.clicks
   FROM MerchantPerformanceView
   WHERE segments.date DURING LAST_7_DAYS
   

   SELECT
     offer_id,
     clicks
   FROM product_performance_view
   WHERE date DURING LAST_7_DAYS
   

다음은 샘플 응답입니다.

{
  "segments":{
    "offerId":"abc"
  },
  "metrics":{
    "clicks":"123"
  }
}

{
  "productPerformanceView" : {
    "offerId": "abc",
    "clicks": "123"
  }
}

테이블 이름을 필드 프리픽스로 사용할 수 있습니다. 예를 들어 Merchant API 쿼리에서는 offer_id와 product_performance_view.offer_id가 모두 허용됩니다.

성능

Merchant Reports API의 실적 뷰에서 변경된 사항은 다음과 같습니다.

새 마케팅 방법 값

segments.program 값과 marketing_method 값 간의 매핑은 다음과 같습니다.

제품

Merchant Reports API의 제품 뷰에서 변경된 사항은 다음과 같습니다.

가격 정보

Merchant Reports API의 가격 정보 보기에 변경된 사항은 다음과 같습니다.

가격 경쟁력

판매자 보고서 API의 가격 경쟁력 뷰에서 변경된 사항은 다음과 같습니다.

베스트셀러

Merchant Reports API의 베스트셀러 뷰에서 변경된 사항은 다음과 같습니다.

노출 경쟁

Merchant Reports API의 노출 경쟁 뷰에서 변경된 사항은 다음과 같습니다.