Memigrasikan pelaporan dari Content API for Shopping

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

Permintaan

Gunakan format URL permintaan berikut untuk Merchant Reports API:

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

Berikut adalah 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/v1beta/{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 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 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 adalah 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 adalah 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: ganda clickThroughRate: ganda Metrik ctr diganti namanya menjadi clickThroughRate
metrics.conversionValueMicros: bilangan bulat
segments.currencyCode: string 		conversionValue: {
object (Price)
} 		Kolom mata uang dan mikro jumlah 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 Merchant API
SHOPPING_ADS ADS
FREE_PRODUCT_LISTING ORGANIC
FREE_LOCAL_PRODUCT_LISTING ORGANIC
BUY_ON_GOOGLE_LISTING Tidak didukung

Produk

Berikut ini perubahan yang dilakukan 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: bilangan bulat
productView.currencyCode: string 		price: {
object (Price)
} 		Kolom mata uang dan mikro jumlah 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 belum 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 Merchant API 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 mata uang dan mikro jumlah digabungkan menjadi satu kolom dengan jenis Price
priceInsights.suggestedPriceMicros: bilangan bulat
priceInsights.suggestedPriceCurrencyCode: string 		suggestedPrice: {
object (Price)
} 		Kolom mata uang dan mikro jumlah 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

Daya Saing Harga

Berikut yang berubah 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: bilangan bulat
productView.currencyCode: string 		price: {
object (Price)
} 		Kolom mata uang dan mikro jumlah 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 mata uang dan mikro jumlah digabungkan menjadi satu kolom dengan jenis Price

Terlaris

Berikut perubahan yang dilakukan 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 ini perubahan yang dilakukan 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: bilangan bulat reportCategoryId: bilangan bulat Kolom categoryId diganti namanya menjadi reportCategoryId

Sebelumnya
Memigrasikan pengelolaan sumber konversi
Berikutnya
Memigrasikan pengelolaan kemitraan feed lokal