Method: accounts.reports.search

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

درخواست HTTP

POST https://merchantapi.googleapis.com/reports/v1beta/{parent=accounts/*}/reports:search

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
parent

string

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

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "query": string,
  "pageSize": integer,
  "pageToken": string
}
زمینه های
query

string

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

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

pageSize

integer

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

pageToken

string

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

بدن پاسخگو

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

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "results": [
    {
      object (ReportRow)
    }
  ],
  "nextPageToken": string
}
زمینه های
results[]

object ( ReportRow )

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

nextPageToken

string

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

محدوده مجوز

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

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

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

ReportRow

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

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

نمایندگی JSON
{
  "productPerformanceView": {
    object (ProductPerformanceView)
  },
  "nonProductPerformanceView": {
    object (NonProductPerformanceView)
  },
  "productView": {
    object (ProductView)
  },
  "priceCompetitivenessProductView": {
    object (PriceCompetitivenessProductView)
  },
  "priceInsightsProductView": {
    object (PriceInsightsProductView)
  },
  "bestSellersProductClusterView": {
    object (BestSellersProductClusterView)
  },
  "bestSellersBrandView": {
    object (BestSellersBrandView)
  },
  "competitiveVisibilityCompetitorView": {
    object (CompetitiveVisibilityCompetitorView)
  },
  "competitiveVisibilityTopMerchantView": {
    object (CompetitiveVisibilityTopMerchantView)
  },
  "competitiveVisibilityBenchmarkView": {
    object (CompetitiveVisibilityBenchmarkView)
  }
}
زمینه های
productPerformanceView

object ( ProductPerformanceView )

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

nonProductPerformanceView

object ( NonProductPerformanceView )

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

productView

object ( ProductView )

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

priceCompetitivenessProductView

object ( PriceCompetitivenessProductView )

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

priceInsightsProductView

object ( PriceInsightsProductView )

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

bestSellersProductClusterView

object ( BestSellersProductClusterView )

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

bestSellersBrandView

object ( BestSellersBrandView )

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

competitiveVisibilityCompetitorView

object ( CompetitiveVisibilityCompetitorView )

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

competitiveVisibilityTopMerchantView

object ( CompetitiveVisibilityTopMerchantView )

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

competitiveVisibilityBenchmarkView

object ( CompetitiveVisibilityBenchmarkView )

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

Product PerformanceView

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

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

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

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

نمایندگی JSON
{
  "date": {
    object (Date)
  },
  "week": {
    object (Date)
  },
  "conversionValue": {
    object (Price)
  },
  "marketingMethod": enum (MarketingMethodEnum),
  "customerCountryCode": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "customLabel0": string,
  "customLabel1": string,
  "customLabel2": string,
  "customLabel3": string,
  "customLabel4": string,
  "clicks": string,
  "impressions": string,
  "clickThroughRate": number,
  "conversions": number,
  "conversionRate": number
}
زمینه های
date

object ( Date )

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

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

week

object ( Date )

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

conversionValue

object ( Price )

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

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

marketingMethod

enum ( MarketingMethodEnum )

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

customerCountryCode

string

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

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

offerId

string

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

title

string

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

brand

string

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

categoryL1

string

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

categoryL2

string

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

categoryL3

string

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

categoryL4

string

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

categoryL5

string

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

productTypeL1

string

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

productTypeL2

string

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

productTypeL3

string

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

productTypeL4

string

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

productTypeL5

string

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

customLabel0

string

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

customLabel1

string

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

customLabel2

string

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

customLabel3

string

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

customLabel4

string

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

clicks

string ( int64 format)

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

impressions

string ( int64 format)

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

clickThroughRate

number

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

conversions

number

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

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

conversionRate

number

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

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

MarketingMethodEnum

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

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

NonProductPerformanceView

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

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

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

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

نمایندگی JSON
{
  "date": {
    object (Date)
  },
  "week": {
    object (Date)
  },
  "clicks": string,
  "impressions": string,
  "clickThroughRate": number
}
زمینه های
date

object ( Date )

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

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

week

object ( Date )

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

clicks

string ( int64 format)

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

impressions

string ( int64 format)

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

clickThroughRate

number

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

ProductView

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

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

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

