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)
  }
}
الحقول
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

ProductPerformanceView

الحقول المتاحة لطلب البحث في جدول 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

فئة المنتج (المستوى الأول) في تصنيف المنتجات من Google القسم
categoryL2

string

فئة المنتج (المستوى الثاني) في تصنيف المنتجات من Google القسم
categoryL3

string

فئة المنتج (المستوى الثالث) في تصنيف المنتجات من Google القسم
categoryL4

string

فئة المنتج (المستوى الرابع) في تصنيف المنتجات من Google القسم
categoryL5

string

فئة المنتج (المستوى الخامس) في تصنيف المنتجات من Google القسم
productTypeL1

string

نوع المنتج (المستوى الأول) في تصنيف المنتجات الخاص بالتاجر القسم
productTypeL2

string

نوع المنتج (المستوى الثاني) في تصنيف المنتجات الخاص بالتاجر القسم
productTypeL3

string

نوع المنتج (المستوى الثالث) في تصنيف المنتجات الخاص بالتاجر القسم
productTypeL4

string

نوع المنتج (المستوى الرابع) في تصنيف المنتجات الخاص بالتاجر القسم
productTypeL5

string

نوع المنتج (المستوى الخامس) في تصنيف المنتجات الخاص بالتاجر القسم
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

قيم طريقة التسويق

عمليات التعداد
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

المنتجات المتوفّرة في المستودع الحالي إنّ المنتجات الواردة في هذا الجدول هي نفسها الواردة في واجهة برمجة التطبيقات الفرعية Products، ولكن لا تتوفّر بعض سمات المنتجات من واجهة برمجة التطبيقات الفرعية Products للاستعلام عنها في هذا الجدول. على عكس واجهة برمجة التطبيقات الفرعية Products، يسمح هذا الجدول بفلترة قائمة المنتجات المعروضة حسب سمات المنتجات. لاسترداد منتج واحد حسب id أو إدراج جميع المنتجات، يجب استخدام واجهة برمجة التطبيقات الفرعية للمنتجات.

لا يتمّ ضبط القيم إلّا للحقول المطلوبة صراحةً في طلب البحث.

تمثيل 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 للمنتج بالتنسيق 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

فئة المنتج (المستوى الأول) في تصنيف المنتجات من Google
categoryL2

string

فئة المنتج (المستوى الثاني) في تصنيف المنتجات من Google
categoryL3

string

فئة المنتج (المستوى الثالث) في تصنيف المنتجات من Google
categoryL4

string

فئة المنتج (المستوى الرابع) في تصنيف المنتجات من Google
categoryL5

string

فئة المنتج (المستوى الخامس) في تصنيف المنتجات من Google
productTypeL1

string

نوع المنتج (المستوى الأول) في تصنيف المنتجات الخاص بالتاجر
productTypeL2

string

نوع المنتج (المستوى الثاني) في تصنيف المنتجات الخاص بالتاجر
productTypeL3

string

نوع المنتج (المستوى الثالث) في تصنيف المنتجات الخاص بالتاجر
productTypeL4

string

نوع المنتج (المستوى الرابع) في تصنيف المنتجات الخاص بالتاجر
productTypeL5

string

نوع المنتج (المستوى الخامس) في تصنيف المنتجات الخاص بالتاجر
condition

string

حالة المنتج
availability

string

مدى توفّر المنتج
shippingLabel

string

تصنيف الشحن المنسَّق المحدّد في مصدر البيانات
itemGroupId

string

معرّف مجموعة السلع الذي يوفّره التاجر لتجميع الأسعار معًا
aggregatedReportingContextStatus

enum (AggregatedReportingContextStatus)

الحالة المجمّعة
clickPotentialRank

string (int64 format)

ترتيب المنتج استنادًا إلى فرص النقر عليه يشير الرقم clickPotentialRank 1 إلى أنّ المنتج يملك أعلى احتمالية للنقر من بين منتجات التاجر التي تستوفي شروط طلب البحث.

AggregatedReportingContextStatus

حالة المنتج المجمّعة لجميع سياقات إعداد التقارير

