REST Resource: accounts.reports

منبع: 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)
  }
}
فیلدها
product Performance View

object ( ProductPerformanceView )

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

non Product Performance View

object ( NonProductPerformanceView )

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

product View

object ( ProductView )

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

price Competitiveness Product View

object ( PriceCompetitivenessProductView )

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

price Insights Product View

object ( PriceInsightsProductView )

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

best Sellers Product Cluster View

object ( BestSellersProductClusterView )

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

best Sellers Brand View

object ( BestSellersBrandView )

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

competitive Visibility Competitor View

object ( CompetitiveVisibilityCompetitorView )

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

competitive Visibility Top Merchant View

object ( CompetitiveVisibilityTopMerchantView )

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

competitive Visibility Benchmark View

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 )

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

conversion Value

object ( Price )

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

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

marketing Method

enum ( 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

string ( int64 format)

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

impressions

string ( int64 format)

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

click Through Rate

number

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

conversions

number

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

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

conversion Rate

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)

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

click Through Rate

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) محصول.

creation Time

string ( Timestamp format)

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

expiration Date

object ( Date )

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

item Issues[]

object ( ItemIssue )

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

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

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

click Potential

enum ( ClickPotential )

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

id

string

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

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

channel

enum ( 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

دسته بندی محصول (سطح دوم) در طبقه بندی محصولات 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

نوع محصول (سطح 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

enum ( AggregatedReportingContextStatus )

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

click Potential Rank

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 مربوط به محصولات است .

canonical Attribute

string

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

ItemIssueSeverity

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

نمایندگی JSON
{
  "severityPerReportingContext": [
    {
      object (IssueSeverityPerReportingContext)
    }
  ],
  "aggregatedSeverity": enum (AggregatedIssueSeverity)
}
فیلدها
severity Per Reporting Context[]

object ( IssueSeverityPerReportingContext )

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

aggregated Severity

enum ( AggregatedIssueSeverity )

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

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

IssueSeverityPerReportingContext

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

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

string

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

demoted Countries[]

string

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

reporting Context

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 )

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

benchmark Price

object ( Price )

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

report Country Code

string

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

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

id

string

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

در بند 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

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

product Type L4

string

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

product Type L5

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 )

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

suggested Price

object ( Price )

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

effectiveness

enum ( Effectiveness )

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

id

string

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

در بند 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

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

product Type L4

string

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

product Type L5

string

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

predicted Impressions Change Fraction

number

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

predicted Clicks Change Fraction

number

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

predicted Conversions Change Fraction

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)
}
فیلدها
report Date

object ( Date )

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

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

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

variant Gtins[]

string

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

report Granularity

enum ( ReportGranularityEnum )

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

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

report Country Code

string

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

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

report Category Id

string ( int64 format)

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

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

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

enum ( InventoryStatus )

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

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

brand Inventory Status

enum ( InventoryStatus )

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

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

rank

string ( int64 format)

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

previous Rank

string ( int64 format)

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

relative Demand

enum ( RelativeDemandEnum )

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

previous Relative Demand

enum ( RelativeDemandEnum )

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

relative Demand Change

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)
}
فیلدها
report Date

object ( Date )

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

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

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

report Granularity

enum ( ReportGranularityEnum )

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

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

report Country Code

string

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

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

report Category Id

string ( int64 format)

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

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

brand

string

نام برند.

rank

string ( int64 format)

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

previous Rank

string ( int64 format)

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

relative Demand

enum ( RelativeDemandEnum )

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

previous Relative Demand

enum ( RelativeDemandEnum )

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

relative Demand Change

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" نمی توان آن را فیلتر کرد.

is Your Domain

boolean

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

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

report Country Code

string

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

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

report Category Id

string ( int64 format)

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

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

traffic Source

enum ( TrafficSourceEnum )

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

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

rank

string ( int64 format)

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

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

ads Organic Ratio

number

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

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

page Overlap Rate

number

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

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

higher Position Rate

number

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

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

relative Visibility

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" نمی توان آن را فیلتر کرد.

is Your Domain

boolean

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

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

report Country Code

string

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

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

report Category Id

string ( int64 format)

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

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

traffic Source

enum ( TrafficSourceEnum )

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

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

rank

string ( int64 format)

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

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

ads Organic Ratio

number

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

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

page Overlap Rate

number

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

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

higher Position Rate

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 الزامی است.

report Country Code

string

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

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

report Category Id

string ( int64 format)

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

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

traffic Source

enum ( TrafficSourceEnum )

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

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

your Domain Visibility Trend

number

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

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

category Benchmark Visibility Trend

number

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

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

روش ها

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