نمایندگی JSON
{
  "price": {
    object (Price)
  },
  "gtin": [
    string
  ],
  "creationTime": string,
  "expirationDate": {
    object (Date)
  },
  "itemIssues": [
    {
      object (ItemIssue)
    }
  ],
  "clickPotential": enum (ClickPotential),
  "id": string,
  "channel": enum (ChannelEnum),
  "languageCode": string,
  "feedLabel": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "condition": string,
  "availability": string,
  "shippingLabel": string,
  "itemGroupId": string,
  "thumbnailLink": string,
  "aggregatedReportingContextStatus": enum (AggregatedReportingContextStatus),
  "clickPotentialRank": string
}
زمینه های
price

object ( Price )

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

gtin[]

string

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

creationTime

string ( Timestamp format)

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

expirationDate

object ( Date )

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

itemIssues[]

object ( ItemIssue )

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

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

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

clickPotential

enum ( ClickPotential )

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

id

string

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

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

channel

enum ( ChannelEnum )

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

languageCode

string

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

feedLabel

string

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

offerId

string

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

title

string

عنوان محصول.

brand

string

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

categoryL1

string

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

categoryL2

string

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

categoryL3

string

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

categoryL4

string

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

categoryL5

string

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

productTypeL1

string

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

productTypeL2

string

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

productTypeL3

string

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

productTypeL4

string

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

productTypeL5

string

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

condition

string

وضعیت محصول.

availability

string

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

shippingLabel

string

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

itemGroupId

string

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

aggregatedReportingContextStatus

enum ( AggregatedReportingContextStatus )

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

clickPotentialRank

string ( int64 format)

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

AggregatedReportingContextStatus

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

در اینجا مثالی از نحوه محاسبه وضعیت انبوه آورده شده است:

لیست های رایگان تبلیغات خرید وضعیت
تایید شده تایید شده واجد شرایط
تایید شده انتظار واجد شرایط
تایید شده تایید نشد ELIGIBLE_LIMITED
انتظار انتظار انتظار
تایید نشد تایید نشد NOT_ELIGIBLE_OR_DISAPPROVED
Enums
AGGREGATED_REPORTING_CONTEXT_STATUS_UNSPECIFIED مشخص نشده است.
NOT_ELIGIBLE_OR_DISAPPROVED محصول برای همه زمینه‌های گزارش‌دهی واجد شرایط نیست یا تأیید نشده است.
PENDING وضعیت محصول در همه زمینه‌های گزارش‌دهی در انتظار است.
ELIGIBLE_LIMITED محصول برای برخی (اما نه همه) زمینه های گزارش واجد شرایط است.
ELIGIBLE محصول برای همه زمینه های گزارش واجد شرایط است.

ItemIssue

مشکل مورد مرتبط با محصول

نمایندگی JSON
{
  "type": {
    object (ItemIssueType)
  },
  "severity": {
    object (ItemIssueSeverity)
  },
  "resolution": enum (ItemIssueResolution)
}
زمینه های
type

object ( ItemIssueType )

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

severity

object ( ItemIssueSeverity )

شدت موضوع

resolution

enum ( ItemIssueResolution )

حل مشکل مورد

ItemIssueType

نوع مقاله.

نمایندگی JSON
{
  "code": string,
  "canonicalAttribute": string
}
زمینه های
code

string

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

canonicalAttribute

string

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

ItemIssueSeverity

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

نمایندگی JSON
{
  "severityPerReportingContext": [
    {
      object (IssueSeverityPerReportingContext)
    }
  ],
  "aggregatedSeverity": enum (AggregatedIssueSeverity)
}
زمینه های
severityPerReportingContext[]

object ( IssueSeverityPerReportingContext )

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

aggregatedSeverity

enum ( AggregatedIssueSeverity )

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

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

IssueSeverityPerReportingContext

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

نمایندگی JSON
{
  "disapprovedCountries": [
    string
  ],
  "demotedCountries": [
    string
  ],
  "reportingContext": enum (ReportingContextEnum)
}
زمینه های
disapprovedCountries[]

string

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

demotedCountries[]

string

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

reportingContext

enum ( ReportingContextEnum )

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

AggregatedIssueSeverity

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

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

ItemIssueResolution

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

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

پتانسیل کلیک کنید

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

Enums
CLICK_POTENTIAL_UNSPECIFIED تأثیر کلیک‌های پیش‌بینی‌شده ناشناخته.
LOW امکان دریافت تعداد کلیک کم در مقایسه با محصولات تاجر با بالاترین عملکرد.
MEDIUM بالقوه برای دریافت تعداد کلیک متوسط ​​در مقایسه با محصولات با بالاترین عملکرد تاجر.
HIGH پتانسیل دریافت تعداد کلیک مشابه به عنوان محصولات با بالاترین عملکرد تاجر.

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

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

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

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

