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 ditawarkan.

Anda dapat menggunakan Merchant Reports API untuk melakukan hal berikut:

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

Berikut cara mengintegrasikan Merchant Reports API dengan implementasi Content API for Shopping yang 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
ID {MERCHANT_ID} {PARENT}

Metode

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

Penayangan

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

MerchantPerformanceView kini 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, menentukan 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 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 untuk tampilan performa di Merchant Reports API:

Content API Merchant API Deskripsi
segments.program: string marketing_method: string Segmen program diganti dengan kolom marketing_method baru. Lihat Nilai marketing method baru untuk mengetahui detailnya.
metrics.ctr: double clickThroughRate: double 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 untuk 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 untuk tampilan info 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

Daya Saing Harga

Berikut perubahan untuk tampilan daya saing 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 untuk tampilan produk 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 untuk 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: integer reportCategoryId: integer Kolom categoryId diganti namanya menjadi reportCategoryId

Sebelumnya
Migrate conversion sources management
Berikutnya
Migrate local feeds partnership management