Package google.shopping.merchant.reports.v1beta

فهرست مطالب

گزارش سرویس

خدماتی برای بازیابی گزارش ها و اطلاعات بینش در مورد محصولات شما، عملکرد آنها و محیط رقابتی آنها در Google.

جستجو کردن

rpc Search( SearchRequest ) returns ( SearchResponse )

یک گزارش تعریف شده توسط یک عبارت جستجو را بازیابی می کند. پاسخ ممکن است دارای ردیف های کمتری نسبت به page_size باشد. برای تعیین اینکه آیا ردیف های بیشتری برای درخواست وجود دارد یا خیر، به next_page_token تکیه کنید.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/content

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

BestSellersBrandView

فیلدهای موجود برای پرس و جو در جدول best_sellers_brand_view .

گزارش پرفروش ها با برندهای برتر.

مقادیر فقط برای فیلدهایی که به صراحت در عبارت جستجوی درخواست درخواست شده اند تنظیم می شوند.

زمینه های
report_date

Date

تاریخ گزارش. مقدار این فیلد فقط می تواند یکی از موارد زیر باشد:

  • اولین روز هفته (دوشنبه) برای گزارش های هفتگی،
  • اولین روز ماه برای گزارش های ماهانه.

در بند SELECT مورد نیاز است. اگر شرط WHERE در report_date در پرس و جو مشخص نشده باشد، آخرین گزارش هفتگی یا ماهانه موجود برگردانده می شود.

report_granularity

ReportGranularityEnum

جزئیات گزارش رتبه بندی را می توان در بازه زمانی یک هفته یا یک ماه انجام داد.

در بند SELECT مورد نیاز است. شرط report_granularity در بند WHERE الزامی است.

report_country_code

string

کشوری که رتبه در آن محاسبه می شود. در قالب ISO 3166 ارائه شده است.

در بند SELECT مورد نیاز است. شرط report_country_code در بند WHERE الزامی است.

report_category_id

int64

شناسه دسته‌بندی محصول Google برای محاسبه رتبه‌بندی، که در طبقه‌بندی محصولات Google نشان داده شده است.

در بند SELECT مورد نیاز است. اگر شرط WHERE در report_category_id در پرس و جو مشخص نشده باشد، رتبه‌بندی برای همه دسته‌های سطح بالا بازگردانده می‌شود.

brand

string

نام برند.

rank

int64

محبوبیت برند در تبلیغات و سطوح ارگانیک، در دسته بندی و کشور انتخابی، بر اساس تعداد تخمینی تعداد واحدهای فروخته شده.

previous_rank

int64

رتبه محبوبیت در هفته یا ماه قبل.

relative_demand

RelativeDemandEnum

تقاضای تخمینی در رابطه با نام تجاری با بالاترین رتبه محبوبیت در همان دسته و کشور.

previous_relative_demand

RelativeDemandEnum

تقاضای تخمینی در رابطه با نام تجاری با بالاترین رتبه محبوبیت در همان دسته و کشور در هفته یا ماه قبل.

relative_demand_change

RelativeDemandChangeTypeEnum

تغییر در تقاضای تخمینی خواه بالا آمد، غرق شد یا صاف ماند.

پرفروش ترین محصولClusterView

فیلدهای موجود برای پرس و جو در جدول best_sellers_product_cluster_view .

گزارش پرفروش‌ها با خوشه‌های محصولات برتر. خوشه محصول گروهی برای پیشنهادات و انواع مختلف است که نشان دهنده یک محصول است، به عنوان مثال، Google Pixel 7.

مقادیر فقط برای فیلدهایی که به صراحت در عبارت جستجوی درخواست درخواست شده اند تنظیم می شوند.

زمینه های
report_date

Date

تاریخ گزارش. مقدار این فیلد فقط می تواند یکی از موارد زیر باشد:

  • اولین روز هفته (دوشنبه) برای گزارش های هفتگی،
  • اولین روز ماه برای گزارش های ماهانه.

در بند SELECT مورد نیاز است. اگر شرط WHERE در report_date در پرس و جو مشخص نشده باشد، آخرین گزارش هفتگی یا ماهانه موجود برگردانده می شود.

variant_gtins[]

string

GTIN انواع نمونه از خوشه محصول.

report_granularity

ReportGranularityEnum

جزئیات گزارش رتبه بندی را می توان در بازه زمانی یک هفته یا یک ماه انجام داد.

در بند SELECT مورد نیاز است. شرط report_granularity در بند WHERE الزامی است.

report_country_code

string

کشوری که رتبه در آن محاسبه می شود. در قالب ISO 3166 ارائه شده است.

در بند SELECT مورد نیاز است. شرط report_country_code در بند WHERE الزامی است.

report_category_id

int64

