Content API for Shopping에서 보고서 이전

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

요청

판매자 보고서 API에 대해 다음 요청 URL 형식을 사용합니다.

POST https://merchantapi.googleapis.com/reports/v1beta/{parent}/reports:search

다음은 search 요청에 대한 Content API for Shopping과 Merchant Reports API를 비교한 예시입니다.

Content API 판매자 API
URL https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/reports/search https://merchantapi.googleapis.com/reports/v1beta/{parent}/reports:search
식별자 {merchantId} {parent}

방법

ReportService.Search 메서드를 호출하여 판매자 보고서 API를 쿼리할 수 있습니다.

뷰

Merchant API에서 테이블 이름이 CammelCase에서 snake_case로 변경됩니다.

MerchantPerformanceView는 이제 product_performance_view입니다.

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

Content API 판매자 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

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

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

Content API 판매자 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 판매자 API 
{
  "segments":{
    "offerId":"abc"
  },
  "metrics":{
    "clicks":"123"
  }
}

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

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

성능

판매자 보고서 API의 실적 보기와 관련하여 변경된 사항은 다음과 같습니다.

Content API 판매자 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,
… 		지원되지 않음 판매자 보고서 API에서는 Buy on Google 측정항목이 지원되지 않습니다.

새 마케팅 방법 값

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

Content API 판매자 API
SHOPPING_ADS ADS
FREE_PRODUCT_LISTING ORGANIC
FREE_LOCAL_PRODUCT_LISTING ORGANIC
BUY_ON_GOOGLE_LISTING 지원되지 않음

제품

판매자 보고서 API의 제품 보기와 관련하여 변경된 사항은 다음과 같습니다.

Content API 판매자 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 필드가 도입되었습니다.

가격 정보

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

Content API 판매자 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: 정수
priceInsights.predictedMonthlyGrossProfitChangeCurrencyCode: 문자열 		지원되지 않음 Merchant Reports API에서는 총이익 변화와 관련된 필드가 지원되지 않습니다.

가격 경쟁력

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

Content API 판매자 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 유형의 하나의 필드로 병합됩니다.

베스트셀러

판매자 보고서 API의 베스트셀러 보기와 관련하여 변경된 사항은 다음과 같습니다.

Content API 판매자 API 설명
bestSellers.countryCode: 문자열 reportCountryCode: 문자열 countryCode 필드 이름이 reportCountryCode로 변경됨
bestSellers.categoryId: 정수 reportCategoryId: 정수 categoryId 필드 이름이 reportCategoryId로 변경됨

노출 경쟁

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

Content API 판매자 API 설명
competitiveVisibility.countryCode: 문자열 reportCountryCode: 문자열 countryCode 필드 이름이 reportCountryCode로 변경됨
competitiveVisibility.categoryId: 정수 reportCategoryId: 정수 categoryId 필드 이름이 reportCategoryId로 변경됨

이전
전환 소스 관리 이전
다음
오프라인 제품 피드 파트너 관리 이전