Memigrasikan pelaporan dari Content API for Shopping

Anda dapat menggunakan Merchant Reports API untuk mempelajari produk Anda, performanya, dan lingkungan kompetitifnya di Google melalui tampilan data yang ditawarkannya.

Anda dapat menggunakan Merchant Reports API untuk melakukan hal berikut:

  • Mengukur performa produk Anda: Di Merchant API, MerchantPerformanceView kini menjadi product_performance_view.
  • Memfilter produk menurut kolom tertentu: Dengan Merchant API, Anda dapat memfilter berdasarkan semua kolom yang tersedia, kecuali item_issues.
  • Meningkatkan kualitas harga produk: Dengan Merchant API, kolom jumlah mikro dan mata uang digabungkan menjadi satu kolom dengan jenis Price.
  • Memahami pasar: Dengan Merchant API, Anda bisa mendapatkan data tentang produk dan merek terlaris, titik harga yang kompetitif, saran harga promo, dan informasi tentang lanskap kompetitif untuk industri Anda.
  • Pelajari lanskap kompetitif Anda: Anda bisa mendapatkan laporan untuk memahami lanskap kompetitif di tingkat kategori produk dan mengambil tindakan untuk meningkatkan visibilitas.

Berikut cara mengintegrasikan Merchant Reports API dengan penerapan Content API for Shopping yang sudah ada.

Permintaan

Gunakan format URL permintaan berikut untuk Merchant Reports API:

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

Berikut contoh perbandingan Content API for Shopping dengan Merchant Reports API untuk permintaan search:

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
Pengenal {MERCHANT_ID} {PARENT}

Metode

Anda dapat membuat kueri Merchant Reports API dengan memanggil metode ReportService.Search.

Penayangan

Di Merchant API, nama tabel diubah dari CamelCase menjadi snake_case.

MerchantPerformanceView sekarang menjadi product_performance_view.

Berikut pemetaan antara nama tabel di Content API for Shopping dan 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

Di Merchant API, penentuan awalan kolom, misalnya, segments.offer_id tidak lagi diperlukan. Sebagai gantinya, cukup gunakan nama kolom, offer_id.

Berikut contoh perbandingan kueri di Content API for Shopping dan 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

Berikut adalah contoh respons:

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

Nama tabel dapat digunakan sebagai awalan kolom. Misalnya, offer_id dan product_performance_view.offer_id diterima dalam kueri Merchant API.

Performa

Berikut perubahan yang dilakukan pada tampilan performa di Merchant Reports API:

Content API Merchant API Deskripsi
segments.program: string marketing_method: string Segmen program digantikan oleh kolom marketing_method baru. Lihat Nilai marketing method baru untuk mengetahui detailnya.
metrics.ctr: ganda clickThroughRate: ganda Metrik ctr diganti namanya menjadi clickThroughRate
metrics.conversionValueMicros: integer
segments.currencyCode: string 		conversionValue: {
object (Price)
} 		Kolom mikro jumlah dan mata uang digabungkan menjadi satu kolom dengan jenis Price
metrics.orders,
metrics.orderedItems,
… 		Tidak didukung Metrik Beli dengan Google tidak didukung di Merchant Reports API

Nilai metode pemasaran baru

Berikut pemetaan antara nilai segments.program dan marketing_method:

Content API Merchant API
SHOPPING_ADS ADS
FREE_PRODUCT_LISTING ORGANIC
FREE_LOCAL_PRODUCT_LISTING ORGANIC
BUY_ON_GOOGLE_LISTING Tidak didukung

Produk

Berikut perubahan yang terjadi pada tampilan produk di Merchant Reports API:

Content API Merchant API Deskripsi
productView.id: string id: string Format kolom berubah dari channel:language:targetCountry:offerId menjadi
channel~language~feedLabel~offerId
productView.priceMicros: integer
productView.currencyCode: string 		price: {
object (Price)
} 		Kolom mikro jumlah dan mata uang digabungkan menjadi satu kolom dengan jenis Price
productView.aggregated_destination_status: string aggregated_reporting_context_status: string Kolom aggregated_destination_status diganti namanya menjadi aggregated_reporting_context_status, nilainya tidak berubah
productView.item_issues: [
{
object (ItemIssue)
}
] 		item_issues: [
{
object (ItemIssue)
}
] 		Definisi ItemIssue telah berubah
Tidak didukung feedLabel: string Kolom feedLabel diperkenalkan

Info Harga

Berikut perubahan yang terjadi pada tampilan analisis harga di Merchant Reports API:

Content API Merchant API Deskripsi
productView.id: string id: string Format kolom berubah dari channel:language:targetCountry:offerId menjadi channel~language~feedLabel~offerId
productView.priceMicros: integer
productView.currencyCode: string 		price: {
object (Price)
} 		Kolom mikro jumlah dan mata uang digabungkan menjadi satu kolom dengan jenis Price
priceInsights.suggestedPriceMicros: integer
priceInsights.suggestedPriceCurrencyCode: string 		suggestedPrice: {
object (Price)
} 		Kolom mikro jumlah dan mata uang digabungkan menjadi satu kolom dengan jenis Price
priceInsights.predictedGrossProfitChangeFraction: double
priceInsights.predictedMonthlyGrossProfitChangeMicros: integer
priceInsights.predictedMonthlyGrossProfitChangeCurrencyCode: string 		Tidak didukung Kolom yang terkait dengan perubahan laba kotor tidak didukung di Merchant Reports API

Persaingan Harga

Berikut perubahan pada tampilan persaingan harga di Merchant Reports API:

Content API Merchant API Deskripsi
productView.id: string id: string Format kolom berubah dari channel:language:targetCountry:offerId menjadi channel~language~feedLabel~offerId
productView.priceMicros: integer
productView.currencyCode: string 		price: {
object (Price)
} 		Kolom mikro jumlah dan mata uang digabungkan menjadi satu kolom dengan jenis Price
priceCompetitiveness.countryCode: string reportCountryCode: string Kolom countryCode diganti namanya menjadi reportCountryCode
priceCompetitiveness.benchmarkPriceMicros: integer
priceCompetitiveness.benchmarkPriceCurrencyCode: string 		benchmarkPrice: {
object (Price)
} 		Kolom mikro jumlah dan mata uang digabungkan menjadi satu kolom dengan jenis Price

Terlaris

Berikut perubahan yang dilakukan pada tampilan item terlaris di Merchant Reports API:

Content API Merchant API Deskripsi
bestSellers.countryCode: string reportCountryCode: string Kolom countryCode diganti namanya menjadi reportCountryCode
bestSellers.categoryId: int reportCategoryId: int Kolom categoryId diganti namanya menjadi reportCategoryId

Visibilitas kompetitif

Berikut perubahan yang terjadi pada tampilan visibilitas kompetitif di Merchant Reports API:

Content API Merchant API Deskripsi
competitiveVisibility.countryCode: string reportCountryCode: string Kolom countryCode diganti namanya menjadi reportCountryCode
competitiveVisibility.categoryId: bilangan bulat reportCategoryId: bilangan bulat Kolom categoryId diganti namanya menjadi reportCategoryId

Sebelumnya
Migrate conversion sources management
Berikutnya
Migrate local feeds partnership management