شناسه دسته‌بندی محصول Google برای محاسبه رتبه‌بندی، که در طبقه‌بندی محصولات Google نشان داده شده است.

در بند SELECT مورد نیاز است. اگر شرط WHERE در report_category_id در پرس و جو مشخص نشده باشد، رتبه‌بندی برای همه دسته‌های سطح بالا بازگردانده می‌شود.

title

string

عنوان خوشه محصول.

brand

string

نام تجاری خوشه محصول.

category_l1

string

دسته محصول (سطح 1) خوشه محصول، که در طبقه بندی محصولات Google نشان داده شده است.

category_l2

string

دسته محصول (سطح دوم) خوشه محصول، که در طبقه بندی محصولات Google نشان داده شده است.

category_l3

string

دسته محصول (سطح سوم) خوشه محصول، که در طبقه بندی محصولات Google نشان داده شده است.

category_l4

string

دسته محصول (سطح 4) خوشه محصول، که در طبقه بندی محصولات Google نشان داده شده است.

category_l5

string

دسته محصول (سطح 5) خوشه محصول، که در طبقه بندی محصولات Google نشان داده شده است.

inventory_status

InventoryStatus

چه خوشه محصول در منبع داده محصول شما حداقل در یکی از کشورها IN_STOCK باشد، چه در منبع داده محصول شما در همه کشورها OUT_OF_STOCK یا اصلاً NOT_IN_INVENTORY .

این فیلد فیلتر کشور گزارش پرفروش‌ترین‌ها را در نظر نمی‌گیرد.

brand_inventory_status

InventoryStatus

خواه حداقل یک محصول از نام تجاری در حال حاضر IN_STOCK در منبع داده محصول شما در حداقل یکی از کشورها وجود داشته باشد، همه محصولات در منبع داده محصول شما در همه کشورها OUT_OF_STOCK هستند یا NOT_IN_INVENTORY .

این فیلد فیلتر کشور گزارش پرفروش‌ترین‌ها را در نظر نمی‌گیرد.

rank

int64

محبوبیت خوشه محصول در تبلیغات و سطوح ارگانیک، در دسته و کشور انتخاب شده، بر اساس تعداد تخمینی تعداد واحدهای فروخته شده.

previous_rank

int64

رتبه محبوبیت در هفته یا ماه قبل.

relative_demand

RelativeDemandEnum

برآورد تقاضا در رابطه با خوشه محصول با بالاترین رتبه محبوبیت در همان دسته و کشور.

previous_relative_demand

RelativeDemandEnum

تقاضای تخمینی در رابطه با خوشه محصول با بالاترین رتبه محبوبیت در همان دسته و کشور در هفته یا ماه قبل.

relative_demand_change

RelativeDemandChangeTypeEnum

تغییر در تقاضای تخمینی خواه بالا آمد، غرق شد یا صاف ماند.

وضعیت موجودی

وضعیت خوشه محصول یا نام تجاری در موجودی شما.

Enums
INVENTORY_STATUS_UNSPECIFIED مشخص نشده است.
IN_STOCK شما محصولی برای این خوشه محصول یا برند در انبار دارید.
OUT_OF_STOCK شما محصولی برای این خوشه محصول یا نام تجاری در موجودی دارید اما در حال حاضر موجود نیست.
NOT_IN_INVENTORY شما محصولی برای این خوشه محصول یا نام تجاری در موجودی ندارید.

CompetitiveVisibilityBenchmarkView

فیلدهای موجود برای پرس و جو در جدول competitive_visibility_benchmark_view .

گزارش دید رقابتی با معیار دسته بندی.

مقادیر فقط برای فیلدهایی که به صراحت در عبارت جستجوی درخواست درخواست شده اند تنظیم می شوند.

زمینه های
date

Date

تاریخ این ردیف.

در بند SELECT مورد نیاز است. شرط date در بند WHERE الزامی است.

report_country_code

string

کشوری که برداشت ها ظاهر شد.

در بند SELECT مورد نیاز است. شرط report_country_code در بند WHERE الزامی است.

report_category_id

int64

شناسه دسته محصول Google برای محاسبه گزارش، که در طبقه بندی محصولات Google نشان داده شده است.

در بند SELECT مورد نیاز است. یک شرط در report_category_id در عبارت WHERE مورد نیاز است.

traffic_source

TrafficSourceEnum

منبع ترافیک برداشت ها

در بند SELECT مورد نیاز است.

your_domain_visibility_trend

double

تغییر نمایان بودن بر اساس نمایش‌های دامنه شما با توجه به شروع محدوده زمانی انتخابی (یا روز اول با نمایش‌های غیر صفر).

در بند "WHERE" نمی توان آن را فیلتر کرد.

category_benchmark_visibility_trend

double