في ما يلي مثال على كيفية احتساب الحالة المجمّعة:

البيانات المجانية إعلانات Shopping الحالة
Approved Approved مؤهّلة
Approved في انتظار الموافقة مؤهّلة
Approved مرفوض ELIGIBLE_LIMITED
في انتظار الموافقة في انتظار الموافقة في انتظار المراجعة
مرفوض مرفوض NOT_ELIGIBLE_OR_DISAPPROVED
عمليات التعداد
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

يتم تجميع درجة خطورة المشكلة لجميع سياقات إعداد التقارير.

عمليات التعداد
AGGREGATED_ISSUE_SEVERITY_UNSPECIFIED غير محدّد
DISAPPROVED تؤدي المشكلة إلى رفض المنتج في سياق إعداد تقارير واحد على الأقل.
DEMOTED تؤدي المشكلة إلى خفض ترتيب المنتج في جميع سياقات إعداد التقارير التي تتأثّر بها.
PENDING حلّ المشكلة هو PENDING_PROCESSING.

ItemIssueResolution

كيفية حلّ المشكلة

عمليات التعداد
ITEM_ISSUE_RESOLUTION_UNSPECIFIED غير محدّد
MERCHANT_ACTION على التاجر حلّ المشكلة.
PENDING_PROCESSING سيتم حلّ المشكلة تلقائيًا (على سبيل المثال، من خلال الزحف إلى الصور) أو من خلال مراجعة من Google. ليس على التاجر اتّخاذ أي إجراء الآن. قد يؤدي الحلّ إلى حدوث مشكلة أخرى (على سبيل المثال، إذا تعذّر الزحف).

ClickPotential

تقدّر فرص النقر على منتج معيّن الأداء المحتمَل له مقارنةً بمنتجات التاجر الأفضل أداءً. تساعد فرص النقر على منتج معيّن التجّار في تحديد المنتجات التي تتطلّب حلّاً قبل غيرها وفهم الأداء الحالي للمنتجات مقارنةً بإمكانياتها.

عمليات التعداد
CLICK_POTENTIAL_UNSPECIFIED تأثير غير معروف للنقرات المتوقّعة
LOW من المحتمَل جذب عدد منخفض من النقرات مقارنةً بالمنتجات الأعلى أداءً للتاجر.
MEDIUM من المحتمَل جذب عدد متوسط من النقرات مقارنةً بالمنتجات الأعلى أداءً للتاجر.
HIGH من المحتمَل جذب عدد مشابه من النقرات مقارنةً بالمنتجات الأعلى أداءً للتاجر.

PriceCompetitivenessProductView

الحقول المتاحة لطلب البحث في جدول 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 للمنتج بالتنسيق channel~languageCode~feedLabel~offerId. يمكن استخدامها لدمج البيانات مع جدول productView.

مطلوب في عبارة SELECT.
offerId

string

معرّف المنتج الذي يوفّره التاجر
title

string

عنوان المنتج
brand

string

العلامة التجارية للمنتج
categoryL1

string

فئة المنتج (المستوى الأول) في تصنيف المنتجات من Google
categoryL2

string

فئة المنتج (المستوى الثاني) في تصنيف المنتجات من Google
categoryL3

string

فئة المنتج (المستوى الثالث) في تصنيف المنتجات من Google
categoryL4

string

فئة المنتج (المستوى الرابع) في تصنيف المنتجات من Google
categoryL5

string

فئة المنتج (المستوى الخامس) في تصنيف المنتجات من Google
productTypeL1

string

نوع المنتج (المستوى الأول) في تصنيف المنتجات الخاص بالتاجر
productTypeL2

string

نوع المنتج (المستوى الثاني) في تصنيف المنتجات الخاص بالتاجر
productTypeL3

string

نوع المنتج (المستوى الثالث) في تصنيف المنتجات الخاص بالتاجر
productTypeL4

string

نوع المنتج (المستوى الرابع) في تصنيف المنتجات الخاص بالتاجر
productTypeL5

string

