Content API for Shopping에서 보고서 이전

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

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

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

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

요청

판매자 보고서 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를 쿼리할 수 있습니다.

조회수

판매자 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"
  }
}

표 이름을 필드 접두사로 사용할 수 있습니다. 예를 들어 offer_id와 product_performance_view.offer_id은 모두 Merchant API 쿼리에서 허용됩니다.

성능

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

새 마케팅 방법 값

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

제품

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

가격 정보

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

가격 경쟁력

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

베스트셀러

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

노출 경쟁

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