فهرست مطالب
-
ReportService
(رابط) -
BestSellersBrandView
(پیام) -
BestSellersProductClusterView
(پیام) -
BestSellersProductClusterView.InventoryStatus
(enum) -
CompetitiveVisibilityBenchmarkView
(پیام) -
CompetitiveVisibilityCompetitorView
(پیام) -
CompetitiveVisibilityTopMerchantView
(پیام) -
MarketingMethod
(پیام) -
MarketingMethod.MarketingMethodEnum
(enum) -
NonProductPerformanceView
(پیام) -
PriceCompetitivenessProductView
(پیام) -
PriceInsightsProductView
(پیام) -
PriceInsightsProductView.Effectiveness
(تعدادی) -
ProductPerformanceView
(پیام) -
ProductView
(پیام) -
ProductView.AggregatedReportingContextStatus
(در فهرست) -
ProductView.ClickPotential
(enum) -
ProductView.ItemIssue
(پیام) -
ProductView.ItemIssue.ItemIssueResolution
(enum) -
ProductView.ItemIssue.ItemIssueSeverity
(پیام) -
ProductView.ItemIssue.ItemIssueSeverity.AggregatedIssueSeverity
(enum) -
ProductView.ItemIssue.ItemIssueSeverity.IssueSeverityPerReportingContext
(پیام) -
ProductView.ItemIssue.ItemIssueType
(پیام) -
RelativeDemand
(پیام) -
RelativeDemand.RelativeDemandEnum
(enum) -
RelativeDemandChangeType
(پیام) -
RelativeDemandChangeType.RelativeDemandChangeTypeEnum
(enum) -
ReportGranularity
(پیام) -
ReportGranularity.ReportGranularityEnum
(enum) -
ReportRow
(پیام) -
SearchRequest
(پیام) -
SearchResponse
(پیام) -
TrafficSource
(پیام) -
TrafficSource.TrafficSourceEnum
(enum)
گزارش سرویس
خدماتی برای بازیابی گزارش ها و اطلاعات بینش در مورد محصولات شما، عملکرد آنها و محیط رقابتی آنها در Google.
جستجو کردن |
---|
یک گزارش تعریف شده توسط یک عبارت جستجو را بازیابی می کند. پاسخ ممکن است دارای ردیف های کمتری نسبت به
|
BestSellersBrandView
فیلدهای موجود برای پرس و جو در جدول best_sellers_brand_view
.
گزارش پرفروش ها با برندهای برتر.
مقادیر فقط برای فیلدهایی که به صراحت در عبارت جستجوی درخواست درخواست شده اند تنظیم می شوند.
زمینه های | |
---|---|
report_date | تاریخ گزارش. مقدار این فیلد فقط می تواند یکی از موارد زیر باشد:
در بند |
report_granularity | جزئیات گزارش رتبه بندی را می توان در بازه زمانی یک هفته یا یک ماه انجام داد. در بند |
report_country_code | کشوری که رتبه در آن محاسبه می شود. در قالب ISO 3166 ارائه شده است. در بند |
report_category_id | شناسه دستهبندی محصول Google برای محاسبه رتبهبندی، که در طبقهبندی محصولات Google نشان داده شده است. در بند |
brand | نام برند. |
rank | محبوبیت برند در تبلیغات و سطوح ارگانیک، در دسته بندی و کشور انتخابی، بر اساس تعداد تخمینی تعداد واحدهای فروخته شده. |
previous_rank | رتبه محبوبیت در هفته یا ماه قبل. |
relative_demand | تقاضای تخمینی در رابطه با نام تجاری با بالاترین رتبه محبوبیت در همان دسته و کشور. |
previous_relative_demand | تقاضای تخمینی در رابطه با نام تجاری با بالاترین رتبه محبوبیت در همان دسته و کشور در هفته یا ماه قبل. |
relative_demand_change | تغییر در تقاضای تخمینی خواه بالا آمد، غرق شد یا صاف ماند. |
پرفروش ترین محصولClusterView
فیلدهای موجود برای پرس و جو در جدول best_sellers_product_cluster_view
.
گزارش پرفروشها با خوشههای محصولات برتر. خوشه محصول گروهی برای پیشنهادات و انواع مختلف است که نشان دهنده یک محصول است، به عنوان مثال، Google Pixel 7.
مقادیر فقط برای فیلدهایی که به صراحت در عبارت جستجوی درخواست درخواست شده اند تنظیم می شوند.
زمینه های | |
---|---|
report_date | تاریخ گزارش. مقدار این فیلد فقط می تواند یکی از موارد زیر باشد:
در بند |
variant_gtins[] | GTIN انواع نمونه از خوشه محصول. |
report_granularity | جزئیات گزارش رتبه بندی را می توان در بازه زمانی یک هفته یا یک ماه انجام داد. در بند |
report_country_code | کشوری که رتبه در آن محاسبه می شود. در قالب ISO 3166 ارائه شده است. در بند |
report_category_id | شناسه دستهبندی محصول Google برای محاسبه رتبهبندی، که در طبقهبندی محصولات Google نشان داده شده است. در بند |
title | عنوان خوشه محصول. |
brand | نام تجاری خوشه محصول. |
category_l1 | دسته محصول (سطح 1) خوشه محصول، که در طبقه بندی محصولات Google نشان داده شده است. |
category_l2 | دسته محصول (سطح دوم) خوشه محصول، که در طبقه بندی محصولات Google نشان داده شده است. |
category_l3 | دسته محصول (سطح سوم) خوشه محصول، که در طبقه بندی محصولات Google نشان داده شده است. |
category_l4 | دسته محصول (سطح 4) خوشه محصول، که در طبقه بندی محصولات Google نشان داده شده است. |
category_l5 | دسته محصول (سطح 5) خوشه محصول، که در طبقه بندی محصولات Google نشان داده شده است. |
inventory_status | چه خوشه محصول در منبع داده محصول شما حداقل در یکی از کشورها این فیلد فیلتر کشور گزارش پرفروشترینها را در نظر نمیگیرد. |
brand_inventory_status | خواه حداقل یک محصول از نام تجاری در حال حاضر این فیلد فیلتر کشور گزارش پرفروشترینها را در نظر نمیگیرد. |
rank | محبوبیت خوشه محصول در تبلیغات و سطوح ارگانیک، در دسته و کشور انتخاب شده، بر اساس تعداد تخمینی تعداد واحدهای فروخته شده. |
previous_rank | رتبه محبوبیت در هفته یا ماه قبل. |
relative_demand | برآورد تقاضا در رابطه با خوشه محصول با بالاترین رتبه محبوبیت در همان دسته و کشور. |
previous_relative_demand | تقاضای تخمینی در رابطه با خوشه محصول با بالاترین رتبه محبوبیت در همان دسته و کشور در هفته یا ماه قبل. |
relative_demand_change | تغییر در تقاضای تخمینی خواه بالا آمد، غرق شد یا صاف ماند. |
وضعیت موجودی
وضعیت خوشه محصول یا نام تجاری در موجودی شما.
Enums | |
---|---|
INVENTORY_STATUS_UNSPECIFIED | مشخص نشده است. |
IN_STOCK | شما محصولی برای این خوشه محصول یا برند در انبار دارید. |
OUT_OF_STOCK | شما محصولی برای این خوشه محصول یا نام تجاری در موجودی دارید اما در حال حاضر موجود نیست. |
NOT_IN_INVENTORY | شما محصولی برای این خوشه محصول یا نام تجاری در موجودی ندارید. |
CompetitiveVisibilityBenchmarkView
فیلدهای موجود برای پرس و جو در جدول competitive_visibility_benchmark_view
.
گزارش دید رقابتی با معیار دسته بندی.
مقادیر فقط برای فیلدهایی که به صراحت در عبارت جستجوی درخواست درخواست شده اند تنظیم می شوند.
زمینه های | |
---|---|
date | تاریخ این ردیف. در بند |
report_country_code | کشوری که برداشت ها ظاهر شد. در بند |
report_category_id | شناسه دسته محصول Google برای محاسبه گزارش، که در طبقه بندی محصولات Google نشان داده شده است. در بند |
traffic_source | منبع ترافیک برداشت ها در بند |
your_domain_visibility_trend | تغییر نمایان بودن بر اساس نمایشهای دامنه شما با توجه به شروع محدوده زمانی انتخابی (یا روز اول با نمایشهای غیر صفر). در بند "WHERE" نمی توان آن را فیلتر کرد. |
category_benchmark_visibility_trend | تغییر در دید بر اساس برداشتها با توجه به شروع محدوده زمانی انتخابشده (یا روز اول با نمایشهای غیرصفر) برای مجموعه ترکیبی از بازرگانان با بیشترین دید تقریبی بازار. در بند "WHERE" نمی توان آن را فیلتر کرد. |
CompetitiveVisibilityCompetitorView
فیلدهای موجود برای پرس و جو در جدول competitive_visibility_competitor_view
.
گزارش دید رقابتی با مشاغل با دید مشابه.
مقادیر فقط برای فیلدهایی که به صراحت در عبارت جستجوی درخواست درخواست شده اند تنظیم می شوند.
زمینه های | |
---|---|
date | تاریخ این ردیف. شرط |
domain | اگر «is_your_domain» درست باشد، دامنه رقیب یا دامنه شما. در بند |
is_your_domain | درست است اگر این ردیف حاوی داده های دامنه شما باشد. در بند "WHERE" نمی توان آن را فیلتر کرد. |
report_country_code | کشوری که برداشت ها ظاهر شد. در بند |
report_category_id | شناسه دسته محصول Google برای محاسبه گزارش، که در طبقهبندی محصولات Google نشان داده شده است. در بند |
traffic_source | منبع ترافیک برداشت ها در بند |
rank | موقعیت دامنه در رتبهبندی کسبوکارهای مشابه برای کلیدهای انتخابی ( در بند "WHERE" نمی توان آن را فیلتر کرد. |
ads_organic_ratio | نسبت تبلیغات/ارگانیک نشان میدهد که دامنه در مقایسه با ترافیک ارگانیک چقدر از آگهیهای خرید بازدید میکند. عدد گرد و سطل شده است. در بند "WHERE" نمی توان آن را فیلتر کرد. |
page_overlap_rate | نرخ همپوشانی صفحه نشان میدهد که چقدر پیشنهادات خردهفروشان رقیب همراه با پیشنهادات شما در یک صفحه نشان داده میشوند. در بند "WHERE" نمی توان آن را فیلتر کرد. |
higher_position_rate | نرخ موقعیت بالاتر نشان می دهد که هر چند وقت یکبار پیشنهاد یک رقیب در موقعیت بالاتری نسبت به پیشنهاد شما در صفحه قرار می گیرد. در بند "WHERE" نمی توان آن را فیلتر کرد. |
relative_visibility | دید نسبی نشان می دهد که پیشنهادات رقبای شما در مقایسه با پیشنهادات شما چند بار نشان داده می شود. به عبارت دیگر، این تعداد نمایشهای نمایشدادهشده از یک خردهفروش رقیب تقسیم بر تعداد نمایشهای نمایشدادهشده شما در یک بازه زمانی انتخابشده برای یک دسته محصول و کشور انتخابشده است. در بند "WHERE" نمی توان آن را فیلتر کرد. |
CompetitiveVisibilityTopMerchantView
فیلدهای موجود برای پرس و جو در جدول competitive_visibility_top_merchant_view
.
گزارش دید رقابتی با کسب و کار با بالاترین دید.
مقادیر فقط برای فیلدهایی که به صراحت در عبارت جستجوی درخواست درخواست شده اند تنظیم می شوند.
زمینه های | |
---|---|
date | تاریخ این ردیف. نمی توان در بند |
domain | اگر «is_your_domain» درست باشد، دامنه رقیب یا دامنه شما. در بند |
is_your_domain | درست است اگر این ردیف حاوی داده های دامنه شما باشد. در بند "WHERE" نمی توان آن را فیلتر کرد. |
report_country_code | کشوری که برداشت ها ظاهر شد. در بند |
report_category_id | شناسه دسته محصول Google برای محاسبه گزارش، که در طبقه بندی محصولات Google نشان داده شده است. در بند |
traffic_source | منبع ترافیک برداشت ها در بند |
rank | موقعیت دامنه در رتبهبندی تاجران برتر برای کلیدهای انتخابی ( در بند "WHERE" قابل فیلتر نیست. |
ads_organic_ratio | نسبت تبلیغات/ارگانیک نشان میدهد که دامنه در مقایسه با ترافیک ارگانیک چقدر از آگهیهای خرید بازدید میکند. عدد گرد و سطل شده است. در بند "WHERE" نمی توان آن را فیلتر کرد. |
page_overlap_rate | نرخ همپوشانی صفحه نشان میدهد که چقدر پیشنهادات خردهفروشان رقیب همراه با پیشنهادات شما در یک صفحه نشان داده میشوند. در بند "WHERE" نمی توان آن را فیلتر کرد. |
higher_position_rate | نرخ موقعیت بالاتر نشان می دهد که هر چند وقت یکبار پیشنهاد یک رقیب در موقعیت بالاتری نسبت به پیشنهاد شما در صفحه قرار می گیرد. در بند "WHERE" نمی توان آن را فیلتر کرد. |
روش بازاریابی
این نوع هیچ فیلدی ندارد.
روش بازاریابی مورد استفاده برای تبلیغ محصولات شما در گوگل (ارگانیک در مقابل تبلیغات).
MarketingMethodEnum
ارزش های روش بازاریابی
Enums | |
---|---|
MARKETING_METHOD_ENUM_UNSPECIFIED | مشخص نشده است. |
ORGANIC | بازاریابی ارگانیک |
ADS | بازاریابی مبتنی بر تبلیغات |
NonProductPerformanceView
فیلدهای موجود برای درخواست در جدول non_product_performance_view
.
داده های عملکرد در تصاویر و لینک های فروشگاه آنلاین منتهی به صفحات غیر محصول شما. این شامل معیارهای عملکرد (به عنوان مثال، clicks
) و ابعادی است که معیارهای عملکرد بر اساس آنها تقسیمبندی میشوند (به عنوان مثال، date
).
فیلدهای بخش را نمی توان در جستارها بدون انتخاب حداقل یک فیلد متریک انتخاب کرد.
مقادیر فقط برای فیلدهایی که به صراحت در عبارت جستجوی درخواست درخواست شده اند تنظیم می شوند.
زمینه های | |
---|---|
date | تاریخ در منطقه زمانی تاجر که معیارها برای آن اعمال میشود. بخش. شرط |
week | اولین روز هفته (دوشنبه) تاریخ معیارها در منطقه زمانی تاجر. بخش. |
clicks | تعداد کلیک بر روی تصاویر و لینک های فروشگاه آنلاین منتهی به صفحات غیر محصول شما. متریک. |
impressions | تعداد دفعاتی که تصاویر و لینکهای فروشگاه آنلاین منتهی به صفحات غیرمحصولی شما نشان داده شدهاند. متریک. |
click_through_rate | نرخ کلیک - تعداد کلیکها ( |
قیمت رقابتی محصول View
فیلدهای موجود برای درخواست در جدول price_competitiveness_product_view
.
گزارش رقابت قیمت
مقادیر فقط برای فیلدهایی که به صراحت در عبارت جستجوی درخواست درخواست شده اند تنظیم می شوند.
زمینه های | |
---|---|
price | قیمت فعلی محصول |
benchmark_price | آخرین معیار قیمت موجود برای کاتالوگ محصول در کشور معیار. |
report_country_code | کشور معیار قیمت در قالب ISO 3166 ارائه شده است. در بند |
id | REST ID محصول، به شکل در بند |
offer_id | شناسه محصول ارائه شده توسط تاجر. |
title | عنوان محصول. |
brand | نام تجاری محصول. |
category_l1 | دسته بندی محصول (سطح 1) در طبقه بندی محصولات Google . |
category_l2 | دسته بندی محصول (سطح دوم) در طبقه بندی محصولات گوگل . |
category_l3 | دسته بندی محصول (سطح 3) در طبقه بندی محصولات Google . |
category_l4 | دسته بندی محصول (سطح 4) در طبقه بندی محصولات گوگل . |
category_l5 | دسته بندی محصول (سطح 5) در طبقه بندی محصولات گوگل . |
product_type_l1 | نوع محصول (سطح 1) در طبقه بندی محصولات خود بازرگان. |
product_type_l2 | نوع محصول (سطح دوم) در طبقه بندی محصولات خود بازرگان. |
product_type_l3 | نوع محصول (سطح 3) در طبقه بندی محصولات خود بازرگان. |
product_type_l4 | نوع محصول (سطح 4) در طبقه بندی محصولات خود بازرگان. |
product_type_l5 | نوع محصول (سطح 5) در طبقه بندی محصولات خود بازرگان. |
PriceInsightsProductView
فیلدهای موجود برای درخواست در جدول price_insights_product_view
.
گزارش بینش قیمت
مقادیر فقط برای فیلدهایی که به صراحت در عبارت جستجوی درخواست درخواست شده اند تنظیم می شوند.
زمینه های | |
---|---|
price | قیمت فعلی محصول |
suggested_price | آخرین قیمت پیشنهادی برای محصول |
effectiveness | اثربخشی پیشبینیشده اعمال پیشنهاد قیمت، سطل شده است. |
id | REST ID محصول، به شکل در بند |
offer_id | شناسه محصول ارائه شده توسط تاجر. |
title | عنوان محصول. |
brand | نام تجاری محصول. |
category_l1 | دسته بندی محصول (سطح 1) در طبقه بندی محصولات Google . |
category_l2 | دسته بندی محصول (سطح دوم) در طبقه بندی محصولات Google . |
category_l3 | دسته بندی محصول (سطح 3) در طبقه بندی محصولات گوگل . |
category_l4 | دسته بندی محصول (سطح 4) در طبقه بندی محصولات گوگل . |
category_l5 | دسته بندی محصول (سطح 5) در طبقه بندی محصولات گوگل . |
product_type_l1 | نوع محصول (سطح 1) در طبقه بندی محصولات خود بازرگان. |
product_type_l2 | نوع محصول (سطح دوم) در طبقه بندی محصولات خود بازرگان. |
product_type_l3 | نوع محصول (سطح سوم) در طبقه بندی محصولات خود بازرگان. |
product_type_l4 | نوع محصول (سطح 4) در طبقه بندی محصولات خود بازرگان. |
product_type_l5 | نوع محصول (سطح 5) در طبقه بندی محصولات خود بازرگان. |
predicted_impressions_change_fraction | پیش بینی تغییر در نمایش ها به صورت کسری پس از معرفی قیمت پیشنهادی در مقایسه با قیمت فعال فعلی. به عنوان مثال، 0.05 یک افزایش 5 درصدی پیش بینی شده در نمایش ها است. |
predicted_clicks_change_fraction | پیش بینی تغییر در کلیک ها به صورت کسری پس از معرفی قیمت پیشنهادی نسبت به قیمت فعال فعلی. به عنوان مثال، 0.05 یک افزایش 5٪ پیش بینی شده در کلیک است. |
predicted_conversions_change_fraction | پیش بینی تغییر در تبدیل به صورت کسری پس از معرفی قیمت پیشنهادی در مقایسه با قیمت فعال فعلی. به عنوان مثال، 0.05 یک افزایش 5٪ پیش بینی شده در تبدیل است). |
اثربخشی
سطل اثربخشی پیش بینی شده
اثربخشی نشان می دهد که کدام محصولات بیشتر از تغییرات قیمت سود می برند. این رتبه بندی افزایش عملکرد پیش بینی شده با تعدیل قیمت فروش و تفاوت بین قیمت فعلی شما و قیمت پیشنهادی را در نظر می گیرد. پیشبینی میشود پیشنهادات قیمت با اثربخشی HIGH
بیشترین افزایش عملکرد را به همراه داشته باشد.
Enums | |
---|---|
EFFECTIVENESS_UNSPECIFIED | اثربخشی ناشناخته است. |
LOW | اثربخشی پایین است. |
MEDIUM | اثربخشی متوسط است. |
HIGH | اثربخشی بالاست. |
Product PerformanceView
فیلدهای موجود برای پرس و جو در جدول product_performance_view
.
دادههای عملکرد محصول برای حساب شما، از جمله معیارهای عملکرد (به عنوان مثال، clicks
) و ابعادی که بر اساس آن معیارهای عملکرد بخشبندی میشوند (به عنوان مثال، offer_id
). مقادیر ابعاد محصول، مانند offer_id
، وضعیت یک محصول را در زمان نمایش نشان میدهد.
فیلدهای بخش را نمی توان در جستارها بدون انتخاب حداقل یک فیلد متریک انتخاب کرد.
مقادیر فقط برای فیلدهایی که به صراحت در عبارت جستجوی درخواست درخواست شده اند تنظیم می شوند.
زمینه های | |
---|---|
date | تاریخ در منطقه زمانی تاجر که معیارها برای آن اعمال میشود. بخش. شرط |
week | اولین روز هفته (دوشنبه) تاریخ معیارها در منطقه زمانی تاجر. بخش. |
conversion_value | ارزش تبدیل های منتسب به محصول، در تاریخ تبدیل گزارش شده است. متریک. فقط برای منبع ترافیک |
marketing_method | روش بازاریابی که معیارها برای آن اعمال می شود. بخش. |
customer_country_code | کد کشوری که مشتری در زمان رویداد در آن قرار دارد. در قالب ISO 3166 ارائه شده است. بخش. اگر کشور مشتری را نتوان تعیین کرد، یک کد ویژه 'ZZ' برگردانده می شود. |
offer_id | شناسه محصول ارائه شده توسط تاجر. بخش. |
title | عنوان محصول. بخش. |
brand | نام تجاری محصول. بخش. |
category_l1 | دسته بندی محصول (سطح 1) در طبقه بندی محصولات گوگل. بخش. |
category_l2 | دسته بندی محصول (سطح دوم) در طبقه بندی محصولات گوگل. بخش. |
category_l3 | دسته بندی محصول (سطح 3) در طبقه بندی محصولات گوگل. بخش. |
category_l4 | دسته بندی محصولات (سطح 4) در طبقه بندی محصولات گوگل. بخش. |
category_l5 | دسته بندی محصول (سطح 5) در طبقه بندی محصولات گوگل. بخش. |
product_type_l1 | نوع محصول (سطح 1) در طبقه بندی محصولات خود بازرگان. بخش. |
product_type_l2 | نوع محصول (سطح دوم) در طبقه بندی محصولات خود بازرگان. بخش. |
product_type_l3 | نوع محصول (سطح 3) در طبقه بندی محصولات خود بازرگان. بخش. |
product_type_l4 | نوع محصول (سطح 4) در طبقه بندی محصولات خود بازرگان. بخش. |
product_type_l5 | نوع محصول (سطح 5) در طبقه بندی محصولات خود بازرگان. بخش. |
custom_label0 | برچسب سفارشی 0 برای گروه بندی سفارشی محصولات. بخش. |
custom_label1 | برچسب سفارشی 1 برای گروه بندی سفارشی محصولات. بخش. |
custom_label2 | برچسب سفارشی 2 برای گروه بندی سفارشی محصولات. بخش. |
custom_label3 | برچسب سفارشی 3 برای گروه بندی سفارشی محصولات. بخش. |
custom_label4 | برچسب سفارشی 4 برای گروه بندی سفارشی محصولات. بخش. |
clicks | تعداد کلیک ها متریک. |
impressions | تعداد دفعاتی که محصولات تاجر نشان داده می شود. متریک. |
click_through_rate | نرخ کلیک - تعداد کلیکهایی که محصولات تاجر دریافت میکنند (کلیکها) تقسیم بر تعداد دفعاتی که محصولات نشان داده میشوند (نمایشها). متریک. |
conversions | تعداد تبدیلهای منتسب به محصول، گزارششده در تاریخ تبدیل. بسته به مدل انتساب، یک تبدیل ممکن است بین چند کلیک توزیع شود، جایی که هر کلیک اعتبار خود را به خود اختصاص می دهد. این متریک مجموع تمام این اعتبارات است. متریک. فقط برای منبع ترافیک |
conversion_rate | تعداد تبدیلها تقسیم بر تعداد کلیکها، گزارششده در تاریخ نمایش. متریک. فقط برای منبع ترافیک |
ProductView
فیلدهای موجود برای پرس و جو در جدول product_view
.
محصولات موجود در موجودی فعلی محصولات موجود در این جدول مانند محصولات فرعی API هستند، اما همه ویژگیهای محصول از API فرعی محصولات برای جستجو در این جدول موجود نیستند. برخلاف محصولات فرعی API، این جدول اجازه می دهد تا لیست برگشتی محصولات را بر اساس ویژگی های محصول فیلتر کنید. برای بازیابی یک محصول واحد با id
یا فهرست کردن همه محصولات، API فرعی محصولات باید استفاده شود.
مقادیر فقط برای فیلدهایی که به صراحت در عبارت جستجوی درخواست درخواست شده اند تنظیم می شوند.
زمینه های | |
---|---|
price | قیمت کالا. در صورتی که اطلاعاتی در مورد قیمت محصول در دسترس نباشد، وجود ندارد. |
gtin[] | فهرست شمارههای کالاهای تجاری جهانی (GTIN) محصول. |
creation_time | زمانی که تاجر محصول را ایجاد کرد در ثانیه مُهر زمانی. |
expiration_date | تاریخ انقضا برای محصول، درج شده است. |
item_issues[] | لیست مشکلات اقلام برای محصول از این فیلد نمی توان برای مرتب سازی نتایج استفاده کرد. فقط ویژگی های انتخاب شده از این فیلد (به عنوان مثال، |
click_potential | پتانسیل عملکرد تخمینی در مقایسه با محصولات با بالاترین عملکرد تاجر. |
id | شناسه REST محصول، به شکل در بند |
channel | کانال محصول می تواند |
language_code | کد زبان محصول در قالب BCP 47. |
feed_label | برچسب خوراک محصول |
offer_id | شناسه محصول ارائه شده توسط تاجر. |
title | عنوان محصول. |
brand | نام تجاری محصول. |
category_l1 | دسته بندی محصول (سطح 1) در طبقه بندی محصولات Google . |
category_l2 | دسته بندی محصول (سطح دوم) در طبقه بندی محصولات گوگل . |
category_l3 | دسته بندی محصول (سطح 3) در طبقه بندی محصولات Google . |
category_l4 | دسته بندی محصول (سطح 4) در طبقه بندی محصولات گوگل . |
category_l5 | دسته بندی محصول (سطح 5) در طبقه بندی محصولات گوگل . |
product_type_l1 | نوع محصول (سطح 1) در طبقه بندی محصولات خود بازرگان. |
product_type_l2 | نوع محصول (سطح دوم) در طبقه بندی محصولات خود بازرگان. |
product_type_l3 | نوع محصول (سطح 3) در طبقه بندی محصولات خود بازرگان. |
product_type_l4 | نوع محصول (سطح 4) در طبقه بندی محصولات خود بازرگان. |
product_type_l5 | نوع محصول (سطح 5) در طبقه بندی محصولات خود بازرگان. |
condition | وضعیت محصول. |
availability | در دسترس بودن محصول. |
shipping_label | برچسب حمل و نقل عادی مشخص شده در منبع داده. |
item_group_id | شناسه گروه مورد توسط بازرگان برای گروه بندی انواع با هم ارائه شده است. |
thumbnail_link | پیوند به تصویر پردازش شده محصول، میزبانی شده در زیرساخت Google. |
aggregated_reporting_context_status | وضعیت تجمیع شده |
click_potential_rank | رتبه بندی محصول بر اساس پتانسیل کلیک آن. محصولی با |
AggregatedReportingContextStatus
وضعیت محصول برای همه زمینه های گزارش جمع آوری شده است.
در اینجا مثالی از نحوه محاسبه وضعیت انبوه آورده شده است:
لیست های رایگان | تبلیغات خرید | وضعیت |
---|---|---|
تایید شده | تایید شده | واجد شرایط |
تایید شده | انتظار | واجد شرایط |
تایید شده | تایید نشد | ELIGIBLE_LIMITED |
انتظار | انتظار | انتظار |
تایید نشد | تایید نشد | NOT_ELIGIBLE_OR_DISAPPROVED |
Enums | |
---|---|
AGGREGATED_REPORTING_CONTEXT_STATUS_UNSPECIFIED | مشخص نشده است. |
NOT_ELIGIBLE_OR_DISAPPROVED | محصول برای همه زمینههای گزارشدهی واجد شرایط نیست یا تأیید نشده است. |
PENDING | وضعیت محصول در همه زمینههای گزارشدهی در انتظار است. |
ELIGIBLE_LIMITED | محصول برای برخی (اما نه همه) زمینه های گزارش واجد شرایط است. |
ELIGIBLE | محصول برای همه زمینه های گزارش واجد شرایط است. |
پتانسیل کلیک کنید
پتانسیل کلیک یک محصول پتانسیل عملکرد آن را در مقایسه با محصولات تاجر با بالاترین عملکرد تخمین می زند. پتانسیل کلیک یک محصول به بازرگانان کمک می کند تا اولویت بندی کنند که کدام محصولات را تعمیر کنند و به آنها کمک می کند تا درک کنند که محصولات در برابر پتانسیل آنها چگونه عمل می کنند.
Enums | |
---|---|
CLICK_POTENTIAL_UNSPECIFIED | تأثیر کلیکهای پیشبینیشده ناشناخته. |
LOW | امکان دریافت تعداد کلیک کم در مقایسه با محصولات با بالاترین عملکرد تاجر. |
MEDIUM | بالقوه برای دریافت تعداد کلیک متوسط در مقایسه با محصولات با بالاترین عملکرد تاجر. |
HIGH | پتانسیل دریافت تعداد کلیک مشابه به عنوان محصولات با بالاترین عملکرد تاجر. |
ItemIssue
مشکل مورد مرتبط با محصول
زمینه های | |
---|---|
type | نوع مسئله مورد |
severity | شدت موضوع مورد |
resolution | حل مشکل مورد |
ItemIssueResolution
چگونه مسئله را حل کنیم.
Enums | |
---|---|
ITEM_ISSUE_RESOLUTION_UNSPECIFIED | مشخص نشده است. |
MERCHANT_ACTION | تاجر باید مشکل را برطرف کند. |
PENDING_PROCESSING | مشکل به طور خودکار (مثلاً خزیدن تصویر) یا از طریق بررسی Google حل خواهد شد. در حال حاضر هیچ اقدام تجاری لازم نیست. وضوح ممکن است به مشکل دیگری منجر شود (به عنوان مثال، اگر خزیدن با شکست مواجه شود). |
ItemIssueSeverity
این موضوع چگونه بر ارائه محصول تأثیر می گذارد.
زمینه های | |
---|---|
severity_per_reporting_context[] | شدت موضوع در زمینه گزارش. |
aggregated_severity | شدت تجمیع موضوع برای همه زمینه های گزارشگری که بر آن تأثیر می گذارد. از این فیلد می توان برای فیلتر کردن نتایج استفاده کرد. |
AggregatedIssueSeverity
شدت موضوع برای همه زمینه های گزارش جمع آوری شده است.
Enums | |
---|---|
AGGREGATED_ISSUE_SEVERITY_UNSPECIFIED | مشخص نشده است. |
DISAPPROVED | مشکل حداقل در یک زمینه گزارش، محصول را تأیید نمی کند. |
DEMOTED | Issue محصول را در تمام زمینه های گزارشی که تحت تأثیر قرار می دهد، تنزل می دهد. |
PENDING | حل مشکل PENDING_PROCESSING است. |
IssueSeverityPerReportingContext
شدت موضوع در زمینه گزارش.
زمینه های | |
---|---|
disapproved_countries[] | فهرست کشورهای تایید نشده در زمینه گزارش، در قالب ISO 3166 ارائه شده است. |
demoted_countries[] | فهرست کشورهای تنزل یافته در زمینه گزارش، که در قالب ISO 3166 ارائه شده است. |
reporting_context | زمینه گزارش مشکل در مورد آن اعمال می شود. |
ItemIssueType
نوع مقاله.
زمینه های | |
---|---|
code | کد خطای مشکل، معادل |
canonical_attribute | نام مشخصه متعارف برای مسائل خاص ویژگی. |
تقاضای نسبی
این نوع هیچ فیلدی ندارد.
تقاضای نسبی یک خوشه محصول یا نام تجاری در گزارش بهترین فروشندگان.
RelativeDemandEnum
مقادیر تقاضای نسبی
Enums | |
---|---|
RELATIVE_DEMAND_ENUM_UNSPECIFIED | مشخص نشده است. |
VERY_LOW | تقاضا 0-5% تقاضای خوشه یا برند محصول دارای بالاترین رتبه است. |
LOW | تقاضا 6 تا 10 درصد تقاضای خوشه یا برند بالاترین رتبه محصول است. |
MEDIUM | تقاضا 11 تا 20 درصد تقاضای خوشه یا برند محصول با بالاترین رتبه است. |
HIGH | تقاضا 21 تا 50 درصد تقاضای خوشه یا برند محصول با بالاترین رتبه است. |
VERY_HIGH | تقاضا 51 تا 100 درصد تقاضای خوشه یا برند محصول با بالاترین رتبه است. |
RelativeDemandChangeType
این نوع هیچ فیلدی ندارد.
تقاضای نسبی یک خوشه محصول یا نام تجاری در گزارش پرفروش ترین ها در مقایسه با دوره زمانی قبلی.
RelativeDemandChangeTypeEnum
مقادیر نوع تغییر تقاضای نسبی.
Enums | |
---|---|
RELATIVE_DEMAND_CHANGE_TYPE_ENUM_UNSPECIFIED | مشخص نشده است. |
SINKER | تقاضای نسبی کمتر از دوره زمانی قبلی است. |
FLAT | تقاضای نسبی برابر با دوره زمانی قبلی است. |
RISER | تقاضای نسبی بیشتر از دوره زمانی قبلی است. |
ReportGranularity
این نوع هیچ فیلدی ندارد.
جزئیات گزارش پرفروش ترین ها. گزارش های پرفروش ترین ها در بازه زمانی یک هفته و یک ماه محاسبه می شود.
ReportGranularityEnum
مقادیر جزئیات را گزارش کنید.
Enums | |
---|---|
REPORT_GRANULARITY_ENUM_UNSPECIFIED | مشخص نشده است. |
WEEKLY | گزارش در بازه زمانی یک هفته محاسبه می شود. |
MONTHLY | گزارش در بازه زمانی یک ماهه محاسبه می شود. |
ReportRow
ردیف نتیجه از عبارت جستجو بازگردانده شد.
فقط پیام مربوط به جدول پرس و جو در پاسخ پر می شود. در پیام پر شده، فقط فیلدهایی که به صراحت در پرس و جو درخواست شده اند پر می شوند.
زمینه های | |
---|---|
product_performance_view | فیلدهای موجود برای پرس و جو در جدول |
non_product_performance_view | فیلدهای موجود برای درخواست در جدول |
product_view | فیلدهای موجود برای پرس و جو در جدول |
price_competitiveness_product_view | فیلدهای موجود برای درخواست در جدول |
price_insights_product_view | فیلدهای موجود برای درخواست در جدول |
best_sellers_product_cluster_view | فیلدهای موجود برای پرس و جو در جدول |
best_sellers_brand_view | فیلدهای موجود برای پرس و جو در جدول |
competitive_visibility_competitor_view | فیلدهای موجود برای پرس و جو در جدول |
competitive_visibility_top_merchant_view | فیلدهای موجود برای پرس و جو در جدول |
competitive_visibility_benchmark_view | فیلدهای موجود برای پرس و جو در جدول |
درخواست جستجو
درخواست پیام برای روش ReportService.Search
.
زمینه های | |
---|---|
parent | ضروری. شناسه حسابی که تماس برقرار می کند. باید یک حساب مستقل یا یک حساب فرعی MCA باشد. قالب: حسابها/{حساب} |
query | ضروری. کوئری که گزارشی را برای بازیابی تعریف می کند. برای جزئیات در مورد نحوه ساخت پرس و جو، به راهنمای زبان پرس و جو مراجعه کنید. برای لیست کامل جداول و فیلدهای موجود، به فیلدهای موجود مراجعه کنید. |
page_size | اختیاری. تعداد |
page_token | اختیاری. نشانه صفحه برای بازیابی. اگر مشخص نشده باشد، صفحه اول نتایج برگردانده می شود. برای درخواست صفحه بعدی نتایج، باید از مقدار به دست آمده از |
Search Response
پیام پاسخ برای روش ReportService.Search
.
زمینه های | |
---|---|
results[] | ردیف هایی که با عبارت جستجو مطابقت دارند. |
next_page_token | نشانه ای که می تواند به عنوان |
منبع ترافیک
این نوع هیچ فیلدی ندارد.
منبع ترافیک برداشتها در گزارش دید رقابتی.
TrafficSourceEnum
مقادیر منبع ترافیک
Enums | |
---|---|
TRAFFIC_SOURCE_ENUM_UNSPECIFIED | مشخص نشده است. |
ORGANIC | ترافیک ارگانیک |
ADS | ترافیک از تبلیغات |
ALL | ترافیک ارگانیک و تبلیغات |