انتقال گزارش از Content API برای خرید

در اینجا نحوه ادغام Merchant Reports API با Content API موجود برای اجرای خرید آورده شده است.

از فرمت URL درخواست زیر برای Merchant Reports API استفاده کنید:

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

در اینجا نمونه ای از مقایسه Content API برای خرید با Merchant Reports API برای درخواست های 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
شناسه ها {MERCHANT_ID} {PARENT}

روش ها

می توانید با فراخوانی روش ReportService.Search از API Merchant Reports پرس و جو کنید.

بازدیدها

در Merchant API، نام جدول از CammelCase به snake_case تغییر می‌کند.

MerchantPerformanceView اکنون product_performance_view است.

در اینجا یک نقشه بین نام جدول در Content API برای خرید و 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

در Merchant API، تعیین یک پیشوند فیلد، به عنوان مثال، segments.offer_id دیگر مورد نیاز نیست. در عوض، فقط از نام فیلد، offer_id استفاده کنید.

در اینجا نمونه ای از مقایسه پرس و جوها در Content API برای خرید و 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
   

در اینجا یک نمونه پاسخ آمده است:

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

نام جدول را می توان به عنوان پیشوند فیلد استفاده کرد. برای مثال، هر دو offer_id و product_performance_view.offer_id در جستار Merchant API پذیرفته می شوند.

عملکرد

آنچه برای نمای عملکرد در Merchant Reports API تغییر کرده است:

Content API Merchant API توضیحات
segments.program : رشته marketing_method : رشته بخش program با یک فیلد marketing_method جدید جایگزین می شود. برای جزئیات بیشتر به مقادیر marketing method جدید مراجعه کنید.
metrics.ctr : دو برابر clickThroughRate : دو برابر متریک ctr به clickThroughRate تغییر نام داد
metrics.conversionValueMicros : عدد صحیح
segments.currencyCode : رشته
conversionValue: {
object (Price)
}
فیلدهای مقدار میکرو و ارز در یک فیلد با نوع Price ادغام می شوند
metrics.orders,
metrics.orderedItems,
پشتیبانی نمی شود معیارهای خرید در Google در API گزارش‌های تجاری پشتیبانی نمی‌شوند

ارزش های روش بازاریابی جدید

در اینجا نگاشت بین مقادیر segments.program و marketing_method آمده است:

Content API Merchant API
SHOPPING_ADS ADS
FREE_PRODUCT_LISTING ORGANIC
FREE_LOCAL_PRODUCT_LISTING ORGANIC
BUY_ON_GOOGLE_LISTING پشتیبانی نمی شود

محصول

آنچه برای نمای محصول در Merchant Reports API تغییر کرده است:

Content API Merchant API توضیحات
productView.id : رشته id : رشته قالب فیلد از channel:language:targetCountry:offerId به تغییر می کند
channel~language~feedLabel~offerId
productView.priceMicros : عدد صحیح
productView.currencyCode : رشته
price: {
object (Price)
}
فیلدهای مقدار میکرو و ارز در یک فیلد با نوع Price ادغام می شوند
productView.aggregated_destination_status : رشته aggregated_reporting_context_status : رشته فیلد aggregated_destination_status به aggregated_reporting_context_status تغییر نام داده است، مقادیر تغییر نکرده اند
productView.item_issues: [
{
object (ItemIssue)
}
]
item_issues: [
{
object (ItemIssue)
}
]
تعریف ItemIssue تغییر کرده است
پشتیبانی نمی شود feedLabel : رشته فیلد feedLabel معرفی شده است

بینش قیمت

این چیزی است که برای نمای آماری قیمت در API گزارش‌های تجاری تغییر کرده است:

Content API Merchant API توضیحات
productView.id : رشته id : رشته قالب فیلد از channel:language:targetCountry:offerId به channel~language~feedLabel~offerId تغییر می کند
productView.priceMicros : عدد صحیح
productView.currencyCode : رشته
price: {
object (Price)
}
فیلدهای مقدار میکرو و ارز در یک فیلد با نوع Price ادغام می شوند
priceInsights.suggestedPriceMicros : عدد صحیح
priceInsights.suggestedPriceCurrencyCode : رشته
suggestedPrice: {
object (Price)
}
فیلدهای مقدار میکرو و ارز در یک فیلد با نوع Price ادغام می شوند
priceInsights.predictedGrossProfitChangeFraction : دو برابر
priceInsights.predictedMonthlyGrossProfitChangeMicros : عدد صحیح
priceInsights.predictedMonthlyGrossProfitChangeCurrencyCode : string
پشتیبانی نمی شود فیلدهای مربوط به تغییر سود ناخالص در API گزارش‌های تجاری پشتیبانی نمی‌شوند

رقابت پذیری قیمت

آنچه برای نمای رقابتی قیمت در Merchant Reports API تغییر کرده است:

Content API Merchant API توضیحات
productView.id : رشته id : رشته قالب فیلد از channel:language:targetCountry:offerId به channel~language~feedLabel~offerId تغییر می کند
productView.priceMicros : عدد صحیح
productView.currencyCode : رشته
price: {
object (Price)
}
فیلدهای مقدار میکرو و ارز در یک فیلد با نوع Price ادغام می شوند
priceCompetitiveness.countryCode : string reportCountryCode : رشته فیلد countryCode به reportCountryCode تغییر نام داده است
priceCompetitiveness.benchmarkPriceMicros : عدد صحیح
priceCompetitiveness.benchmarkPriceCurrencyCode : string
benchmarkPrice: {
object (Price)
}
فیلدهای مقدار میکرو و ارز در یک فیلد با نوع Price ادغام می شوند

پرفروش ترین ها

در زیر چه چیزی برای بازدیدهای پرفروش در Merchant Reports API تغییر کرده است:

Content API Merchant API توضیحات
bestSellers.countryCode : string reportCountryCode : رشته فیلد countryCode به reportCountryCode تغییر نام داده است
bestSellers.categoryId : int reportCategoryId : int قسمت categoryId به reportCategoryId تغییر نام داده است

دید رقابتی

در اینجا چه چیزی برای نماهای قابل مشاهده رقابتی در Merchant Reports API تغییر کرده است:

Content API Merchant API توضیحات
competitiveVisibility.countryCode : string reportCountryCode : رشته فیلد countryCode به reportCountryCode تغییر نام داده است
competitiveVisibility.categoryId : عدد صحیح reportCategoryId : عدد صحیح قسمت categoryId به reportCategoryId تغییر نام داده است