Satıcı Raporları API'yi mevcut Content API for Shopping uygulamanızla nasıl entegre edebileceğinizi burada bulabilirsiniz.
İstekler
Merchant Reports API için aşağıdaki istek URL'si biçimini kullanın:
POST https://merchantapi.googleapis.com/reports/v1beta/{PARENT}/reports:search
Aşağıda, search
istekleri için Content API for Shopping ile Merchant Reports API'nin karşılaştırmasını görebilirsiniz:
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 |
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ı CammelCase
yerine snake_case
olarak değiştirildi.
MerchantPerformanceView
artık product_performance_view
.
Content API for Shopping ve Merchant API'deki tablo adları arasındaki eşlemeyi aşağıda bulabilirsiniz:
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 artık segments.offer_id
gibi bir alan ön ekiyle belirtme zorunluluğu yoktur. Bunun yerine, offer_id
alan adını kullanın.
Content API for Shopping ve Merchant API'deki sorguların örnek bir karşılaştırmasını aşağıda bulabilirsiniz:
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 ön eki 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 açıklanmıştır:
Content API | Merchant API | Açıklama |
segments.program : dize
|
marketing_method : dize
|
program segmenti yeni bir marketing_method alanıyla değiştirilir. Ayrıntılar için Yeni marketing method değerleri bölümüne bakın.
|
metrics.ctr : çift
|
clickThroughRate : çift
|
ctr metriği, clickThroughRate olarak yeniden adlandırıldı
|
metrics.conversionValueMicros : tam sayı
segments.currencyCode : dize
|
conversionValue: {
|
Mikro tutarlar ve para birimi alanları, Price türüne sahip tek bir alanda birleştirilir
|
metrics.orders,
|
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 şu şekildedir:
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ünde yapılan değişiklikler aşağıda açıklanmıştır:
Content API | Merchant API | Açıklama |
productView.id : dize
|
id : dize
|
Alan biçimi channel:language:targetCountry:offerId yerine channel~language~feedLabel~offerId olarak değiştirilir.
|
productView.priceMicros : tam sayı
productView.currencyCode : dize
|
price: {
|
Mikro tutarlar ve para birimi alanları, Price türüne sahip 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: [
|
item_issues: [
|
ItemIssue tanımı değişti
|
Desteklenmiyor | feedLabel : dize
|
feedLabel alanı kullanıma sunuldu
|
Fiyat Analizleri
Merchant Reports API'deki fiyat analizleri görünümünde yapılan değişiklikleri aşağıda bulabilirsiniz:
Content API | Merchant API | Açıklama |
productView.id : dize
|
id : dize
|
Alan biçimi channel:language:targetCountry:offerId yerine channel~language~feedLabel~offerId olarak değiştirilir.
|
productView.priceMicros : tam sayı
productView.currencyCode : dize
|
price: {
|
Mikro tutarlar ve para birimi alanları, Price türüne sahip tek bir alanda birleştirilir
|
priceInsights.suggestedPriceMicros : tam sayı
priceInsights.suggestedPriceCurrencyCode : dize
|
suggestedPrice: {
|
Mikro tutarlar ve para birimi alanları, Price türüne sahip tek bir alanda birleştirilir
|
priceInsights.predictedGrossProfitChangeFraction : çift temsili sayı
priceInsights.predictedMonthlyGrossProfitChangeMicros : tam sayı
priceInsights.predictedMonthlyGrossProfitChangeCurrencyCode : dize
|
Desteklenmiyor | Brüt kâr değişikliğiyle ilgili alanlar Merchant Reports API'de desteklenmez. |
Fiyat Rekabeti
Merchant Reports API'deki fiyat rekabetçiliği görünümünde yapılan değişiklikler aşağıda açıklanmıştır:
Content API | Merchant API | Açıklama |
productView.id : dize
|
id : dize
|
Alan biçimi channel:language:targetCountry:offerId yerine channel~language~feedLabel~offerId olarak değiştirilir.
|
productView.priceMicros : tam sayı
productView.currencyCode : dize
|
price: {
|
Mikro tutarlar ve para birimi alanları, Price türüne sahip tek bir alanda birleştirilir
|
priceCompetitiveness.countryCode : dize
|
reportCountryCode : dize
|
countryCode alanı, reportCountryCode olarak yeniden adlandırıldı
|
priceCompetitiveness.benchmarkPriceMicros : tam sayı
priceCompetitiveness.benchmarkPriceCurrencyCode : dize
|
benchmarkPrice: {
|
Mikro tutarlar ve para birimi alanları, Price türüne sahip tek bir alanda birleştirilir
|
En çok satanlar
Merchant Reports API'deki çok satanlar görünümlerinde yapılan değişiklikler aşağıda açıklanmıştır:
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 rekabetçi görünürlük görünümlerinde yapılan değişiklikler aşağıda açıklanmıştır:
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ı
|