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의 비교 샘플입니다.

Content API Merchant API
URL https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/reports/search https://merchantapi.googleapis.com/reports/v1/{PARENT}/reports:search
식별자 {MERCHANT_ID} {PARENT}

메서드

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

조회수

판매자 API에서 표 이름이 CamelCase에서 snake_case로 변경됩니다.

MerchantPerformanceView는 이제 product_performance_view입니다.

Content API for Shopping과 Merchant API의 표 이름 간 매핑은 다음과 같습니다.

Content API Merchant API
MerchantPerformanceView product_performance_view
ProductView product_view
PriceCompetitivenesProductView price_competitiveness_product_view
PriceInsightsProductView price_insights_product_view
BestSellersBrandView best_sellers_brand_view
BestSellersProductClusterView best_sellers_product_cluster_view
CompetitiveVisibilityCompetitorView competitive_visibility_competitor_view
CompetitiveVisibilityTopMerchantView competitive_visibility_top_merchant_view
CompetitiveVisibilityBenchmarkView competitive_visibility_benchmark_view

Merchant API에서는 필드 접두사(예: segments.offer_id)를 더 이상 지정하지 않아도 됩니다. 대신 필드 이름인 offer_id만 사용하세요.

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

Content API 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

다음은 샘플 응답입니다.

Content API Merchant API 
{
  "segments":{
    "offerId":"abc"
  },
  "metrics":{
    "clicks":"123"
  }
}
 
{
  "productPerformanceView" : {
    "offerId": "abc",
    "clicks": "123"
  }
}

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

성능

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

Content API Merchant API 설명
segments.program: 문자열 marketing_method: 문자열 program 세그먼트가 새로운 marketing_method 필드로 대체됩니다. 자세한 내용은 새 marketing method 값을 참고하세요.
metrics.ctr: double clickThroughRate: double ctr 측정항목의 이름이 clickThroughRate로 변경되었습니다.
metrics.conversionValueMicros: 정수
segments.currencyCode: 문자열 		conversionValue: {
object (Price)
} 		금액 마이크로 및 통화 필드가 Price 유형의 하나의 필드로 병합됩니다.
metrics.orders,
metrics.orderedItems,
… 		지원되지 않음 Buy On Google 측정항목은 Merchant Reports API에서 지원되지 않습니다.

새 마케팅 방법 값

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

Content API Merchant API
SHOPPING_ADS ADS
FREE_PRODUCT_LISTING ORGANIC
FREE_LOCAL_PRODUCT_LISTING ORGANIC
BUY_ON_GOOGLE_LISTING 지원되지 않음

제품

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

Content API Merchant API 설명
productView.id: 문자열 id: 문자열 필드 형식이 channel:language:targetCountry:offerId에서
channel~language~feedLabel~offerId로 변경됩니다.
productView.priceMicros: 정수
productView.currencyCode: 문자열 		price: {
object (Price)
} 		금액 마이크로 및 통화 필드가 Price 유형의 하나의 필드로 병합됩니다.
productView.aggregated_destination_status: 문자열 aggregated_reporting_context_status: 문자열 aggregated_destination_status 필드의 이름이 aggregated_reporting_context_status으로 변경되었으며 값은 변경되지 않았습니다.
productView.item_issues: [
{
object (ItemIssue)
}
] 		item_issues: [
{
object (ItemIssue)
}
] 		ItemIssue 정의가 변경됨
지원되지 않음 feedLabel: 문자열 feedLabel 필드 도입

가격 정보

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

Content API Merchant API 설명
productView.id: 문자열 id: 문자열 필드 형식이 channel:language:targetCountry:offerId에서 channel~language~feedLabel~offerId로 변경됩니다.
productView.priceMicros: 정수
productView.currencyCode: 문자열 		price: {
object (Price)
} 		금액 마이크로 및 통화 필드가 Price 유형의 하나의 필드로 병합됩니다.
priceInsights.suggestedPriceMicros: 정수
priceInsights.suggestedPriceCurrencyCode: 문자열 		suggestedPrice: {
object (Price)
} 		금액 마이크로 및 통화 필드가 Price 유형의 하나의 필드로 병합됩니다.
priceInsights.predictedGrossProfitChangeFraction: double
priceInsights.predictedMonthlyGrossProfitChangeMicros: integer
priceInsights.predictedMonthlyGrossProfitChangeCurrencyCode: string 		지원되지 않음 총이익 변경과 관련된 필드는 Merchant Reports API에서 지원되지 않습니다.

가격 경쟁력

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

Content API Merchant API 설명
productView.id: 문자열 id: 문자열 필드 형식이 channel:language:targetCountry:offerId에서 channel~language~feedLabel~offerId로 변경됩니다.
productView.priceMicros: 정수
productView.currencyCode: 문자열 		price: {
object (Price)
} 		금액 마이크로 및 통화 필드가 Price 유형의 하나의 필드로 병합됩니다.
priceCompetitiveness.countryCode: 문자열 reportCountryCode: 문자열 countryCode 필드의 이름이 reportCountryCode로 변경됩니다.
priceCompetitiveness.benchmarkPriceMicros: 정수
priceCompetitiveness.benchmarkPriceCurrencyCode: 문자열 		benchmarkPrice: {
object (Price)
} 		금액 마이크로 및 통화 필드가 Price 유형의 하나의 필드로 병합됩니다.

베스트셀러

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

Content API Merchant API 설명
bestSellers.countryCode: 문자열 reportCountryCode: 문자열 countryCode 필드의 이름이 reportCountryCode로 변경됩니다.
bestSellers.categoryId: int reportCategoryId: int categoryId 필드의 이름이 reportCategoryId로 변경됩니다.

노출 경쟁

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

Content API Merchant API 설명
competitiveVisibility.countryCode: 문자열 reportCountryCode: 문자열 countryCode 필드의 이름이 reportCountryCode로 변경됩니다.
competitiveVisibility.categoryId: 정수 reportCategoryId: 정수 categoryId 필드의 이름이 reportCategoryId로 변경됩니다.

이전
Migrate conversion sources management
다음
Migrate local feeds partnership management