تغییر در دید بر اساس برداشت‌ها با توجه به شروع محدوده زمانی انتخاب‌شده (یا روز اول با نمایش‌های غیرصفر) برای مجموعه ترکیبی از بازرگانان با بیشترین دید تقریبی بازار.

در بند "WHERE" نمی توان آن را فیلتر کرد.

CompetitiveVisibilityCompetitorView

فیلدهای موجود برای پرس و جو در جدول competitive_visibility_competitor_view .

گزارش دید رقابتی با مشاغل با دید مشابه.

مقادیر فقط برای فیلدهایی که به صراحت در عبارت جستجوی درخواست درخواست شده اند تنظیم می شوند.

زمینه های
date

Date

تاریخ این ردیف.

شرط date در بند WHERE الزامی است.

domain

string

اگر «is_your_domain» درست باشد، دامنه رقیب یا دامنه شما.

در بند SELECT مورد نیاز است. در بند "WHERE" نمی توان آن را فیلتر کرد.

is_your_domain

bool

درست است اگر این ردیف حاوی داده های دامنه شما باشد.

در بند "WHERE" نمی توان آن را فیلتر کرد.

report_country_code

string

کشوری که برداشت ها ظاهر شد.

در بند SELECT مورد نیاز است. شرط report_country_code در بند WHERE الزامی است.

report_category_id

int64

شناسه دسته محصول Google برای محاسبه گزارش، که در طبقه‌بندی محصولات Google نشان داده شده است.

در بند SELECT مورد نیاز است. شرط report_category_id در عبارت WHERE لازم است.

traffic_source

TrafficSourceEnum

منبع ترافیک برداشت ها

در بند SELECT مورد نیاز است.

rank

int64

موقعیت دامنه در رتبه‌بندی کسب‌وکارهای مشابه برای کلیدهای انتخابی ( date ، report_category_id ، report_country_code ، traffic_source ) بر اساس برداشت‌ها. 1 بالاترین است.

در بند "WHERE" نمی توان آن را فیلتر کرد.

ads_organic_ratio

double

نسبت تبلیغات/ارگانیک نشان می‌دهد که دامنه در مقایسه با ترافیک ارگانیک چقدر از آگهی‌های خرید بازدید می‌کند. عدد گرد و سطل شده است.

در بند "WHERE" نمی توان آن را فیلتر کرد.

page_overlap_rate

double

نرخ همپوشانی صفحه نشان می‌دهد که چقدر پیشنهادات خرده‌فروشان رقیب همراه با پیشنهادات شما در یک صفحه نشان داده می‌شوند.

در بند "WHERE" نمی توان آن را فیلتر کرد.

higher_position_rate

double

نرخ موقعیت بالاتر نشان می دهد که هر چند وقت یکبار پیشنهاد یک رقیب در موقعیت بالاتری نسبت به پیشنهاد شما در صفحه قرار می گیرد.

در بند "WHERE" نمی توان آن را فیلتر کرد.

relative_visibility

double

دید نسبی نشان می دهد که پیشنهادات رقبای شما در مقایسه با پیشنهادات شما چند بار نشان داده می شود. به عبارت دیگر، این تعداد نمایش‌های نمایش‌داده‌شده از یک خرده‌فروش رقیب تقسیم بر تعداد نمایش‌های نمایش‌داده‌شده شما در یک بازه زمانی انتخاب‌شده برای یک دسته محصول و کشور انتخاب‌شده است.

در بند "WHERE" نمی توان آن را فیلتر کرد.

CompetitiveVisibilityTopMerchantView

فیلدهای موجود برای پرس و جو در جدول competitive_visibility_top_merchant_view .

گزارش دید رقابتی با کسب و کار با بالاترین دید.

مقادیر فقط برای فیلدهایی که به صراحت در عبارت جستجوی درخواست درخواست شده اند تنظیم می شوند.

زمینه های
date

Date

تاریخ این ردیف.

نمی توان در بند SELECT انتخاب کرد. شرط date در بند WHERE الزامی است.

domain

string

اگر «is_your_domain» درست باشد، دامنه رقیب یا دامنه شما.

در بند SELECT مورد نیاز است. در بند "WHERE" نمی توان آن را فیلتر کرد.

is_your_domain

bool

درست است اگر این ردیف حاوی داده های دامنه شما باشد.

در بند "WHERE" نمی توان آن را فیلتر کرد.

report_country_code

string

کشوری که برداشت ها ظاهر شد.

در بند SELECT مورد نیاز است. شرط report_country_code در بند WHERE الزامی است.

report_category_id

int64

شناسه دسته محصول Google برای محاسبه گزارش، که در طبقه بندی محصولات Google نشان داده شده است.

