Content API for Shopping에서 보고서 이전

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

Merchant Reports API를 사용하여 다음을 수행할 수 있습니다.

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

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

요청

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의 가격 정보 뷰에서 변경된 사항입니다.

가격 경쟁력

다음은 Merchant Reports API의 가격 경쟁력 뷰에서 변경된 사항입니다.

베스트셀러

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

노출 경쟁

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