Content API for Shopping'den raporları taşıma

Merchant Reports API'yi kullanarak sunduğu veri görünümü aracılığıyla ürünleriniz, performansları ve Google'daki rekabet ortamları hakkında bilgi edinebilirsiniz.

Aşağıdakileri yapmak için Merchant Reports API'yi kullanabilirsiniz:

Merchant Reports API'yi mevcut Content API for Shopping uygulamanıza nasıl entegre edebileceğinizi aşağıda bulabilirsiniz.

İstekler

Merchant Reports API için aşağıdaki istek URL'si biçimini kullanın:

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

search istekleri için Content API for Shopping ile Merchant Reports API'nin karşılaştırmasına dair bir örnek aşağıda verilmiştir:

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
Tanımlayıcılar {MERCHANT_ID} {PARENT}

Yöntemler

ReportService.Search yöntemini çağırarak Merchant Reports API'yi sorgulayabilirsiniz.

Görüntüleme sayısı

Merchant API'de tablo adları CamelCase olarak değiştirildi.snake_case

MerchantPerformanceView artık product_performance_view.

Content API for Shopping ve Merchant API'deki tablo adları arasındaki eşleme aşağıda verilmiştir:

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

Merchant API'de, alan öneki belirtmek (ör. segments.offer_id ) artık gerekli değildir. Bunun yerine yalnızca alan adını (offer_id) kullanın.

Content API for Shopping ve Merchant API'deki sorguların karşılaştırmasına dair bir örnek aşağıda verilmiştir:

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

Aşağıda örnek bir yanıt verilmiştir:

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

Tablo adı, alan öneki olarak kullanılabilir. Örneğin, Merchant API sorgusunda hem offer_id hem de product_performance_view.offer_id kabul edilir.

Performans

Merchant Reports API'deki performans görünümünde yapılan değişiklikler aşağıda belirtilmiştir:

Content API Merchant API Açıklama
segments.program: dize marketing_method: dize program segmentinin yerini yeni bir marketing_method alanı alıyor. Ayrıntılar için Yeni marketing method değerleri bölümüne bakın.
metrics.ctr: çift clickThroughRate: çift ctr metriğinin adı clickThroughRate olarak değiştirildi
metrics.conversionValueMicros: integer
segments.currencyCode: string 		conversionValue: {
object (Price)
} 		Mikro tutar ve para birimi alanları, Price türünde tek bir alanda birleştirilir.
metrics.orders,
metrics.orderedItems,
… 		Desteklenmiyor Google ile Satın Al metrikleri, Merchant Reports API'de desteklenmez.

Yeni pazarlama yöntemi değerleri

segments.program ve marketing_method değerleri arasındaki eşleme aşağıda verilmiştir:

Content API Merchant API
SHOPPING_ADS ADS
FREE_PRODUCT_LISTING ORGANIC
FREE_LOCAL_PRODUCT_LISTING ORGANIC
BUY_ON_GOOGLE_LISTING Desteklenmiyor

Ürün

Merchant Reports API'deki ürün görünümüyle ilgili değişiklikler aşağıda belirtilmiştir:

Content API Merchant API Açıklama
productView.id: dize id: dize Alan biçimi channel:language:targetCountry:offerId olarak değiştirildi.
channel~language~feedLabel~offerId
productView.priceMicros: integer
productView.currencyCode: string 		price: {
object (Price)
} 		Mikro tutar ve para birimi alanları, Price türünde tek bir alanda birleştirilir.
productView.aggregated_destination_status: dize aggregated_reporting_context_status: dize aggregated_destination_status alanı aggregated_reporting_context_status olarak yeniden adlandırıldı, değerler değişmedi
productView.item_issues: [
{
object (ItemIssue)
}
] 		item_issues: [
{
object (ItemIssue)
}
] 		ItemIssue tanımı değişti
Desteklenmiyor feedLabel: dize feedLabel alanı kullanıma sunuluyor

Fiyat Analizleri

Merchant Reports API'deki fiyat analizleri görünümünde yapılan değişiklikler aşağıda belirtilmiştir:

Content API Merchant API Açıklama
productView.id: dize id: dize Alan biçimi channel:language:targetCountry:offerId olarak değiştirildi.channel~language~feedLabel~offerId
productView.priceMicros: integer
productView.currencyCode: string 		price: {
object (Price)
} 		Mikro tutar ve para birimi alanları, Price türünde tek bir alanda birleştirilir.
priceInsights.suggestedPriceMicros: integer
priceInsights.suggestedPriceCurrencyCode: string 		suggestedPrice: {
object (Price)
} 		Mikro tutar ve para birimi alanları, Price türünde tek bir alanda birleştirilir.
priceInsights.predictedGrossProfitChangeFraction: double
priceInsights.predictedMonthlyGrossProfitChangeMicros: integer
priceInsights.predictedMonthlyGrossProfitChangeCurrencyCode: string 		Desteklenmiyor Brüt kâr değişikliğiyle ilgili alanlar, Merchant Reports API'de desteklenmez.

Fiyat rekabetçiliği

Merchant Reports API'deki fiyat rekabetçiliği görünümünde yapılan değişiklikler aşağıda belirtilmiştir:

Content API Merchant API Açıklama
productView.id: dize id: dize Alan biçimi channel:language:targetCountry:offerId olarak değiştirildi.channel~language~feedLabel~offerId
productView.priceMicros: integer
productView.currencyCode: string 		price: {
object (Price)
} 		Mikro tutar ve para birimi alanları, Price türünde tek bir alanda birleştirilir.
priceCompetitiveness.countryCode: dize reportCountryCode: dize countryCode alanı, reportCountryCode olarak yeniden adlandırıldı
priceCompetitiveness.benchmarkPriceMicros: integer
priceCompetitiveness.benchmarkPriceCurrencyCode: string 		benchmarkPrice: {
object (Price)
} 		Mikro tutar ve para birimi alanları, Price türünde tek bir alanda birleştirilir.

En çok satanlar

Merchant Reports API'deki çok satanlar görünümleriyle ilgili değişiklikler aşağıda belirtilmiştir:

Content API Merchant API Açıklama
bestSellers.countryCode: dize reportCountryCode: dize countryCode alanı, reportCountryCode olarak yeniden adlandırıldı
bestSellers.categoryId: int reportCategoryId: int categoryId alanı, reportCategoryId olarak yeniden adlandırıldı

Görünürlük rekabeti

Merchant Reports API'deki görünürlük rekabeti görünümlerinde yapılan değişiklikler aşağıda belirtilmiştir:

Content API Merchant API Açıklama
competitiveVisibility.countryCode: dize reportCountryCode: dize countryCode alanı, reportCountryCode olarak yeniden adlandırıldı
competitiveVisibility.categoryId: tam sayı reportCategoryId: tam sayı categoryId alanı, reportCategoryId olarak yeniden adlandırıldı

Önceki
Migrate conversion sources management
Sonraki
Migrate local feeds partnership management