در بند SELECT مورد نیاز است. یک شرط در report_category_id در عبارت WHERE مورد نیاز است.

traffic_source

TrafficSourceEnum

منبع ترافیک برداشت ها

در بند SELECT مورد نیاز است.

rank

int64

موقعیت دامنه در رتبه‌بندی تاجران برتر برای کلیدهای انتخابی ( date ، report_category_id ، report_country_code ، traffic_source ) بر اساس برداشت‌ها. 1 بالاترین است.

در بند "WHERE" قابل فیلتر نیست.

ads_organic_ratio

double

نسبت تبلیغات/ارگانیک نشان می‌دهد که دامنه در مقایسه با ترافیک ارگانیک چقدر از آگهی‌های خرید بازدید می‌کند. عدد گرد و سطل شده است.

در بند "WHERE" نمی توان آن را فیلتر کرد.

page_overlap_rate

double

نرخ همپوشانی صفحه نشان می‌دهد که چقدر پیشنهادات خرده‌فروشان رقیب همراه با پیشنهادات شما در یک صفحه نشان داده می‌شوند.

در بند "WHERE" نمی توان آن را فیلتر کرد.

higher_position_rate

double

نرخ موقعیت بالاتر نشان می دهد که هر چند وقت یکبار پیشنهاد یک رقیب در موقعیت بالاتری نسبت به پیشنهاد شما در صفحه قرار می گیرد.

در بند "WHERE" نمی توان آن را فیلتر کرد.

روش بازاریابی

این نوع هیچ فیلدی ندارد.

روش بازاریابی مورد استفاده برای تبلیغ محصولات شما در گوگل (ارگانیک در مقابل تبلیغات).

MarketingMethodEnum

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

Enums
MARKETING_METHOD_ENUM_UNSPECIFIED مشخص نشده است.
ORGANIC بازاریابی ارگانیک
ADS بازاریابی مبتنی بر تبلیغات

NonProductPerformanceView

فیلدهای موجود برای درخواست در جدول non_product_performance_view .

داده های عملکرد در تصاویر و لینک های فروشگاه آنلاین منتهی به صفحات غیر محصول شما. این شامل معیارهای عملکرد (به عنوان مثال، clicks ) و ابعادی است که معیارهای عملکرد بر اساس آن‌ها تقسیم‌بندی می‌شوند (به عنوان مثال، date ).

فیلدهای بخش را نمی توان در جستارها بدون انتخاب حداقل یک فیلد متریک انتخاب کرد.

مقادیر فقط برای فیلدهایی که به صراحت در عبارت جستجوی درخواست درخواست شده اند تنظیم می شوند.

زمینه های
date

Date

تاریخ در منطقه زمانی تاجر که معیارها برای آن اعمال می‌شود. بخش.

شرط date در بند WHERE الزامی است.

week

Date

اولین روز هفته (دوشنبه) تاریخ معیارها در منطقه زمانی تاجر. بخش.

clicks

int64

تعداد کلیک بر روی تصاویر و لینک های فروشگاه آنلاین منتهی به صفحات غیر محصول شما. متریک.

impressions

int64

تعداد دفعاتی که تصاویر و لینک‌های فروشگاه آنلاین منتهی به صفحات غیرمحصولی شما نشان داده شده‌اند. متریک.

click_through_rate

double

نرخ کلیک - تعداد کلیک‌ها ( clicks ) تقسیم بر تعداد نمایش‌ها ( impressions ) تصاویر و لینک‌های فروشگاه آنلاین منتهی به صفحات غیر محصول شما. متریک.

قیمت رقابتی محصول View

فیلدهای موجود برای درخواست در جدول price_competitiveness_product_view .

گزارش رقابت قیمت

مقادیر فقط برای فیلدهایی که به صراحت در عبارت جستجوی درخواست درخواست شده اند تنظیم می شوند.

زمینه های
price

Price

قیمت فعلی محصول

benchmark_price

Price

آخرین معیار قیمت موجود برای کاتالوگ محصول در کشور معیار.

report_country_code

string

کشور معیار قیمت در قالب ISO 3166 ارائه شده است.

در بند SELECT مورد نیاز است.

id

string

REST ID محصول، به شکل channel~languageCode~feedLabel~offerId . می توان برای پیوستن داده ها به جدول product_view استفاده کرد.

در بند SELECT مورد نیاز است.

offer_id

string

شناسه محصول ارائه شده توسط تاجر.

title

string

عنوان محصول.

brand

string

نام تجاری محصول.

category_l1

string

دسته بندی محصول (سطح 1) در طبقه بندی محصولات Google .

category_l2

string

دسته بندی محصول (سطح دوم) در طبقه بندی محصولات گوگل .

category_l3

string

دسته بندی محصول (سطح 3) در طبقه بندی محصولات Google .

