الفهرس
ReportService
(واجهة)BestSellersBrandView
(رسالة)BestSellersProductClusterView
(رسالة)BestSellersProductClusterView.InventoryStatus
(تعداد)CompetitiveVisibilityBenchmarkView
(رسالة)CompetitiveVisibilityCompetitorView
(رسالة)CompetitiveVisibilityTopMerchantView
(رسالة)MarketingMethod
(رسالة)MarketingMethod.MarketingMethodEnum
(تعداد)NonProductPerformanceView
(رسالة)PriceCompetitivenessProductView
(رسالة)PriceInsightsProductView
(رسالة)PriceInsightsProductView.Effectiveness
(تعداد)ProductPerformanceView
(رسالة)ProductView
(رسالة)ProductView.AggregatedReportingContextStatus
(تعداد)ProductView.ClickPotential
(تعداد)ProductView.ItemIssue
(رسالة)ProductView.ItemIssue.ItemIssueResolution
(تعداد)ProductView.ItemIssue.ItemIssueSeverity
(رسالة)ProductView.ItemIssue.ItemIssueSeverity.AggregatedIssueSeverity
(تعداد)ProductView.ItemIssue.ItemIssueSeverity.IssueSeverityPerReportingContext
(رسالة)ProductView.ItemIssue.ItemIssueType
(رسالة)RelativeDemand
(رسالة)RelativeDemand.RelativeDemandEnum
(تعداد)RelativeDemandChangeType
(رسالة)RelativeDemandChangeType.RelativeDemandChangeTypeEnum
(تعداد)ReportGranularity
(رسالة)ReportGranularity.ReportGranularityEnum
(تعداد)ReportRow
(رسالة)SearchRequest
(رسالة)SearchResponse
(رسالة)TrafficSource
(رسالة)TrafficSource.TrafficSourceEnum
(تعداد)
ReportService
خدمة لاسترداد التقارير والإحصاءات حول منتجاتك وأدائها وبيئتها التنافسية على Google
بحث |
---|
يسترجع تقريرًا محدّدًا من خلال طلب بحث. قد يحتوي الردّ على صفوف أقلّ من تلك المحدّدة في
|
BestSellersBrandView
الحقول المتاحة لطلب البحث في جدول best_sellers_brand_view
تقرير الأكثر مبيعًا الذي يعرض أهم العلامات التجارية
لا يتمّ ضبط القيم إلّا للحقول المطلوبة صراحةً في طلب البحث.
الحقول | |
---|---|
report_ |
تاريخ التقرير لا يمكن أن تكون قيمة هذا الحقل سوى إحدى القيم التالية:
مطلوب في عبارة |
report_ |
دقّة التقرير ويمكن إجراء الترتيب على مدار أسبوع أو شهر. مطلوب في عبارة |
report_ |
البلد الذي يتم احتساب الترتيب فيه يتم تمثيلها بتنسيق ISO 3166. مطلوب في عبارة |
report_ |
معرّف فئة المنتجات من Google لاحتساب ترتيبها، والممثّل في تصنيف المنتجات من Google مطلوب في عبارة |
brand |
اسم العلامة التجارية |
rank |
مدى رواج العلامة التجارية في الإعلانات والنتائج المجانية، في الفئة والبلد المحدّدَين، استنادًا إلى العدد المقدّر للوحدات المباعة |
previous_ |
ترتيب مدى الرواج في الأسبوع أو الشهر السابق |
relative_ |
الطلب المقدَّر مقارنةً بالعلامة التجارية الأكثر رواجًا في الفئة والبلد نفسيهما |
previous_ |
الطلب المقدَّر مقارنةً بالعلامة التجارية الأكثر رواجًا في الفئة والبلد نفسيهما في الأسبوع أو الشهر السابق |
relative_ |
تغيير في الطلب المقدَّر ما إذا كان قد ارتفع أو انخفض أو ظل ثابتًا |
BestSellersProductClusterView
الحقول المتاحة لطلب البحث في جدول best_sellers_product_cluster_view
تقرير الأكثر مبيعًا مع أهم مجموعات المنتجات مجموعة المنتجات هي مجموعة من العروض والخيارات المختلفة التي تمثّل المنتج نفسه، مثل Google Pixel 7.
لا يتمّ ضبط القيم إلّا للحقول المطلوبة صراحةً في طلب البحث.
الحقول | |
---|---|
report_ |
تاريخ التقرير لا يمكن أن تكون قيمة هذا الحقل سوى إحدى القيم التالية:
مطلوب في عبارة |
variant_ |
أرقام GTIN الخاصة بأمثلة خيارات مجموعة المنتجات |
report_ |
دقّة التقرير ويمكن إجراء الترتيب على مدار أسبوع أو شهر. مطلوب في عبارة |
report_ |
البلد الذي يتم احتساب الترتيب فيه يتم تمثيلها بتنسيق ISO 3166. مطلوب في عبارة |
report_ |
معرّف فئة المنتجات من Google لاحتساب ترتيبها، والممثّل في تصنيف المنتجات من Google مطلوب في عبارة |
title |
عنوان مجموعة المنتجات. |
brand |
العلامة التجارية لمجموعة المنتجات |
category_ |
فئة المنتج (المستوى الأول) من مجموعة المنتجات، ممثّلة في تصنيف المنتجات من Google |
category_ |
فئة المنتج (المستوى الثاني) من مجموعة المنتجات، ممثّلة في تصنيف المنتجات من Google |
category_ |
فئة المنتج (المستوى الثالث) من مجموعة المنتجات، ممثّلة في تصنيف المنتجات من Google |
category_ |
فئة المنتج (المستوى الرابع) من مجموعة المنتجات، ممثّلة في تصنيف المنتجات من Google |
category_ |
فئة المنتج (المستوى الخامس) من مجموعة المنتجات، ممثّلة في تصنيف المنتجات من Google |
inventory_ |
ما إذا كانت مجموعة المنتجات هي ولا يأخذ الحقل في الاعتبار فلتر البلدان في تقرير "الأكثر مبيعًا". |
brand_ |
ما إذا كان هناك منتج واحد على الأقل من العلامة التجارية ولا يأخذ الحقل في الاعتبار فلتر البلدان في تقرير "الأكثر مبيعًا". |
rank |
مدى رواج مجموعة المنتجات في الإعلانات والنتائج المجانية، في الفئة والبلد المحدّدَين، استنادًا إلى العدد المقدّر للوحدات المُباعة |
previous_ |
ترتيب مدى الرواج في الأسبوع أو الشهر السابق |
relative_ |
الطلب المقدَّر مقارنةً بمجموعة المنتجات الأكثر رواجًا في الفئة والبلد نفسيهما |
previous_ |
الطلب المقدَّر مقارنةً بمجموعة المنتجات التي حصلت على أعلى ترتيب من حيث الرواج في الفئة والبلد نفسيهما في الأسبوع أو الشهر السابق |
relative_ |
تغيير في الطلب المقدَّر ما إذا كان قد ارتفع أو انخفض أو ظل ثابتًا |
InventoryStatus
حالة مجموعة المنتجات أو العلامة التجارية في مستودعك
عمليات التعداد | |
---|---|
INVENTORY_STATUS_UNSPECIFIED |
غير محدّد |
IN_STOCK |
يتوفّر لديك منتج من مجموعة المنتجات أو العلامة التجارية هذه. |
OUT_OF_STOCK |
لديك منتج من مجموعة المنتجات أو العلامة التجارية هذه في المستودع، ولكنه غير متوفّر حاليًا. |
NOT_IN_INVENTORY |
ليس لديك منتج لمجموعة المنتجات أو العلامة التجارية هذه في المستودع. |
CompetitiveVisibilityBenchmarkView
الحقول المتاحة لطلب البحث في جدول competitive_visibility_benchmark_view
تقرير التنافسية حسب الظهور مع مقياس أداء الفئة
لا يتمّ ضبط القيم إلّا للحقول المطلوبة صراحةً في طلب البحث.
الحقول | |
---|---|
date |
تاريخ هذا الصف. مطلوب في عبارة |
report_ |
البلد الذي ظهرت فيه مرّات الظهور مطلوب في عبارة |
report_ |
رقم تعريف فئة المنتجات من Google لاحتساب التقرير، والممثّل في تصنيف المنتجات من Google مطلوب في عبارة |
traffic_ |
مصدر الزيارات لمرّات الظهور مطلوب في عبارة |
your_ |
التغيير في مستوى العرض استنادًا إلى مرّات الظهور لموقعك الإلكتروني في ما يتعلّق ببداية النطاق الزمني المحدّد (أو اليوم الأول الذي تتوفّر فيه مرّات ظهور غير صفرية) لا يمكن فلترة البيانات استنادًا إليها في عبارة WHERE. |
category_ |
التغيير في مستوى الظهور استنادًا إلى مرّات الظهور في ما يتعلّق ببداية النطاق الزمني المحدّد (أو اليوم الأول الذي تسجّل فيه مرّات الظهور قيمة غير صفرية) لمجموعة مُجمّعة من التجّار الذين يحقّقون أعلى مستوى ظهور في السوق تقريبًا لا يمكن فلترة البيانات استنادًا إليها في عبارة WHERE. |
CompetitiveVisibilityCompetitorView
الحقول المتاحة لطلب البحث في جدول competitive_visibility_competitor_view
تقرير التنافسية حسب الظهور الذي يعرض الأنشطة التجارية التي تحقّق مستوى ظهور مشابهًا
لا يتمّ ضبط القيم إلّا للحقول المطلوبة صراحةً في طلب البحث.
الحقول | |
---|---|
date |
تاريخ هذا الصف. يجب إدخال شرط على |
domain |
نطاق منافسك أو نطاقك، إذا كان "is_your_domain" صحيحًا. مطلوب في عبارة |
is_ |
صحيح إذا كان هذا الصف يحتوي على بيانات لنطاقك. لا يمكن فلترة البيانات استنادًا إليها في عبارة WHERE. |
report_ |
البلد الذي ظهرت فيه مرّات الظهور مطلوب في عبارة |
report_ |
رقم تعريف فئة المنتجات من Google لاحتساب التقرير، والممثّل في تصنيف المنتجات من Google مطلوب في عبارة |
traffic_ |
مصدر الزيارات لمرّات الظهور مطلوب في عبارة |
rank |
ترتيب النطاق في قائمة الأنشطة التجارية المشابهة حسب المفاتيح المحدّدة ( لا يمكن فلترتها في عبارة WHERE. |
ads_ |
تعرِض نسبة الإعلانات إلى نتائج البحث المجانية عدد المرات التي يتلقّى فيها النطاق مرّات ظهور من إعلانات Shopping مقارنةً بالزيارات الواردة من نتائج البحث المجانية. ويتم تقريب الرقم وتجميعه. لا يمكن فلترة البيانات حسبها في عبارة WHERE. |
page_ |
يعرض معدّل التداخل في الصفحة عدد المرات التي تظهر فيها عروض بائعي التجزئة المنافسين مع عروضك على الصفحة نفسها. لا يمكن فلترة البيانات استنادًا إليها في عبارة WHERE. |
higher_ |
يعرض مقياس معدّل الظهور في موضع أعلى عدد المرات التي ظهر فيها عرض تاجر منافس في موضع أعلى من عرضك على الصفحة. لا يمكن فلترة البيانات استنادًا إليها في عبارة WHERE. |
relative_ |
يعرض مقياس مستوى الظهور النسبي عدد المرات التي ظهرت فيها عروض منافسيك مقارنةً بعروضك. بمعنى آخر، يشير هذا المقياس إلى عدد مرات ظهور المنتجات الخاصة ببائع تجزئة منافس، مقسومًا على عدد مرات الظهور المعروضة خلال نطاق زمني محدّد لفئة منتج وبلد محدّدَين. لا يمكن فلترة البيانات استنادًا إليها في عبارة WHERE. |
CompetitiveVisibilityTopMerchantView
الحقول المتاحة لطلب البحث في جدول competitive_visibility_top_merchant_view
تقرير مستوى الظهور التنافسي الذي يعرض الأنشطة التجارية التي تحقّق أعلى مستوى ظهور
لا يتمّ ضبط القيم إلّا للحقول المطلوبة صراحةً في طلب البحث.
الحقول | |
---|---|
date |
تاريخ هذا الصف. لا يمكن اختياره في جملة |
domain |
نطاق منافسك أو نطاقك، إذا كان "is_your_domain" صحيحًا. مطلوب في عبارة |
is_ |
صحيح إذا كان هذا الصف يحتوي على بيانات لنطاقك. لا يمكن فلترة البيانات استنادًا إليها في عبارة WHERE. |
report_ |
البلد الذي ظهرت فيه مرّات الظهور مطلوب في عبارة |
report_ |
رقم تعريف فئة المنتجات من Google لاحتساب التقرير، والممثّل في تصنيف المنتجات من Google مطلوب في عبارة |
traffic_ |
مصدر الزيارات لمرّات الظهور مطلوب في عبارة |
rank |
ترتيب النطاق في قائمة أهم التجّار حسب المفاتيح المحدّدة ( لا يمكن فلترة البيانات استنادًا إليها في عبارة WHERE. |
ads_ |
تعرِض نسبة الإعلانات إلى نتائج البحث المجانية عدد المرات التي يتلقّى فيها النطاق مرّات ظهور من إعلانات Shopping مقارنةً بالزيارات الواردة من نتائج البحث المجانية. ويتم تقريب الرقم وتجميعه. لا يمكن فلترة البيانات استنادًا إليها في عبارة WHERE. |
page_ |
يعرض معدّل التداخل في الصفحة مدى تكرار ظهور عروض بائعي التجزئة المنافسين مع عروضك على الصفحة نفسها. لا يمكن فلترتها في عبارة WHERE. |
higher_ |
يعرض مقياس معدّل الظهور في موضع أعلى عدد المرات التي ظهر فيها عرض تاجر منافس في موضع أعلى من عرضك على الصفحة. لا يمكن فلترتها في عبارة WHERE. |
MarketingMethod
لا يحتوي هذا النوع على أي حقول.
طريقة التسويق المستخدَمة للترويج لمنتجاتك على Google (نتائج البحث المجانية مقابل الإعلانات)
MarketingMethodEnum
قيم طريقة التسويق
عمليات التعداد | |
---|---|
MARKETING_METHOD_ENUM_UNSPECIFIED |
غير محدّد |
ORGANIC |
التسويق المجاني |
ADS |
التسويق المستنِد إلى الإعلانات |
NonProductPerformanceView
الحقول المتاحة لطلب البحث في جدول non_product_performance_view
بيانات الأداء عن الصور وروابط المتاجر على الإنترنت التي تؤدي إلى صفحاتك غير المتعلقة بالمنتجات ويشمل ذلك مقاييس الأداء (مثل clicks
) والسمات التي يتم تقسيم مقاييس الأداء وفقًا لها (مثل date
).
لا يمكن اختيار حقول الشرائح في طلبات البحث بدون اختيار حقل مقياس واحد على الأقل.
لا يتمّ ضبط القيم إلّا للحقول المطلوبة صراحةً في طلب البحث.
الحقول | |
---|---|
date |
التاريخ في المنطقة الزمنية للتاجر التي تنطبق عليها المقاييس. القسم يجب إدخال شرط في |
week |
اليوم الأول من الأسبوع (الإثنين) لتاريخ المقاييس في المنطقة الزمنية للتاجر. القسم |
clicks |
عدد النقرات على الصور وروابط المتاجر على الإنترنت التي تؤدي إلى صفحاتك غير المتعلقة بالمنتجات المقياس |
impressions |
عدد المرات التي تم فيها عرض الصور وروابط المتاجر على الإنترنت التي تؤدي إلى صفحاتك غير المتعلقة بالمنتجات المقياس |
click_ |
نسبة النقر إلى الظهور: هي عدد النقرات ( |
PriceCompetitivenessProductView
الحقول المتاحة لطلب البحث في جدول price_competitiveness_product_view
تقرير مكانة السعر في المنافسة
لا يتمّ ضبط القيم إلّا للحقول المطلوبة صراحةً في طلب البحث.
الحقول | |
---|---|
price |
السعر الحالي للمنتج. |
benchmark_ |
أحدث سعر مرجعي متاح لخلاصة المنتجات في البلد المرجعي. |
report_ |
بلد هامش السعر يتم تمثيلها بتنسيق ISO 3166. مطلوب في عبارة |
id |
معرّف REST للمنتج بالتنسيق مطلوب في عبارة |
offer_ |
معرّف المنتج الذي يوفّره التاجر |
title |
عنوان المنتج |
brand |
العلامة التجارية للمنتج |
category_ |
فئة المنتج (المستوى الأول) في تصنيف المنتجات من Google |
category_ |
فئة المنتج (المستوى الثاني) في تصنيف المنتجات من Google |
category_ |
فئة المنتج (المستوى الثالث) في تصنيف المنتجات من Google |
category_ |
فئة المنتج (المستوى الرابع) في تصنيف المنتجات من Google |
category_ |
فئة المنتج (المستوى الخامس) في تصنيف المنتجات من Google |
product_ |
نوع المنتج (المستوى الأول) في تصنيف المنتجات الخاص بالتاجر |
product_ |
نوع المنتج (المستوى الثاني) في تصنيف المنتجات الخاص بالتاجر |
product_ |
نوع المنتج (المستوى الثالث) في تصنيف المنتجات الخاص بالتاجر |
product_ |
نوع المنتج (المستوى الرابع) في تصنيف المنتجات الخاص بالتاجر |
product_ |
نوع المنتج (المستوى الخامس) في تصنيف المنتجات الخاص بالتاجر |
PriceInsightsProductView
الحقول المتاحة لطلب البحث في جدول price_insights_product_view
تقرير معلومات مفصّلة عن الأسعار
لا يتمّ ضبط القيم إلّا للحقول المطلوبة صراحةً في طلب البحث.
الحقول | |
---|---|
price |
السعر الحالي للمنتج. |
suggested_ |
آخر سعر مقترَح للمنتج. |
effectiveness |
الفعالية المتوقّعة لتطبيق اقتراح السعر، مقسّمة إلى مجموعات. |
id |
معرّف REST للمنتج بالتنسيق مطلوب في عبارة |
offer_ |
معرّف المنتج الذي يوفّره التاجر |
title |
عنوان المنتج |
brand |
العلامة التجارية للمنتج |
category_ |
فئة المنتج (المستوى الأول) في تصنيف المنتجات من Google |
category_ |
فئة المنتج (المستوى الثاني) في تصنيف المنتجات من Google |
category_ |
فئة المنتج (المستوى الثالث) في تصنيف المنتجات من Google |
category_ |
فئة المنتج (المستوى الرابع) في تصنيف المنتجات من Google |
category_ |
فئة المنتج (المستوى الخامس) في تصنيف المنتجات من Google |
product_ |
نوع المنتج (المستوى الأول) في تصنيف المنتجات الخاص بالتاجر |
product_ |
نوع المنتج (المستوى الثاني) في تصنيف المنتجات الخاص بالتاجر |
product_ |
نوع المنتج (المستوى الثالث) في تصنيف المنتجات الخاص بالتاجر |
product_ |
نوع المنتج (المستوى الرابع) في تصنيف المنتجات الخاص بالتاجر |
product_ |
نوع المنتج (المستوى الخامس) في تصنيف المنتجات الخاص بالتاجر |
predicted_ |
التغيير المتوقّع في عدد مرات الظهور ككسر بعد تقديم السعر المقترَح مقارنةً بالسعر الحالي. على سبيل المثال، يشير الرقم 0.05 إلى زيادة متوقّعة في عدد مرات الظهور بنسبة% 5. |
predicted_ |
التغيير المتوقّع في عدد النقرات ككسر بعد تقديم السعر المقترَح مقارنةً بالسعر الحالي النشط. على سبيل المثال، يشير الرقم 0.05 إلى زيادة متوقّعة في عدد النقرات بنسبة% 5. |
predicted_ |
التغيير المتوقّع في الإحالات الناجحة ككسر بعد تقديم السعر المقترَح مقارنةً بالسعر الحالي. على سبيل المثال، يشير الرقم 0.05 إلى زيادة متوقّعة في الإحالات الناجحة بنسبة% 5). |
الفاعلية
حزمة الفعالية المتوقّعة
تشير الفعالية إلى المنتجات التي ستستفيد إلى أقصى حدّ من تغيير الأسعار. يأخذ هذا التقييم في الاعتبار تحسّن الأداء المتوقَّع من خلال تعديل السعر المخفَّض والفرق بين السعر الحالي والسعر المقترَح. يُتوقَّع أن تحقّق اقتراحات الأسعار ذات الفعالية HIGH
الزيادة الأكبر في مستوى الأداء.
عمليات التعداد | |
---|---|
EFFECTIVENESS_UNSPECIFIED |
لا تتوفّر معلومات عن مدى فعالية هذه الميزة. |
LOW |
الفعالية منخفضة. |
MEDIUM |
تكون الفعالية متوسطة. |
HIGH |
تكون الفعالية عالية. |
ProductPerformanceView
الحقول المتاحة لطلب البحث في جدول product_performance_view
بيانات أداء المنتجات لحسابك، بما في ذلك مقاييس الأداء (مثل clicks
) والسمات التي يتم تقسيم مقاييس الأداء وفقًا لها (مثل offer_id
). تعكس قيم سمات المنتجات، مثل offer_id
، حالة المنتج في وقت ظهور الإعلان.
لا يمكن اختيار حقول الشرائح في طلبات البحث بدون اختيار حقل مقياس واحد على الأقل.
لا يتمّ ضبط القيم إلّا للحقول المطلوبة صراحةً في طلب البحث.
الحقول | |
---|---|
date |
التاريخ في المنطقة الزمنية للتاجر التي تنطبق عليها المقاييس. القسم يجب إدخال شرط في |
week |
اليوم الأول من الأسبوع (الإثنين) لتاريخ المقاييس في المنطقة الزمنية للتاجر. القسم |
conversion_ |
قيمة الإحالات الناجحة المنسوبة إلى المنتج، والتي يتم الإبلاغ عنها في تاريخ الإحالة الناجحة المقياس تتوفّر هذه الميزة لمصدر زيارات |
marketing_ |
طريقة التسويق التي تنطبق عليها المقاييس. القسم |
customer_ |
رمز البلد الذي يقيم فيه العميل في وقت الحدث يتم تمثيلها بتنسيق ISO 3166. القسم إذا تعذّر تحديد بلد العميل، يتم عرض رمز خاص "ZZ". |
offer_ |
معرّف المنتج الذي يوفّره التاجر القسم |
title |
عنوان المنتج القسم |
brand |
العلامة التجارية للمنتج القسم |
category_ |
فئة المنتج (المستوى الأول) في تصنيف المنتجات من Google القسم |
category_ |
فئة المنتج (المستوى الثاني) في تصنيف المنتجات من Google القسم |
category_ |
فئة المنتج (المستوى الثالث) في تصنيف المنتجات من Google القسم |
category_ |
فئة المنتج (المستوى الرابع) في تصنيف المنتجات من Google القسم |
category_ |
فئة المنتج (المستوى الخامس) في تصنيف المنتجات من Google القسم |
product_ |
نوع المنتج (المستوى الأول) في تصنيف المنتجات الخاص بالتاجر القسم |
product_ |
نوع المنتج (المستوى الثاني) في تصنيف المنتجات الخاص بالتاجر القسم |
product_ |
نوع المنتج (المستوى الثالث) في تصنيف المنتجات الخاص بالتاجر القسم |
product_ |
نوع المنتج (المستوى الرابع) في تصنيف المنتجات الخاص بالتاجر القسم |
product_ |
نوع المنتج (المستوى الخامس) في تصنيف المنتجات الخاص بالتاجر القسم |
custom_ |
التصنيف المخصّص 0 لتجميع المنتجات بشكل مخصّص القسم |
custom_ |
التصنيف المخصّص 1 لتجميع المنتجات المخصّص القسم |
custom_ |
التصنيف المخصّص 2 لتجميع المنتجات بشكل مخصّص القسم |
custom_ |
التصنيف المخصّص 3 لتجميع المنتجات بشكل مخصّص القسم |
custom_ |
التصنيف المخصّص 4 لتجميع المنتجات بشكل مخصّص القسم |
clicks |
عدد النقرات المقياس |
impressions |
عدد المرات التي يتم فيها عرض منتجات التاجر المقياس |
click_ |
نسبة النقر إلى الظهور: عدد النقرات التي تتلقّاها منتجات التاجر (النقرات) مقسومًا على عدد مرّات عرض المنتجات (مرّات الظهور). المقياس |
conversions |
عدد الإحالات الناجحة المنسوبة إلى المنتج، والتي يتم تسجيلها في تاريخ الإحالة الناجحة. استنادًا إلى نموذج تحديد المصدر، قد يتم توزيع إحالة ناجحة على نقرات متعددة، حيث تحصل كل نقرة على نسبة المساهمة الخاصة بها. ويمثّل هذا المقياس مجموع كل هذه الأرصدة. المقياس تتوفّر هذه الميزة لمصدر زيارات |
conversion_ |
عدد الإحالات الناجحة مقسومًا على عدد النقرات، ويتم تسجيله في تاريخ مرّة الظهور. المقياس تتوفّر هذه الميزة لمصدر زيارات |
ProductView
الحقول المتاحة لطلب البحث في جدول product_view
المنتجات المتوفّرة في المستودع الحالي المنتجات الواردة في هذا الجدول هي نفسها الواردة في المنتجات الفرعية لواجهة برمجة التطبيقات، ولكن لا تتوفّر بعض سمات المنتجات من المنتجات الفرعية لواجهة برمجة التطبيقات للبحث عنها في هذا الجدول. على عكس واجهة برمجة التطبيقات الفرعية Products، يسمح هذا الجدول بفلترة قائمة المنتجات المعروضة حسب سمات المنتجات. لاسترداد منتج واحد حسب id
أو إدراج جميع المنتجات، يجب استخدام واجهة برمجة التطبيقات الفرعية للمنتجات.
لا يتمّ ضبط القيم إلّا للحقول المطلوبة صراحةً في طلب البحث.
الحقول | |
---|---|
price |
سعر المنتج لا يظهر هذا الحقل إذا لم تكن معلومات سعر المنتج متاحة. |
gtin[] |
قائمة بالأرقام التجارية العالمية للسلع (أرقام GTIN) الخاصة بالمنتج |
creation_ |
الوقت الذي أنشأ فيه التاجر المنتج بالثواني في الطابع الزمني |
expiration_ |
تاريخ انتهاء صلاحية المنتج، المحدّد عند الإدراج |
item_ |
قائمة بمشاكل السلع للمنتج لا يمكن استخدام هذا الحقل لترتيب النتائج. لا يمكن استخدام سوى سمات محدّدة من هذا الحقل (مثل |
click_ |
الأداء المحتمَل المقدَّر مقارنةً بالمنتجات الأفضل أداءً للتاجر |
id |
معرّف REST للمنتج بالتنسيق مطلوب في عبارة |
channel |
قناة المنتج يمكن أن يكون |
language_ |
رمز اللغة للمنتج بتنسيق BCP 47 |
feed_ |
تصنيف الخلاصة للمنتج |
offer_ |
معرّف المنتج الذي يوفّره التاجر |
title |
عنوان المنتج |
brand |
العلامة التجارية للمنتج |
category_ |
فئة المنتج (المستوى الأول) في تصنيف المنتجات من Google |
category_ |
فئة المنتج (المستوى الثاني) في تصنيف المنتجات من Google |
category_ |
فئة المنتج (المستوى الثالث) في تصنيف المنتجات من Google |
category_ |
فئة المنتج (المستوى الرابع) في تصنيف المنتجات من Google |
category_ |
فئة المنتج (المستوى الخامس) في تصنيف المنتجات من Google |
product_ |
نوع المنتج (المستوى الأول) في تصنيف المنتجات الخاص بالتاجر |
product_ |
نوع المنتج (المستوى الثاني) في تصنيف المنتجات الخاص بالتاجر |
product_ |
نوع المنتج (المستوى الثالث) في تصنيف المنتجات الخاص بالتاجر |
product_ |
نوع المنتج (المستوى الرابع) في تصنيف المنتجات الخاص بالتاجر |
product_ |
نوع المنتج (المستوى الخامس) في تصنيف المنتجات الخاص بالتاجر |
condition |
حالة المنتج |
availability |
مدى توفّر المنتج |
shipping_ |
تصنيف الشحن المنسَّق المحدّد في مصدر البيانات |
item_ |
معرّف مجموعة السلع الذي يوفّره التاجر لتجميع الأسعار معًا |
thumbnail_ |
رابط إلى صورة المنتج التي تمت معالجتها والمستضافة على بنية Google الأساسية |
aggregated_ |
الحالة المجمّعة |
click_ |
ترتيب المنتج استنادًا إلى فرص النقر عليه يشير الرقم |
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 |
المنتج مؤهَّل لجميع سياقات إعداد التقارير. |
ClickPotential
تقدّر فرص النقر على منتج معيّن الأداء المحتمَل له مقارنةً بمنتجات التاجر الأفضل أداءً. تساعد فرص النقر على منتج معيّن التجّار في تحديد المنتجات التي تتطلّب حلّاً قبل غيرها وفهم الأداء الحالي للمنتجات مقارنةً بإمكانياتها.
عمليات التعداد | |
---|---|
CLICK_POTENTIAL_UNSPECIFIED |
تأثير غير معروف للنقرات المتوقّعة |
LOW |
من المحتمَل جذب عدد منخفض من النقرات مقارنةً بالمنتجات الأعلى أداءً للتاجر. |
MEDIUM |
من المحتمَل جذب عدد متوسط من النقرات مقارنةً بالمنتجات الأعلى أداءً للتاجر. |
HIGH |
من المحتمَل جذب عدد مشابه من النقرات مقارنةً بالمنتجات الأعلى أداءً للتاجر. |
ItemIssue
مشكلة السلعة المرتبطة بالمنتج
الحقول | |
---|---|
type |
نوع مشكلة السلعة |
severity |
درجة خطورة مشكلة السلعة |
resolution |
حلّ مشكلة السلعة |
ItemIssueResolution
كيفية حلّ المشكلة
عمليات التعداد | |
---|---|
ITEM_ISSUE_RESOLUTION_UNSPECIFIED |
غير محدّد |
MERCHANT_ACTION |
على التاجر حلّ المشكلة. |
PENDING_PROCESSING |
سيتم حلّ المشكلة تلقائيًا (على سبيل المثال، من خلال الزحف إلى الصور) أو من خلال مراجعة من Google. ليس على التاجر اتّخاذ أي إجراء الآن. قد يؤدي الحلّ إلى حدوث مشكلة أخرى (على سبيل المثال، إذا تعذّر الزحف). |
ItemIssueSeverity
كيفية تأثير المشكلة في عرض المنتج
الحقول | |
---|---|
severity_ |
درجة خطورة المشكلة حسب سياق إعداد التقارير |
aggregated_ |
شدة المشكلة المجمّعة لجميع سياقات إعداد التقارير التي تتأثّر بها يمكن استخدام هذا الحقل لفلترة النتائج. |
AggregatedIssueSeverity
يتم تجميع درجة خطورة المشكلة لجميع سياقات إعداد التقارير.
عمليات التعداد | |
---|---|
AGGREGATED_ISSUE_SEVERITY_UNSPECIFIED |
غير محدّد |
DISAPPROVED |
تؤدي المشكلة إلى رفض المنتج في سياق إعداد تقارير واحد على الأقل. |
DEMOTED |
تؤدي المشكلة إلى خفض ترتيب المنتج في جميع سياقات إعداد التقارير التي تتأثّر بها. |
PENDING |
حلّ المشكلة هو PENDING_PROCESSING . |
IssueSeverityPerReportingContext
درجة خطورة المشكلة حسب سياق إعداد التقارير
الحقول | |
---|---|
disapproved_ |
قائمة بالبلدان المرفوضة في سياق إعداد التقارير، معروضة بتنسيق ISO 3166 |
demoted_ |
قائمة بالبلدان التي تمّ خفض ترتيبها في سياق إعداد التقارير، معروضة بتنسيق ISO 3166 |
reporting_ |
سياق إعداد التقارير الذي تنطبق عليه المشكلة |
ItemIssueType
نوع المشكلة
الحقول | |
---|---|
code |
رمز الخطأ للمشكلة، وهو يعادل |
canonical_ |
اسم السمة الأساسي للمشاكل المتعلّقة بالسمة |
RelativeDemand
لا يحتوي هذا النوع على أي حقول.
الطلب النسبي لمجموعة منتجات أو علامة تجارية في تقرير "الأكثر مبيعًا"
RelativeDemandEnum
قيم الطلبات النسبية
عمليات التعداد | |
---|---|
RELATIVE_DEMAND_ENUM_UNSPECIFIED |
غير محدّد |
VERY_LOW |
تتراوح نسبة الطلب بين 0% و5% من إجمالي الطلب على مجموعة المنتجات أو العلامة التجارية الأعلى ترتيبًا. |
LOW |
تتراوح نسبة الطلب بين 6% و10% من إجمالي الطلب على مجموعة المنتجات أو العلامة التجارية الأعلى ترتيبًا. |
MEDIUM |
تتراوح نسبة الطلب بين 11% و20% من إجمالي الطلب على مجموعة المنتجات أو العلامة التجارية الأعلى ترتيبًا. |
HIGH |
تتراوح نسبة الطلب بين 21% و50% من إجمالي الطلب على مجموعة المنتجات أو العلامة التجارية الأعلى ترتيبًا. |
VERY_HIGH |
تتراوح نسبة الطلب بين 51% و100% من إجمالي الطلب على مجموعة المنتجات أو العلامة التجارية الأعلى ترتيبًا. |
RelativeDemandChangeType
لا يحتوي هذا النوع على أي حقول.
الطلب النسبي لمجموعة منتجات أو علامة تجارية في تقرير "الأكثر مبيعًا" مقارنةً بالفترة الزمنية السابقة.
RelativeDemandChangeTypeEnum
قيم أنواع التغيير النسبي في الطلب
عمليات التعداد | |
---|---|
RELATIVE_DEMAND_CHANGE_TYPE_ENUM_UNSPECIFIED |
غير محدّد |
SINKER |
الطلب النسبي أقل من الفترة الزمنية السابقة. |
FLAT |
يكون الطلب النسبي مساويًا للفترة الزمنية السابقة. |
RISER |
الطلب النسبي أعلى من الفترة الزمنية السابقة. |
ReportGranularity
لا يحتوي هذا النوع على أي حقول.
مستوى دقة تقرير "الأكثر مبيعًا" يتم احتساب تقارير "الأكثر مبيعًا" على مدار أسبوع وشهر.
ReportGranularityEnum
قيم دقة التقرير
عمليات التعداد | |
---|---|
REPORT_GRANULARITY_ENUM_UNSPECIFIED |
غير محدّد |
WEEKLY |
يتم احتساب التقرير على مدار إطار زمني أسبوعي. |
MONTHLY |
يتم احتساب التقرير على مدار إطار زمني شهري. |
ReportRow
صف النتيجة الذي تم إرجاعه من طلب البحث
لا تتم تعبئة سوى الرسالة المقابلة للجدول الذي تم الاستعلام عنه في الردّ. في الرسالة التي تمّت تعبئتها، لا تتمّ تعبئة سوى الحقول المطلوبة صراحةً في طلب البحث.
الحقول | |
---|---|
product_ |
الحقول المتاحة لطلب البحث في جدول |
non_ |
الحقول المتاحة لطلب البحث في جدول |
product_ |
الحقول المتاحة لطلب البحث في جدول |
price_ |
الحقول المتاحة لطلب البحث في جدول |
price_ |
الحقول المتاحة لطلب البحث في جدول |
best_ |
الحقول المتاحة لطلب البحث في جدول |
best_ |
الحقول المتاحة لطلب البحث في جدول |
competitive_ |
الحقول المتاحة لطلب البحث في جدول |
competitive_ |
الحقول المتاحة لطلب البحث في جدول |
competitive_ |
الحقول المتاحة لطلب البحث في جدول |
SearchRequest
رسالة طلب لطريقة ReportService.Search
الحقول | |
---|---|
parent |
مطلوب. رقم تعريف الحساب الذي يجري المكالمة يجب أن يكون حسابًا مستقلاً أو حسابًا فرعيًا لحساب متعدّد العملاء. التنسيق: accounts/{account} |
query |
مطلوب. طلب بحث يحدِّد التقرير المطلوب استرجاعه لمعرفة التفاصيل حول كيفية إنشاء طلب البحث، اطّلِع على دليل لغة طلبات البحث. للحصول على القائمة الكاملة بالجداول والحقول المتاحة، اطّلِع على "الحقول المتاحة". |
page_ |
اختيارية: عدد |
page_ |
اختيارية: الرمز المميّز للصفحة المطلوب استردادها إذا لم يتم تحديدها، يتم عرض الصفحة الأولى من النتائج. لطلب الصفحة التالية من النتائج، يجب استخدام القيمة التي تم الحصول عليها من |
SearchResponse
رسالة الردّ على طريقة ReportService.Search
الحقول | |
---|---|
results[] |
الصفوف التي تطابقت مع طلب البحث |
next_ |
رمز مميّز يمكن إرساله على شكل |
TrafficSource
لا يحتوي هذا النوع على أي حقول.
مصدر الزيارات لمرّات الظهور في تقرير "التنافسية حسب الظهور"
TrafficSourceEnum
قيم مصادر الزيارات
عمليات التعداد | |
---|---|
TRAFFIC_SOURCE_ENUM_UNSPECIFIED |
غير محدّد |
ORGANIC |
الزيارات الواردة من نتائج البحث المجانية |
ADS |
عدد الزيارات الواردة من الإعلانات |
ALL |
الزيارات الواردة من نتائج البحث المجانية والزيارات الواردة من الإعلانات |