Memigrasikan pelaporan dari Content API for Shopping

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

Permintaan

Gunakan format URL permintaan berikut untuk Merchant Reports API:

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

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

Content API API Penjual
URL https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/reports/search https://merchantapi.googleapis.com/reports/v1beta/{parent}/reports:search
ID {merchantId} {parent}

Metode

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

View

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

MerchantPerformanceView sekarang menjadi product_performance_view.

Berikut adalah pemetaan antara nama tabel di Content API for Shopping dan Merchant API:

Content API API Penjual
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 adalah contoh perbandingan kueri di Content API for Shopping dan Merchant API:

Content API API Penjual 
   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 API Penjual 
{
  "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 yang berubah untuk tampilan performa di Merchant Reports API:

Content API API Penjual 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: ganda clickThroughRate: ganda Metrik ctr diganti namanya menjadi clickThroughRate
metrics.conversionValueMicros: bilangan bulat
segments.currencyCode: string 		conversionValue: {
object (Price)
} 		Kolom jumlah mikro 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 adalah pemetaan antara nilai segments.program dan marketing_method:

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

Produk

Berikut yang berubah untuk tampilan produk di Merchant Reports API:

Content API API Penjual Deskripsi
productView.id: string id: string Format kolom berubah dari channel:language:targetCountry:offerId menjadi
channel~language~feedLabel~offerId
productView.priceMicros: bilangan bulat
productView.currencyCode: string 		price: {
object (Price)
} 		Kolom jumlah mikro 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 yang berubah untuk tampilan analisis harga di Merchant Reports API:

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

Persaingan Harga

Berikut yang berubah untuk tampilan persaingan harga di Merchant Reports API:

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

Terlaris

Berikut ini perubahan untuk tampilan terlaris di Merchant Reports API:

Content API API Penjual 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 yang berubah untuk tampilan visibilitas kompetitif di Merchant Reports API:

Content API API Penjual 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
Memigrasikan pengelolaan sumber konversi
Berikutnya
Memigrasikan pengelolaan kemitraan feed lokal