category_l4

string

دسته بندی محصول (سطح 4) در طبقه بندی محصولات گوگل .

category_l5

string

دسته بندی محصول (سطح 5) در طبقه بندی محصولات گوگل .

product_type_l1

string

نوع محصول (سطح 1) در طبقه بندی محصولات خود بازرگان.

product_type_l2

string

نوع محصول (سطح دوم) در طبقه بندی محصولات خود بازرگان.

product_type_l3

string

نوع محصول (سطح 3) در طبقه بندی محصولات خود بازرگان.

product_type_l4

string

نوع محصول (سطح 4) در طبقه بندی محصولات خود بازرگان.

product_type_l5

string

نوع محصول (سطح 5) در طبقه بندی محصولات خود بازرگان.

PriceInsightsProductView

فیلدهای موجود برای درخواست در جدول price_insights_product_view .

گزارش بینش قیمت

مقادیر فقط برای فیلدهایی که به صراحت در عبارت جستجوی درخواست درخواست شده اند تنظیم می شوند.

زمینه های
price

Price

قیمت فعلی محصول

suggested_price

Price

آخرین قیمت پیشنهادی برای محصول

effectiveness

Effectiveness

اثربخشی پیش‌بینی‌شده اعمال پیشنهاد قیمت، سطل شده است.

id

string

REST ID محصول، به شکل channel~languageCode~feedLabel~offerId . می توان از آن برای پیوستن داده ها به جدول product_view استفاده کرد.

در بند SELECT مورد نیاز است.

offer_id

string

شناسه محصول ارائه شده توسط تاجر.

title

string

عنوان محصول.

brand

string

نام تجاری محصول.

category_l1

string

دسته بندی محصول (سطح 1) در طبقه بندی محصولات Google .

category_l2

string

دسته بندی محصول (سطح دوم) در طبقه بندی محصولات Google .

category_l3

string

دسته بندی محصول (سطح 3) در طبقه بندی محصولات گوگل .

category_l4

string

دسته بندی محصول (سطح 4) در طبقه بندی محصولات گوگل .

category_l5

string

دسته بندی محصول (سطح 5) در طبقه بندی محصولات گوگل .

product_type_l1

string

نوع محصول (سطح 1) در طبقه بندی محصولات خود بازرگان.

product_type_l2

string

نوع محصول (سطح دوم) در طبقه بندی محصولات خود بازرگان.

product_type_l3

string

نوع محصول (سطح سوم) در طبقه بندی محصولات خود بازرگان.

product_type_l4

string

نوع محصول (سطح 4) در طبقه بندی محصولات خود بازرگان.

product_type_l5

string

نوع محصول (سطح 5) در طبقه بندی محصولات خود بازرگان.

predicted_impressions_change_fraction

double

پیش بینی تغییر در نمایش ها به صورت کسری پس از معرفی قیمت پیشنهادی در مقایسه با قیمت فعال فعلی. به عنوان مثال، 0.05 یک افزایش 5 درصدی پیش بینی شده در نمایش ها است.

predicted_clicks_change_fraction

double

پیش بینی تغییر در کلیک ها به صورت کسری پس از معرفی قیمت پیشنهادی نسبت به قیمت فعال فعلی. به عنوان مثال، 0.05 یک افزایش 5٪ ​​پیش بینی شده در کلیک است.

predicted_conversions_change_fraction

double

پیش بینی تغییر در تبدیل به صورت کسری پس از معرفی قیمت پیشنهادی در مقایسه با قیمت فعال فعلی. به عنوان مثال، 0.05 یک افزایش 5٪ ​​پیش بینی شده در تبدیل است).

اثربخشی

سطل اثربخشی پیش بینی شده

اثربخشی نشان می دهد که کدام محصولات بیشتر از تغییرات قیمت سود می برند. این رتبه بندی افزایش عملکرد پیش بینی شده با تعدیل قیمت فروش و تفاوت بین قیمت فعلی شما و قیمت پیشنهادی را در نظر می گیرد. پیش‌بینی می‌شود پیشنهادات قیمت با اثربخشی HIGH بیشترین افزایش عملکرد را به همراه داشته باشد.

Enums
EFFECTIVENESS_UNSPECIFIED اثربخشی ناشناخته است.
LOW اثربخشی پایین است.
MEDIUM اثربخشی متوسط ​​است.
HIGH اثربخشی بالاست.

Product PerformanceView

فیلدهای موجود برای پرس و جو در جدول product_performance_view .

داده‌های عملکرد محصول برای حساب شما، از جمله معیارهای عملکرد (به عنوان مثال، clicks ) و ابعادی که بر اساس آن معیارهای عملکرد بخش‌بندی می‌شوند (به عنوان مثال، offer_id ). مقادیر ابعاد محصول، مانند offer_id ، وضعیت یک محصول را در زمان نمایش نشان می‌دهد.

