Merchant Reports API'yi kullanarak ürünleriniz, performansları ve sunduğu veri görünümü aracılığıyla Google'daki rekabet ortamları hakkında bilgi edinebilirsiniz.
Merchant Reports API'yi kullanarak şunları yapabilirsiniz:
- Ürünlerinizin performansını ölçme:
Merchant API'de
MerchantPerformanceViewartıkproduct_performance_view. - Ürünlerinizi belirli alanlara göre filtreleme:
Merchant API ile,
item_issueshariç tüm kullanılabilir alanlara göre filtreleme yapabilirsiniz. - Ürün fiyatlandırmasını iyileştirme:
Merchant API ile tutar mikrosu ve para birimi alanları,
Pricetüründe tek bir alanda birleştirilir. - Pazarı anlama: Merchant API ile en çok satan ürünler ve markalar, rekabetçi fiyat noktaları, indirimli fiyat önerileri ve sektörünüzdeki rekabet ortamı hakkında bilgi edinebilirsiniz.
- Rekabet ortamınızı keşfedin: Ürün kategorisi düzeyinde rekabet ortamınızı anlamak ve görünürlüğünüzü artırmak için rapor alabilirsiniz.
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
Merchant Reports API'yi ReportService.Search yöntemini çağırarak sorgulayabilirsiniz.
Görüntüleme sayısı
Merchant API'de tablo adları CamelCasesnake_case olarak değiştirildi.
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
|
Örnek yanıt:
| 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:
| 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: {
|
Tutar mikroları ve para birimi alanları, Price türünde 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 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: {
|
Tutar mikroları 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: [
|
item_issues: [
|
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:offerIdchannel~language~feedLabel~offerId olarak değiştirildi.
|
productView.priceMicros: tam sayı
productView.currencyCode: dize
|
price: {
|
Tutar mikroları ve para birimi alanları, Price türünde tek bir alanda birleştirilir.
|
priceInsights.suggestedPriceMicros: integer
priceInsights.suggestedPriceCurrencyCode: string
|
suggestedPrice: {
|
Tutar mikroları 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:
| Content API | Merchant API | Açıklama |
productView.id: dize
|
id: dize
|
Alan biçimi channel:language:targetCountry:offerIdchannel~language~feedLabel~offerId olarak değiştirildi.
|
productView.priceMicros: integer
productView.currencyCode: string
|
price: {
|
Tutar mikroları 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: tam sayı
priceCompetitiveness.benchmarkPriceCurrencyCode: dize
|
benchmarkPrice: {
|
Tutar mikroları 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ı
|