نوع المنتج (المستوى الخامس) في تصنيف المنتجات الخاص بالتاجر

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 للمنتج بالتنسيق channel~languageCode~feedLabel~offerId. يمكن استخدامها لدمج البيانات مع جدول productView.

مطلوب في عبارة SELECT.
offerId

string

معرّف المنتج الذي يوفّره التاجر
title

string

عنوان المنتج
brand

string

العلامة التجارية للمنتج
categoryL1

string

فئة المنتج (المستوى الأول) في تصنيف المنتجات من Google
categoryL2

string

فئة المنتج (المستوى الثاني) في تصنيف المنتجات من Google
categoryL3

string

فئة المنتج (المستوى الثالث) في تصنيف المنتجات من Google
categoryL4

string

فئة المنتج (المستوى الرابع) في تصنيف المنتجات من Google
categoryL5

string

فئة المنتج (المستوى الخامس) في تصنيف المنتجات من Google
productTypeL1

string

نوع المنتج (المستوى الأول) في تصنيف المنتجات الخاص بالتاجر
productTypeL2

string

نوع المنتج (المستوى الثاني) في تصنيف المنتجات الخاص بالتاجر
productTypeL3

string

نوع المنتج (المستوى الثالث) في تصنيف المنتجات الخاص بالتاجر
productTypeL4

string

نوع المنتج (المستوى الرابع) في تصنيف المنتجات الخاص بالتاجر
productTypeL5

string

نوع المنتج (المستوى الخامس) في تصنيف المنتجات الخاص بالتاجر
predictedImpressionsChangeFraction

number

التغيير المتوقّع في عدد مرات الظهور ككسر بعد تقديم السعر المقترَح مقارنةً بالسعر الحالي النشط. على سبيل المثال، يشير الرقم 0.05 إلى زيادة متوقّعة في عدد مرات الظهور بنسبة% 5.
predictedClicksChangeFraction

number

التغيير المتوقّع في عدد النقرات ككسر بعد تقديم السعر المقترَح مقارنةً بالسعر الحالي النشط. على سبيل المثال، يشير الرقم 0.05 إلى زيادة متوقّعة في عدد النقرات بنسبة% 5.
predictedConversionsChangeFraction

number

التغيير المتوقّع في الإحالات الناجحة ككسر بعد تقديم السعر المقترَح مقارنةً بالسعر الحالي النشط. على سبيل المثال، يشير الرقم 0.05 إلى زيادة متوقّعة في الإحالات الناجحة بنسبة% 5).

الفاعلية

حزمة الفعالية المتوقّعة

تشير الفعالية إلى المنتجات التي ستستفيد إلى أقصى حدّ من تغيير الأسعار. يأخذ هذا التقييم في الاعتبار تحسّن الأداء المتوقَّع من خلال تعديل السعر المخفَّض والفرق بين السعر الحالي والسعر المقترَح. يُتوقَّع أن تحقّق اقتراحات الأسعار ذات الفعالية HIGH الزيادة الأكبر في مستوى الأداء.

عمليات التعداد
EFFECTIVENESS_UNSPECIFIED لا تتوفّر معلومات عن مدى فعالية هذه الميزة.
LOW الفعالية منخفضة.
MEDIUM تكون الفعالية متوسطة.
HIGH تكون الفعالية عالية.

BestSellersProductClusterView

الحقول المتاحة لطلب البحث في جدول 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

فئة المنتج (المستوى الأول) من مجموعة المنتجات، ممثّلة في تصنيف المنتجات من Google
categoryL2

string

فئة المنتج (المستوى الثاني) لمجموعة المنتجات، ممثّلة في تصنيف المنتجات من Google
categoryL3

string

فئة المنتج (المستوى الثالث) من مجموعة المنتجات، ممثّلة في تصنيف المنتجات من Google
categoryL4

string

فئة المنتج (المستوى الرابع) من مجموعة المنتجات، ممثّلة في تصنيف المنتجات من Google
categoryL5

string

فئة المنتج (المستوى الخامس) لمجموعة المنتجات، ممثّلة في تصنيف المنتجات من 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

قيم دقة التقرير