فیلدهای بخش را نمی توان در جستارها بدون انتخاب حداقل یک فیلد متریک انتخاب کرد.

مقادیر فقط برای فیلدهایی که به صراحت در عبارت جستجوی درخواست درخواست شده اند تنظیم می شوند.

زمینه های
date

Date

تاریخ در منطقه زمانی تاجر که معیارها برای آن اعمال می‌شود. بخش.

شرط date در بند WHERE الزامی است.

week

Date

اولین روز هفته (دوشنبه) تاریخ معیارها در منطقه زمانی تاجر. بخش.

conversion_value

Price

ارزش تبدیل های منتسب به محصول، در تاریخ تبدیل گزارش شده است. متریک.

فقط برای منبع ترافیک FREE موجود است.

marketing_method

MarketingMethodEnum

روش بازاریابی که معیارها برای آن اعمال می شود. بخش.

customer_country_code

string

کد کشوری که مشتری در زمان رویداد در آن قرار دارد. در قالب ISO 3166 ارائه شده است. بخش.

اگر کشور مشتری را نتوان تعیین کرد، یک کد ویژه 'ZZ' برگردانده می شود.

offer_id

string

شناسه محصول ارائه شده توسط تاجر. بخش.

title

string

عنوان محصول. بخش.

brand

string

نام تجاری محصول. بخش.

category_l1

string

دسته بندی محصول (سطح 1) در طبقه بندی محصولات گوگل. بخش.

category_l2

string

دسته بندی محصول (سطح دوم) در طبقه بندی محصولات گوگل. بخش.

category_l3

string

دسته بندی محصول (سطح 3) در طبقه بندی محصولات گوگل. بخش.

category_l4

string

دسته بندی محصولات (سطح 4) در طبقه بندی محصولات گوگل. بخش.

category_l5

string

دسته بندی محصول (سطح 5) در طبقه بندی محصولات گوگل. بخش.

product_type_l1

string

نوع محصول (سطح 1) در طبقه بندی محصولات خود بازرگان. بخش.

product_type_l2

string

نوع محصول (سطح دوم) در طبقه بندی محصولات خود بازرگان. بخش.

product_type_l3

string

نوع محصول (سطح 3) در طبقه بندی محصولات خود بازرگان. بخش.

product_type_l4

string

نوع محصول (سطح 4) در طبقه بندی محصولات خود بازرگان. بخش.

product_type_l5

string

نوع محصول (سطح 5) در طبقه بندی محصولات خود بازرگان. بخش.

custom_label0

string

برچسب سفارشی 0 برای گروه بندی سفارشی محصولات. بخش.

custom_label1

string

برچسب سفارشی 1 برای گروه بندی سفارشی محصولات. بخش.

custom_label2

string

برچسب سفارشی 2 برای گروه بندی سفارشی محصولات. بخش.

custom_label3

string

برچسب سفارشی 3 برای گروه بندی سفارشی محصولات. بخش.

custom_label4

string

برچسب سفارشی 4 برای گروه بندی سفارشی محصولات. بخش.

clicks

int64

تعداد کلیک ها متریک.

impressions

int64

تعداد دفعاتی که محصولات تاجر نشان داده می شود. متریک.

click_through_rate

double

نرخ کلیک - تعداد کلیک‌هایی که محصولات تاجر دریافت می‌کنند (کلیک‌ها) تقسیم بر تعداد دفعاتی که محصولات نشان داده می‌شوند (نمایش‌ها). متریک.

conversions

double

تعداد تبدیل‌های منتسب به محصول، گزارش‌شده در تاریخ تبدیل. بسته به مدل انتساب، یک تبدیل ممکن است بین چند کلیک توزیع شود، جایی که هر کلیک اعتبار خود را به خود اختصاص می دهد. این متریک مجموع تمام این اعتبارات است. متریک.

فقط برای منبع ترافیک FREE موجود است.

conversion_rate

double

تعداد تبدیل‌ها تقسیم بر تعداد کلیک‌ها، گزارش‌شده در تاریخ نمایش. متریک.

فقط برای منبع ترافیک FREE موجود است.

ProductView

فیلدهای موجود برای پرس و جو در جدول product_view .

محصولات موجود در موجودی فعلی محصولات موجود در این جدول مانند محصولات فرعی API هستند، اما همه ویژگی‌های محصول از API فرعی محصولات برای جستجو در این جدول موجود نیستند. برخلاف محصولات فرعی API، این جدول اجازه می دهد تا لیست برگشتی محصولات را بر اساس ویژگی های محصول فیلتر کنید. برای بازیابی یک محصول واحد با id یا فهرست کردن همه محصولات، API فرعی محصولات باید استفاده شود.