نمایندگی JSON
{
  "price": {
    object (Price)
  },
  "benchmarkPrice": {
    object (Price)
  },
  "reportCountryCode": string,
  "id": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string
}
زمینه های
price

object ( Price )

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

benchmarkPrice

object ( Price )

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

reportCountryCode

string

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

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

id

string

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

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

offerId

string

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

title

string

عنوان محصول.

brand

string

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

categoryL1

string

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

categoryL2

string

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

categoryL3

string

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

categoryL4

string

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

categoryL5

string

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

productTypeL1

string

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

productTypeL2

string

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

productTypeL3

string

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

productTypeL4

string

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

productTypeL5

string

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

PriceInsightsProductView

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

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

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

نمایندگی JSON
{
  "price": {
    object (Price)
  },
  "suggestedPrice": {
    object (Price)
  },
  "effectiveness": enum (Effectiveness),
  "id": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "predictedImpressionsChangeFraction": number,
  "predictedClicksChangeFraction": number,
  "predictedConversionsChangeFraction": number
}
زمینه های
price

object ( Price )

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

suggestedPrice

object ( Price )

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

effectiveness

enum ( Effectiveness )

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

id

string

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

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

offerId

string

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

title

string

عنوان محصول.

brand

string

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

categoryL1

string

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

categoryL2

string

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

categoryL3

string

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

categoryL4

string

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

categoryL5

string

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

productTypeL1

string

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

productTypeL2

string

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

productTypeL3

string

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

productTypeL4

string

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

productTypeL5

string

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

predictedImpressionsChangeFraction

number

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

predictedClicksChangeFraction

number

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

predictedConversionsChangeFraction

number

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

اثربخشی

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

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

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

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

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

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

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

نمایندگی JSON
{
  "reportDate": {
    object (Date)
  },
  "variantGtins": [
    string
  ],
  "reportGranularity": enum (ReportGranularityEnum),
  "reportCountryCode": string,
  "reportCategoryId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "inventoryStatus": enum (InventoryStatus),
  "brandInventoryStatus": enum (InventoryStatus),
  "rank": string,
  "previousRank": string,
  "relativeDemand": enum (RelativeDemandEnum),
  "previousRelativeDemand": enum (RelativeDemandEnum),
  "relativeDemandChange": enum (RelativeDemandChangeTypeEnum)
}
زمینه های
reportDate

object ( Date )

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

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

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

variantGtins[]

string

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

reportGranularity

enum ( ReportGranularityEnum )

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

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

reportCountryCode

string

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

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

reportCategoryId

string ( int64 format)

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

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

title

string

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

brand

string

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

categoryL1

string

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

categoryL2

string

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

categoryL3

string

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

categoryL4

string

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

categoryL5

string

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

inventoryStatus

enum ( InventoryStatus )

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

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

brandInventoryStatus

enum ( InventoryStatus )

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

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

rank

string ( int64 format)

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

previousRank

string ( int64 format)

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

relativeDemand

enum ( RelativeDemandEnum )

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

previousRelativeDemand

enum ( RelativeDemandEnum )

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

relativeDemandChange

enum ( RelativeDemandChangeTypeEnum )

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

ReportGranularityEnum

مقادیر جزئیات را گزارش کنید.

Enums
REPORT_GRANULARITY_ENUM_UNSPECIFIED مشخص نشده است.
WEEKLY گزارش در بازه زمانی یک هفته محاسبه می شود.
MONTHLY گزارش در بازه زمانی یک ماهه محاسبه می شود.

وضعیت موجودی

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

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

RelativeDemandEnum

مقادیر تقاضای نسبی

Enums
RELATIVE_DEMAND_ENUM_UNSPECIFIED مشخص نشده است.
VERY_LOW تقاضا 0-5% تقاضای خوشه یا برند محصول دارای بالاترین رتبه است.
LOW تقاضا 6 تا 10 درصد تقاضای خوشه یا برند بالاترین رتبه محصول است.
MEDIUM تقاضا 11 تا 20 درصد تقاضای خوشه یا برند محصول با بالاترین رتبه است.
HIGH تقاضا 21 تا 50 درصد تقاضای خوشه یا برند محصول با بالاترین رتبه است.
VERY_HIGH تقاضا 51 تا 100 درصد تقاضای خوشه یا برند محصول با بالاترین رتبه است.