عمليات التعداد
REPORT_GRANULARITY_ENUM_UNSPECIFIED غير محدّد
WEEKLY يتم احتساب التقرير على مدار إطار زمني أسبوعي.
MONTHLY يتم احتساب التقرير على مدار إطار زمني شهري.

InventoryStatus

حالة مجموعة المنتجات أو العلامة التجارية في مستودعك

عمليات التعداد
INVENTORY_STATUS_UNSPECIFIED غير محدّد
IN_STOCK يتوفّر لديك منتج من مجموعة المنتجات أو العلامة التجارية هذه.
OUT_OF_STOCK لديك منتج من مجموعة المنتجات أو العلامة التجارية هذه في المستودع، ولكنه غير متوفّر حاليًا.
NOT_IN_INVENTORY لا يتوفّر لديك منتج لمجموعة المنتجات أو العلامة التجارية هذه في المستودع.

RelativeDemandEnum

قيم الطلبات النسبية

عمليات التعداد
RELATIVE_DEMAND_ENUM_UNSPECIFIED غير محدّد
VERY_LOW تتراوح نسبة الطلب بين 0% و5% من إجمالي الطلب على مجموعة المنتجات أو العلامة التجارية الأعلى ترتيبًا.
LOW تتراوح نسبة الطلب بين ‎6% و‎10% من إجمالي الطلب على مجموعة المنتجات أو العلامة التجارية الأعلى ترتيبًا.
MEDIUM تتراوح نسبة الطلب بين ‎11% و‎20% من إجمالي الطلب على مجموعة المنتجات أو العلامة التجارية الأعلى ترتيبًا.
HIGH تتراوح نسبة الطلب بين ‎21% و‎50% من إجمالي الطلب على مجموعة المنتجات أو العلامة التجارية الأعلى ترتيبًا.
VERY_HIGH تتراوح نسبة الطلب بين ‎51% و‎100% من إجمالي الطلب على مجموعة المنتجات أو العلامة التجارية الأعلى ترتيبًا.

RelativeDemandChangeTypeEnum

قيم أنواع التغيير النسبي في الطلب

عمليات التعداد
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 هي true.

مطلوب في عبارة 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

تعرِض نسبة الإعلانات إلى نتائج البحث المجانية عدد المرات التي يتلقّى فيها النطاق مرّات ظهور من إعلانات Shopping مقارنةً بالزيارات الواردة من نتائج البحث المجانية. ويتم تقريب الرقم وتجميعه.

لا يمكن فلترتها في عبارة WHERE.
pageOverlapRate

number

يعرض معدّل التداخل في الصفحة مدى تكرار ظهور عروض بائعي التجزئة المنافسين مع عروضك على الصفحة نفسها.

لا يمكن فلترة البيانات استنادًا إليها في عبارة WHERE.
higherPositionRate

number

يعرض مقياس معدّل الظهور في موضع أعلى عدد المرات التي ظهر فيها عرض تاجر منافس في موضع أعلى من عرضك على الصفحة.

لا يمكن فلترة البيانات استنادًا إليها في عبارة WHERE.
relativeVisibility

number

يعرض مقياس مستوى الظهور النسبي عدد المرات التي ظهرت فيها عروض منافسيك مقارنةً بعروضك. بمعنى آخر، يشير هذا المقياس إلى عدد مرات ظهور المنتجات الخاصة ببائع تجزئة منافس، مقسومًا على عدد مرات الظهور المعروضة خلال نطاق زمني محدّد لفئة منتج وبلد محدّدَين.

لا يمكن فلترتها في عبارة WHERE.

TrafficSourceEnum

قيم مصادر الزيارات

عمليات التعداد
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 هي true.

مطلوب في عبارة 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

تعرِض نسبة الإعلانات إلى نتائج البحث المجانية عدد المرات التي يتلقّى فيها النطاق مرّات ظهور من إعلانات Shopping مقارنةً بالزيارات الواردة من نتائج البحث المجانية. ويتم تقريب الرقم وتجميعه.

لا يمكن فلترة البيانات استنادًا إليها في عبارة 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.

الطُرق
يسترجع تقريرًا محدّدًا من خلال طلب بحث.