مقادیر فقط برای فیلدهایی که به صراحت در عبارت جستجوی درخواست درخواست شده اند تنظیم می شوند.

زمینه های
price

Price

قیمت کالا. در صورتی که اطلاعاتی در مورد قیمت محصول در دسترس نباشد، وجود ندارد.

gtin[]

string

فهرست شماره‌های کالاهای تجاری جهانی (GTIN) محصول.

creation_time

Timestamp

زمانی که تاجر محصول را ایجاد کرد در ثانیه مُهر زمانی.

expiration_date

Date

تاریخ انقضا برای محصول، درج شده است.

item_issues[]

ItemIssue

لیست مشکلات اقلام برای محصول

از این فیلد نمی توان برای مرتب سازی نتایج استفاده کرد.

فقط ویژگی های انتخاب شده از این فیلد (به عنوان مثال، item_issues.severity.aggregated_severity ) می تواند برای فیلتر کردن نتایج استفاده شود.

click_potential

ClickPotential

پتانسیل عملکرد تخمینی در مقایسه با محصولات با بالاترین عملکرد تاجر.

id

string

شناسه REST محصول، به شکل channel~languageCode~feedLabel~offerId . روش‌های Merchant API که روی محصولات کار می‌کنند این را به عنوان پارامتر name خود می‌گیرند.

در بند SELECT مورد نیاز است.

channel

ChannelEnum

کانال محصول می تواند ONLINE یا LOCAL باشد.

language_code

string

کد زبان محصول در قالب BCP 47.

feed_label

string

برچسب خوراک محصول

offer_id

string

شناسه محصول ارائه شده توسط تاجر.

title

string

عنوان محصول.

brand

string

نام تجاری محصول.

category_l1

string

دسته بندی محصول (سطح 1) در طبقه بندی محصولات Google .

category_l2

string

دسته بندی محصول (سطح دوم) در طبقه بندی محصولات گوگل .

category_l3

string

دسته بندی محصول (سطح 3) در طبقه بندی محصولات Google .

category_l4

string

دسته بندی محصول (سطح 4) در طبقه بندی محصولات گوگل .

category_l5

string

دسته بندی محصول (سطح 5) در طبقه بندی محصولات گوگل .

product_type_l1

string

نوع محصول (سطح 1) در طبقه بندی محصولات خود بازرگان.

product_type_l2

string

نوع محصول (سطح دوم) در طبقه بندی محصولات خود بازرگان.

product_type_l3

string

نوع محصول (سطح 3) در طبقه بندی محصولات خود بازرگان.

product_type_l4

string

نوع محصول (سطح 4) در طبقه بندی محصولات خود بازرگان.

product_type_l5

string

نوع محصول (سطح 5) در طبقه بندی محصولات خود بازرگان.

condition

string

وضعیت محصول.

availability

string

در دسترس بودن محصول.

shipping_label

string

برچسب حمل و نقل عادی مشخص شده در منبع داده.

item_group_id

string

شناسه گروه مورد توسط بازرگان برای گروه بندی انواع با هم ارائه شده است.

aggregated_reporting_context_status

AggregatedReportingContextStatus

وضعیت تجمیع شده

click_potential_rank

int64

رتبه بندی محصول بر اساس پتانسیل کلیک آن. محصولی با click_potential_rank 1 دارای بالاترین پتانسیل کلیک در میان محصولات تاجر است که شرایط درخواست جستجو را برآورده می کند.

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

ItemIssueType

نوع مسئله مورد

severity

ItemIssueSeverity

شدت موضوع مورد

resolution

ItemIssueResolution

حل مشکل مورد

ItemIssueResolution

چگونه مسئله را حل کنیم.

Enums
ITEM_ISSUE_RESOLUTION_UNSPECIFIED مشخص نشده است.
MERCHANT_ACTION تاجر باید مشکل را برطرف کند.
PENDING_PROCESSING مشکل به طور خودکار (مثلاً خزیدن تصویر) یا از طریق بررسی Google حل خواهد شد. در حال حاضر هیچ اقدام تجاری لازم نیست. وضوح ممکن است به مشکل دیگری منجر شود (به عنوان مثال، اگر خزیدن با شکست مواجه شود).

ItemIssueSeverity

این موضوع چگونه بر ارائه محصول تأثیر می گذارد.

زمینه های
severity_per_reporting_context[]

IssueSeverityPerReportingContext

شدت موضوع در زمینه گزارش.

aggregated_severity

AggregatedIssueSeverity

شدت تجمیع موضوع برای همه زمینه های گزارشگری که بر آن تأثیر می گذارد.

از این فیلد می توان برای فیلتر کردن نتایج استفاده کرد.

AggregatedIssueSeverity