RelativeDemandChangeTypeEnum

مقادیر نوع تغییر تقاضای نسبی.

Enums
RELATIVE_DEMAND_CHANGE_TYPE_ENUM_UNSPECIFIED مشخص نشده است.
SINKER تقاضای نسبی کمتر از دوره زمانی قبلی است.
FLAT تقاضای نسبی برابر با دوره زمانی قبلی است.
RISER تقاضای نسبی بیشتر از دوره زمانی قبلی است.

BestSellersBrandView

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

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

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

نمایندگی JSON
{
  "reportDate": {
    object (Date)
  },
  "reportGranularity": enum (ReportGranularityEnum),
  "reportCountryCode": string,
  "reportCategoryId": string,
  "brand": string,
  "rank": string,
  "previousRank": string,
  "relativeDemand": enum (RelativeDemandEnum),
  "previousRelativeDemand": enum (RelativeDemandEnum),
  "relativeDemandChange": enum (RelativeDemandChangeTypeEnum)
}
زمینه های
reportDate

object ( Date )

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

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

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

reportGranularity

enum ( ReportGranularityEnum )

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

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

reportCountryCode

string

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

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

reportCategoryId

string ( int64 format)

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

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

brand

string

نام برند.

rank

string ( int64 format)

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

previousRank

string ( int64 format)

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

relativeDemand

enum ( RelativeDemandEnum )

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

previousRelativeDemand

enum ( RelativeDemandEnum )

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

relativeDemandChange

enum ( RelativeDemandChangeTypeEnum )

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

CompetitiveVisibilityCompetitorView

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

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

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

نمایندگی JSON
{
  "date": {
    object (Date)
  },
  "domain": string,
  "isYourDomain": boolean,
  "reportCountryCode": string,
  "reportCategoryId": string,
  "trafficSource": enum (TrafficSourceEnum),
  "rank": string,
  "adsOrganicRatio": number,
  "pageOverlapRate": number,
  "higherPositionRate": number,
  "relativeVisibility": number
}
زمینه های
date

object ( Date )

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

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

domain

string

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

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

isYourDomain

boolean

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

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

reportCountryCode

string

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

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

reportCategoryId

string ( int64 format)

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

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

trafficSource

enum ( TrafficSourceEnum )

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

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

rank

string ( int64 format)

موقعیت دامنه در رتبه‌بندی مشاغل مشابه برای کلیدهای انتخابی ( date ، reportCategoryId ، reportCountryCode ، trafficSource ) بر اساس نمایش‌ها. 1 بالاترین است.

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

adsOrganicRatio

number

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

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

pageOverlapRate

number

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

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

higherPositionRate

number

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

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

relativeVisibility

number

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

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

TrafficSourceEnum

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

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

CompetitiveVisibilityTopMerchantView

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

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

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

نمایندگی JSON
{
  "date": {
    object (Date)
  },
  "domain": string,
  "isYourDomain": boolean,
  "reportCountryCode": string,
  "reportCategoryId": string,
  "trafficSource": enum (TrafficSourceEnum),
  "rank": string,
  "adsOrganicRatio": number,
  "pageOverlapRate": number,
  "higherPositionRate": number
}
زمینه های
date

object ( Date )

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

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

domain

string

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

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

isYourDomain

boolean

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

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

reportCountryCode

string

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

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

reportCategoryId

string ( int64 format)

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

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

trafficSource

enum ( TrafficSourceEnum )

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

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

rank

string ( int64 format)

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

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

adsOrganicRatio

number

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

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

pageOverlapRate

number

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

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

higherPositionRate

number

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

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

CompetitiveVisibilityBenchmarkView

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

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

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

نمایندگی JSON
{
  "date": {
    object (Date)
  },
  "reportCountryCode": string,
  "reportCategoryId": string,
  "trafficSource": enum (TrafficSourceEnum),
  "yourDomainVisibilityTrend": number,
  "categoryBenchmarkVisibilityTrend": number
}
زمینه های
date

object ( Date )

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

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

reportCountryCode

string

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

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

reportCategoryId

string ( int64 format)

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

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

trafficSource

enum ( TrafficSourceEnum )

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

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

yourDomainVisibilityTrend

number

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

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

categoryBenchmarkVisibilityTrend

number

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

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