شدت موضوع برای همه زمینه های گزارش جمع آوری شده است.

Enums
AGGREGATED_ISSUE_SEVERITY_UNSPECIFIED مشخص نشده است.
DISAPPROVED مشکل حداقل در یک زمینه گزارش، محصول را تأیید نمی کند.
DEMOTED Issue محصول را در تمام زمینه های گزارشی که تحت تأثیر قرار می دهد، تنزل می دهد.
PENDING حل مشکل PENDING_PROCESSING است.

IssueSeverityPerReportingContext

شدت موضوع در زمینه گزارش.

زمینه های
disapproved_countries[]

string

فهرست کشورهای تایید نشده در زمینه گزارش، در قالب ISO 3166 ارائه شده است.

demoted_countries[]

string

فهرست کشورهای تنزل یافته در زمینه گزارش، که در قالب ISO 3166 ارائه شده است.

reporting_context

ReportingContextEnum

زمینه گزارش مشکل در مورد آن اعمال می شود.

ItemIssueType

نوع مقاله.

زمینه های
code

string

کد خطای مشکل، معادل code مربوط به محصولات است.

canonical_attribute

string

نام مشخصه متعارف برای مسائل خاص ویژگی.

تقاضای نسبی

این نوع هیچ فیلدی ندارد.

تقاضای نسبی یک خوشه محصول یا نام تجاری در گزارش بهترین فروشندگان.

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

ProductPerformanceView

فیلدهای موجود برای پرس و جو در جدول product_performance_view .

non_product_performance_view

NonProductPerformanceView

فیلدهای موجود برای درخواست در جدول non_product_performance_view .

product_view

ProductView

فیلدهای موجود برای پرس و جو در جدول product_view .

price_competitiveness_product_view

PriceCompetitivenessProductView

فیلدهای موجود برای درخواست در جدول price_competitiveness_product_view .

price_insights_product_view

PriceInsightsProductView

فیلدهای موجود برای درخواست در جدول price_insights_product_view .

best_sellers_product_cluster_view

BestSellersProductClusterView

فیلدهای موجود برای پرس و جو در جدول best_sellers_product_cluster_view .

best_sellers_brand_view

BestSellersBrandView

فیلدهای موجود برای پرس و جو در جدول best_sellers_brand_view .

competitive_visibility_competitor_view

CompetitiveVisibilityCompetitorView

فیلدهای موجود برای پرس و جو در جدول competitive_visibility_competitor_view .

competitive_visibility_top_merchant_view

CompetitiveVisibilityTopMerchantView

فیلدهای موجود برای پرس و جو در جدول competitive_visibility_top_merchant_view .

competitive_visibility_benchmark_view

CompetitiveVisibilityBenchmarkView

فیلدهای موجود برای پرس و جو در جدول competitive_visibility_benchmark_view .

درخواست جستجو

درخواست پیام برای روش ReportService.Search .

زمینه های
parent

string

ضروری. شناسه حسابی که تماس برقرار می کند. باید یک حساب مستقل یا یک حساب فرعی MCA باشد. قالب: حساب‌ها/{حساب}

query

string

ضروری. کوئری که گزارشی را برای بازیابی تعریف می کند.

برای جزئیات در مورد نحوه ساخت پرس و جو، به راهنمای زبان پرس و جو مراجعه کنید. برای لیست کامل جداول و فیلدهای موجود، به فیلدهای موجود مراجعه کنید.

page_size

int32

اختیاری. تعداد ReportRows برای بازیابی در یک صفحه. پیش‌فرض 1000 است. مقادیر بالای 5000 به 5000 تبدیل می‌شوند.

page_token

string

اختیاری. نشانه صفحه برای بازیابی. اگر مشخص نشده باشد، صفحه اول نتایج برگردانده می شود. برای درخواست صفحه بعدی نتایج، باید از مقدار به دست آمده از next_page_token در پاسخ قبلی استفاده شود.

Search Response

پیام پاسخ برای روش ReportService.Search .

زمینه های
results[]

ReportRow

ردیف هایی که با عبارت جستجو مطابقت دارند.

next_page_token

string

نشانه ای که می تواند به عنوان page_token برای بازیابی صفحه بعدی ارسال شود. اگر حذف شود، هیچ صفحه بعدی وجود ندارد.

منبع ترافیک

این نوع هیچ فیلدی ندارد.

منبع ترافیک برداشت‌ها در گزارش دید رقابتی.

TrafficSourceEnum

مقادیر منبع ترافیک

Enums
TRAFFIC_SOURCE_ENUM_UNSPECIFIED مشخص نشده است.
ORGANIC ترافیک ارگانیک
ADS ترافیک از تبلیغات
ALL ترافیک ارگانیک و تبلیغات