- طلب HTTP
- مَعلمات المسار
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- ReportRow
- ProductPerformanceView
- MarketingMethodEnum
- NonProductPerformanceView
- ProductView
- AggregatedReportingContextStatus
- ItemIssue
- ItemIssueType
- ItemIssueSeverity
- IssueSeverityPerReportingContext
- AggregatedIssueSeverity
- ItemIssueResolution
- ClickPotential
- PriceCompetitivenessProductView
- PriceInsightsProductView
- الفعالية
- BestSellersProductClusterView
- ReportGranularityEnum
- InventoryStatus
- RelativeDemandEnum
- RelativeDemandChangeTypeEnum
- BestSellersBrandView
- CompetitiveVisibilityCompetitorView
- TrafficSourceEnum
- CompetitiveVisibilityTopMerchantView
- CompetitiveVisibilityBenchmarkView
- جرِّبه الآن
يسترد تقريرًا محددًا بواسطة طلب بحث. قد يحتوي الردّ على عدد أقل من الصفوف التي حدّدتها السياسة pageSize
. اعتمِد على nextPageToken
لتحديد ما إذا كان هناك المزيد من الصفوف المطلوب طلبها.
طلب HTTP
POST https://merchantapi.googleapis.com/reports/v1beta/{parent=accounts/*}/reports:search
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات | |
---|---|
parent |
مطلوب. رقم تعريف الحساب الذي يجري المكالمة يجب أن يكون حسابًا مستقلاً أو حسابًا فرعيًا متعدّد العملاء. التنسيق: accounts/{account} |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "query": string, "pageSize": integer, "pageToken": string } |
الحقول | |
---|---|
query |
مطلوب. طلب بحث يحدّد تقريرًا ليتم استرداده للحصول على تفاصيل حول كيفية إنشاء الاستعلام، راجع دليل لغة الاستعلام. للحصول على القائمة الكاملة للجداول والحقول المتاحة، اطّلِع على الحقول المتاحة. |
pageSize |
اختياريّ. عدد |
pageToken |
اختياريّ. الرمز المميّز للصفحة المطلوب استردادها وإذا لم يتم تحديدها، سيتم عرض الصفحة الأولى من النتائج. لطلب الانتقال إلى صفحة النتائج التالية، يجب استخدام القيمة التي تم الحصول عليها من |
نص الاستجابة
رسالة الردّ على الطريقة ReportService.Search
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"results": [
{
object ( |
الحقول | |
---|---|
results[] |
الصفوف التي تطابقت مع طلب البحث |
nextPageToken |
الرمز المميز الذي يمكن إرساله على شكل |
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/content
لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.
ReportRow
تم عرض صف النتائج من طلب البحث.
تتم تعبئة الرسالة المقابلة للجدول الذي تم البحث عنه فقط في الرد. ضمن الرسالة التي تمت تعبئتها، لا تتم تعبئة سوى الحقول المطلوبة صراحةً في طلب البحث.
تمثيل JSON |
---|
{ "productPerformanceView": { object ( |
الحقول | |
---|---|
productPerformanceView |
الحقول المتاحة لطلب البحث في جدول " |
nonProductPerformanceView |
الحقول المتاحة لطلب البحث في جدول " |
productView |
الحقول المتاحة لطلب البحث في جدول " |
priceCompetitivenessProductView |
الحقول المتاحة لطلب البحث في جدول " |
priceInsightsProductView |
الحقول المتاحة لطلب البحث في جدول " |
bestSellersProductClusterView |
الحقول المتاحة لطلب البحث في جدول " |
bestSellersBrandView |
الحقول المتاحة لطلب البحث في جدول " |
competitiveVisibilityCompetitorView |
الحقول المتاحة لطلب البحث في جدول " |
competitiveVisibilityTopMerchantView |
الحقول المتاحة لطلب البحث في جدول " |
competitiveVisibilityBenchmarkView |
الحقول المتاحة لطلب البحث في جدول " |
ProductPerformanceView
الحقول المتاحة لطلب البحث في جدول "productPerformanceView
".
بيانات أداء المنتجات لحسابك، بما في ذلك مقاييس الأداء (على سبيل المثال، clicks
) والسمات التي يتم تقسيم مقاييس الأداء وفقًا لها (على سبيل المثال، offerId
) تعكس قيم أبعاد المنتج، مثل offerId
، حالة المنتج في وقت ظهور الإعلان.
لا يمكن اختيار حقول الشرائح في طلبات البحث بدون اختيار حقل مقياس واحد أيضًا على الأقل.
يتم ضبط القيم فقط للحقول المطلوبة صراحةً في طلب البحث الخاص بالطلب.
تمثيل JSON |
---|
{ "date": { object ( |
الحقول | |
---|---|
date |
التاريخ في المنطقة الزمنية للتاجر التي تنطبق عليها المقاييس القسم يجب توفير شرط على |
week |
اليوم الأول من الأسبوع (الاثنين) من تاريخ المقاييس في المنطقة الزمنية للتاجر القسم |
conversionValue |
قيمة الإحالات الناجحة المنسوبة إلى المنتج، ويتم الإبلاغ عنها في تاريخ الإحالة الناجحة. المقياس. متاحة فقط لمصدر الزيارات " |
marketingMethod |
طريقة التسويق التي تنطبق عليها المقاييس. القسم |
customerCountryCode |
تمثّل هذه السمة رمز البلد الذي يقيم فيه العميل في وقت الفعالية. ويتم تمثيلها بتنسيق ISO 3166. القسم إذا تعذّر تحديد بلد العميل، يتم استخدام رمز 'ZZ' خاص الرمز الذي تم إرجاعه. |
offerId |
معرّف المنتج الذي قدّمه التاجر القسم |
title |
عنوان المنتج. القسم |
brand |
تمثّل هذه السمة العلامة التجارية للمنتج. القسم |
categoryL1 |
فئة المنتج (المستوى الأول) في تصنيف المنتجات من Google. القسم |
categoryL2 |
فئة المنتج (المستوى الثاني) في تصنيف المنتجات من Google. القسم |
categoryL3 |
فئة المنتج (المستوى الثالث) في تصنيف المنتجات من Google. القسم |
categoryL4 |
فئة المنتج (المستوى الرابع) في تصنيف المنتجات من Google. القسم |
categoryL5 |
فئة المنتج (المستوى الخامس) في تصنيف المنتجات من Google. القسم |
productTypeL1 |
نوع المنتج (المستوى الأول) في تصنيف المنتج الخاص بالتاجر. القسم |
productTypeL2 |
نوع المنتج (المستوى الثاني) في تصنيف المنتج الخاص بالتاجر. القسم |
productTypeL3 |
نوع المنتج (المستوى الثالث) في تصنيف المنتج الخاص بالتاجر. القسم |
productTypeL4 |
نوع المنتج (المستوى الرابع) في تصنيف المنتج الخاص بالتاجر. القسم |
productTypeL5 |
نوع المنتج (المستوى الخامس) في تصنيف المنتج الخاص بالتاجر. القسم |
customLabel0 |
التصنيف المخصّص 0 لمجموعة مخصّصة من المنتجات. القسم |
customLabel1 |
التصنيف المخصّص 1 لتجميع المنتجات حسب الطلب. القسم |
customLabel2 |
التصنيف المخصّص 2 لتجميع المنتجات حسب الطلب. القسم |
customLabel3 |
تصنيف مخصّص 3 لتجميع المنتجات المخصّص. القسم |
customLabel4 |
تصنيف مخصّص 4 لتجميع المنتجات المخصّص. القسم |
clicks |
عدد النقرات المقياس. |
impressions |
عدد مرّات عرض منتجات التاجر المقياس. |
clickThroughRate |
نسبة النقر إلى الظهور: عدد النقرات التي تتلقّاها منتجات التاجر (النقرات) مقسومًا على عدد مرات عرض المنتجات (عدد مرات الظهور). المقياس. |
conversions |
عدد الإحالات الناجحة المنسوبة إلى المنتج، والتي يتم الإبلاغ عنها في تاريخ الإحالة الناجحة. استنادًا إلى نموذج تحديد المصدر، قد يتم توزيع الإحالة الناجحة على نقرات متعددة، حيث يتم تخصيص نسبة مساهمة لكل نقرة. وهذا المقياس هو مجموع كل هذه الأرصدة. المقياس. متاحة فقط لمصدر الزيارات " |
conversionRate |
عدد الإحالات الناجحة مقسومًا على عدد النقرات، ويتم تسجيله في تاريخ الظهور. المقياس. متاحة فقط لمصدر الزيارات " |
MarketingMethodEnum
قيم طريقة التسويق.
عمليات التعداد | |
---|---|
MARKETING_METHOD_ENUM_UNSPECIFIED |
لم يتم تحديده. |
ORGANIC |
التسويق المجاني: |
ADS |
التسويق المستنِد إلى الإعلانات: |
NonProductPerformanceView
الحقول المتاحة لطلب البحث في جدول "nonProductPerformanceView
".
بيانات الأداء على الصور وروابط المتاجر على الإنترنت التي تؤدي إلى صفحات غير مرتبطة بالمنتجات ويتضمّن ذلك مقاييس الأداء (على سبيل المثال، clicks
) والسمات التي يتم تقسيم مقاييس الأداء وفقًا لها (على سبيل المثال، date
).
لا يمكن اختيار حقول الشرائح في طلبات البحث بدون اختيار حقل مقياس واحد أيضًا على الأقل.
يتم ضبط القيم فقط للحقول المطلوبة صراحةً في طلب البحث الخاص بالطلب.
تمثيل JSON |
---|
{ "date": { object ( |
الحقول | |
---|---|
date |
التاريخ في المنطقة الزمنية للتاجر التي تنطبق عليها المقاييس القسم يجب توفير شرط على |
week |
اليوم الأول من الأسبوع (الاثنين) من تاريخ المقاييس في المنطقة الزمنية للتاجر القسم |
clicks |
عدد النقرات على الصور وروابط المتاجر على الإنترنت التي تنقل إلى صفحات غير مرتبطة بالمنتجات المقياس. |
impressions |
عدد مرّات عرض الصور وروابط المتاجر على الإنترنت التي أدّت إلى صفحات غير مرتبطة بالمنتجات المقياس. |
clickThroughRate |
نسبة النقر إلى الظهور: عدد النقرات ( |
ProductView
الحقول المتاحة لطلب البحث في جدول "productView
".
المنتجات المتوفّرة في المستودع الحالي المنتجات الواردة في هذا الجدول مماثلة للمنتجات في واجهة برمجة التطبيقات الفرعية للمنتجات، ولكن لا تتوفر جميع سمات المنتجات من واجهة برمجة التطبيقات الفرعية للمنتجات لطلب البحث في هذا الجدول. وعلى عكس واجهة برمجة التطبيقات الفرعية للمنتجات، يسمح هذا الجدول بفلترة قائمة المنتجات التي تم إرجاعها حسب سمات المنتجات. لاسترداد منتج واحد بحلول id
أو إدراج كل المنتجات، يجب استخدام واجهة برمجة تطبيقات المنتجات الفرعية.
يتم ضبط القيم فقط للحقول المطلوبة صراحةً في طلب البحث الخاص بالطلب.
تمثيل JSON |
---|
{ "price": { object ( |
الحقول | |
---|---|
price |
سعر المنتج يتم التخلص من هذه المعلومات إذا كانت المعلومات عن سعر المنتج غير متوفرة. |
gtin[] |
قائمة بالأرقام التجارية العالمية للسلعة (أرقام GTIN) الخاصة بالمنتج |
creationTime |
الوقت الذي أنشأ فيه التاجر المنتج بالثواني |
expirationDate |
تاريخ انتهاء صلاحية المنتج المحدَّد عند إدراجه |
itemIssues[] |
قائمة مشاكل السلع الخاصة بالمنتج لا يمكن استخدام هذا الحقل لترتيب النتائج. يمكن استخدام السمات التي تم اختيارها لهذا الحقل (مثلاً |
clickPotential |
إمكانات الأداء المقدّرة مقارنةً بمنتجات التاجر الأفضل أداءً |
id |
تمثّل هذه السمة معرّف REST للمنتج في شكل مطلوبة في البند |
channel |
قناة المنتج يمكن أن يكون |
languageCode |
رمز لغة المنتج بتنسيق BCP 47 |
feedLabel |
تصنيف خلاصة المنتج |
offerId |
معرّف المنتج الذي قدّمه التاجر |
title |
عنوان المنتج. |
brand |
تمثّل هذه السمة العلامة التجارية للمنتج. |
categoryL1 |
فئة المنتج (المستوى الأول) في تصنيف المنتجات من Google. |
categoryL2 |
فئة المنتج (المستوى الثاني) في تصنيف المنتجات من Google. |
categoryL3 |
فئة المنتج (المستوى الثالث) في تصنيف المنتجات من Google. |
categoryL4 |
فئة المنتج (المستوى الرابع) في تصنيف المنتج من Google. |
categoryL5 |
فئة المنتج (المستوى الخامس) في تصنيف المنتجات من Google. |
productTypeL1 |
نوع المنتج (المستوى الأول) في تصنيف المنتج الخاصة بالتاجر. |
productTypeL2 |
نوع المنتج (المستوى الثاني) في تصنيف المنتجات الخاصة بالتاجر |
productTypeL3 |
نوع المنتج (المستوى الثالث) في تصنيف المنتج الخاصة بالتاجر. |
productTypeL4 |
نوع المنتج (المستوى الرابع) في تصنيف المنتج التي حدّدها التاجر. |
productTypeL5 |
نوع المنتج (المستوى الخامس) في تصنيف المنتج الخاصة بالتاجر. |
condition |
حالة المنتج: |
availability |
مدى توفّر المنتج. |
shippingLabel |
تصنيف الحزمة المسواة المحدد في مصدر البيانات. |
itemGroupId |
معرّف مجموعة السلع الذي قدّمه التاجر لتجميع خيارات المنتج معًا |
thumbnailLink |
رابط لصورة المنتج التي تمت معالجتها والمستضافة على بنية Google الأساسية |
aggregatedReportingContextStatus |
الحالة المجمّعة. |
clickPotentialRank |
ترتيب المنتج استنادًا إلى فرص النقر عليه. يحظى المنتج الذي يتضمّن القيمة |
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 ( |
الحقول | |
---|---|
type |
نوع المشكلة في السلعة |
severity |
درجة خطورة المشكلة في السلع: |
resolution |
حلّ المشكلة في السلع |
ItemIssueType
نوع المشكلة.
تمثيل JSON |
---|
{ "code": string, "canonicalAttribute": string } |
الحقول | |
---|---|
code |
رمز الخطأ الخاص بالمشكلة، يعادل |
canonicalAttribute |
اسم السمة الأساسية للمشاكل الخاصة بالسمات |
ItemIssueSeverity
كيفية تأثير المشكلة في عرض المنتج
تمثيل JSON |
---|
{ "severityPerReportingContext": [ { object ( |
الحقول | |
---|---|
severityPerReportingContext[] |
درجة خطورة المشاكل حسب سياق إعداد التقارير. |
aggregatedSeverity |
درجة الخطورة المُجمَّعة للمشكلة في جميع سياقات إعداد التقارير التي تؤثر فيها يمكن استخدام هذا الحقل لفلترة النتائج. |
IssueSeverityPerReportingContext
درجة خطورة المشاكل حسب سياق إعداد التقارير.
تمثيل JSON |
---|
{
"disapprovedCountries": [
string
],
"demotedCountries": [
string
],
"reportingContext": enum ( |
الحقول | |
---|---|
disapprovedCountries[] |
قائمة بالبلدان المرفوضة في سياق إعداد التقارير، ممثلة بتنسيق ISO 3166 |
demotedCountries[] |
قائمة بالبلدان التي تم خفض ترتيبها في سياق إعداد التقارير، ممثلة بتنسيق ISO 3166 |
reportingContext |
سياق إعداد التقارير الذي تنطبق عليه المشكلة |
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 |
أحدث مقياس سعر متوفّر لكتالوج المنتج في البلد الذي تم فيه قياس الأداء |
reportCountryCode |
بلد مقياس السعر ويتم تمثيلها بتنسيق ISO 3166. مطلوبة في البند |
id |
تمثّل هذه السمة معرّف REST للمنتج في شكل مطلوبة في البند |
offerId |
معرّف المنتج الذي قدّمه التاجر |
title |
عنوان المنتج. |
brand |
تمثّل هذه السمة العلامة التجارية للمنتج. |
categoryL1 |
فئة المنتج (المستوى الأول) في تصنيف المنتجات من Google. |
categoryL2 |
فئة المنتج (المستوى الثاني) في تصنيف المنتجات من Google. |
categoryL3 |
فئة المنتج (المستوى الثالث) في تصنيف المنتجات من Google. |
categoryL4 |
فئة المنتج (المستوى الرابع) في تصنيف المنتج من Google. |
categoryL5 |
فئة المنتج (المستوى الخامس) في تصنيف المنتجات من Google. |
productTypeL1 |
نوع المنتج (المستوى الأول) في تصنيف المنتج الخاصة بالتاجر. |
productTypeL2 |
نوع المنتج (المستوى الثاني) في تصنيف المنتجات الخاصة بالتاجر |
productTypeL3 |
نوع المنتج (المستوى الثالث) في تصنيف المنتج الخاصة بالتاجر. |
productTypeL4 |
نوع المنتج (المستوى الرابع) في تصنيف المنتج التي حدّدها التاجر. |
productTypeL5 |
نوع المنتج (المستوى الخامس) في تصنيف المنتج الخاصة بالتاجر. |
PriceInsightsProductView
الحقول المتاحة لطلب البحث في جدول "priceInsightsProductView
".
تقرير معلومات مفصّلة عن الأسعار
يتم ضبط القيم فقط للحقول المطلوبة صراحةً في طلب البحث الخاص بالطلب.
تمثيل JSON |
---|
{ "price": { object ( |
الحقول | |
---|---|
price |
السعر الحالي للمنتج |
suggestedPrice |
تمثّل هذه السمة أحدث سعر مقترَح للمنتج. |
effectiveness |
القيمة المتوقّعة لتطبيق اقتراح السعر، مجمّعة. |
id |
تمثّل هذه السمة معرّف REST للمنتج في شكل مطلوبة في البند |
offerId |
معرّف المنتج الذي قدّمه التاجر |
title |
عنوان المنتج. |
brand |
تمثّل هذه السمة العلامة التجارية للمنتج. |
categoryL1 |
فئة المنتج (المستوى الأول) في تصنيف المنتجات من Google. |
categoryL2 |
فئة المنتج (المستوى الثاني) في تصنيف المنتجات من Google. |
categoryL3 |
فئة المنتج (المستوى الثالث) في تصنيف المنتجات من Google. |
categoryL4 |
فئة المنتج (المستوى الرابع) في تصنيف المنتج من Google. |
categoryL5 |
فئة المنتج (المستوى الخامس) في تصنيف المنتجات من Google. |
productTypeL1 |
نوع المنتج (المستوى الأول) في تصنيف المنتج الخاصة بالتاجر. |
productTypeL2 |
نوع المنتج (المستوى الثاني) في تصنيف المنتجات الخاصة بالتاجر |
productTypeL3 |
نوع المنتج (المستوى الثالث) في تصنيف المنتج الخاصة بالتاجر. |
productTypeL4 |
نوع المنتج (المستوى الرابع) في تصنيف المنتج التي حدّدها التاجر. |
productTypeL5 |
نوع المنتج (المستوى الخامس) في تصنيف المنتج الخاصة بالتاجر. |
predictedImpressionsChangeFraction |
التغيير المتوقّع في مرات الظهور ككسر بعد تقديم السعر المقترَح مقارنةً بالسعر النشط الحالي على سبيل المثال، تمثّل القيمة 0.05 زيادة متوقعة في مرات الظهور بنسبة% 5. |
predictedClicksChangeFraction |
التغيير المتوقّع في النقرات بعد تقديم السعر المقترَح مقارنةً بالسعر النشط الحالي. على سبيل المثال، يمثّل 0.05 زيادة متوقعة في عدد النقرات بنسبة% 5. |
predictedConversionsChangeFraction |
التغيير المتوقّع في الإحالات الناجحة بمقدار جزء بعد تقديم السعر المقترَح مقارنةً بالسعر النشط الحالي على سبيل المثال، تمثّل القيمة 0.05 زيادة متوقعة في الإحالات الناجحة بنسبة% 5. |
الفاعلية
مجموعة بيانات الفعالية المتوقّعة
تشير الفعالية إلى المنتجات التي ستستفيد أكثر من تغيير الأسعار. يأخذ هذا التقييم في الاعتبار تحسّن الأداء المتوقّع من خلال تعديل السعر المخفَّض والفرق بين السعر الحالي والسعر المقترَح. يُتوقَّع أن تحقّق اقتراحات الأسعار ذات الفعالية HIGH
الزيادة الأكبر في مستوى الأداء.
عمليات التعداد | |
---|---|
EFFECTIVENESS_UNSPECIFIED |
الفعالية غير معروفة. |
LOW |
الفعالية منخفضة. |
MEDIUM |
الفعالية متوسطة. |
HIGH |
الفعالية عالية. |
BestSellersProductClusterView
الحقول المتاحة لطلب البحث في جدول "bestSellersProductClusterView
".
تقرير الأكثر مبيعًا: يتضمّن أهم مجموعات المنتجات. مجموعة المنتجات هي مجموعة تتضمّن عروضًا وخيارات مختلفة تمثّل المنتج نفسه، مثل Google Pixel 7.
يتم ضبط القيم فقط للحقول المطلوبة صراحةً في طلب البحث الخاص بالطلب.
تمثيل JSON |
---|
{ "reportDate": { object ( |
الحقول | |
---|---|
reportDate |
تاريخ التقرير يمكن أن تكون قيمة هذا الحقل واحدة فقط مما يلي:
مطلوبة في البند |
variantGtins[] |
أرقام GTIN لأمثلة على خيارات مجموعة المنتجات |
reportGranularity |
دقة التقرير ويمكن إجراء الترتيب على مدار إطار زمني أسبوعي أو شهر. مطلوبة في البند |
reportCountryCode |
البلد الذي يتم احتساب الترتيب فيه. ويتم تمثيلها بتنسيق ISO 3166. مطلوبة في البند |
reportCategoryId |
تشير هذه السمة إلى معرّف فئة المنتجات من Google لاحتساب ترتيب المنتجات، ويكون هذا المعرّف هو معرّف تصنيف المنتجات من Google. مطلوبة في البند |
title |
تمثّل هذه السمة عنوان مجموعة المنتجات. |
brand |
العلامة التجارية لمجموعة المنتجات. |
categoryL1 |
فئة المنتج (المستوى الأول) من مجموعة المنتجات، ويتم تمثيلها في تصنيف المنتجات من Google. |
categoryL2 |
فئة المنتج (المستوى الثاني) من مجموعة المنتجات، ويتم تمثيلها في تصنيف المنتجات من Google. |
categoryL3 |
فئة المنتج (المستوى الثالث) من مجموعة المنتجات، ويتم تمثيلها في تصنيف المنتجات من Google. |
categoryL4 |
فئة المنتج (المستوى الرابع) من مجموعة المنتجات، ويتم تمثيلها في تصنيف المنتجات من Google. |
categoryL5 |
فئة المنتج (المستوى الخامس) من مجموعة المنتجات، ويتم تمثيلها في تصنيف المنتجات من Google. |
inventoryStatus |
سواء كانت مجموعة المنتجات ولا يأخذ الحقل في الاعتبار فلتر البلدان في تقرير "الأكثر مبيعًا". |
brandInventoryStatus |
سواء كان هناك منتج واحد على الأقل من العلامة التجارية ولا يأخذ الحقل في الاعتبار فلتر البلدان في تقرير "الأكثر مبيعًا". |
rank |
مدى رواج مجموعة المنتجات على "إعلانات Google" ومساحات العرض المجانية في الفئة والبلد المحدّدَين، وذلك بالاستناد إلى العدد المقدّر للوحدات المباعة |
previousRank |
ترتيب مدى الرواج في الأسبوع أو الشهر السابق |
relativeDemand |
الطلب المقدَّر مقارنةً بمجموعة المنتجات الأكثر رواجًا في الفئة والبلد نفسيهما |
previousRelativeDemand |
الطلب المقدَّر مقارنةً بمجموعة المنتجات الأكثر رواجًا في الفئة والبلد نفسيهما في الأسبوع أو الشهر الماضيَين |
relativeDemandChange |
التغيير في الطلب المقدَّر. سواء كانت ترتفع أو غرقت أو ظلت مسطّحة |
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 ( |
الحقول | |
---|---|
reportDate |
تاريخ التقرير يمكن أن تكون قيمة هذا الحقل واحدة فقط مما يلي:
مطلوبة في البند |
reportGranularity |
دقة التقرير ويمكن إجراء الترتيب على مدار إطار زمني أسبوعي أو شهر. مطلوبة في البند |
reportCountryCode |
البلد الذي يتم احتساب الترتيب فيه. ويتم تمثيلها بتنسيق ISO 3166. مطلوبة في البند |
reportCategoryId |
تشير هذه السمة إلى معرّف فئة المنتجات من Google لاحتساب ترتيب المنتجات، ويكون هذا المعرّف هو معرّف تصنيف المنتجات من Google. مطلوبة في البند |
brand |
اسم العلامة التجارية. |
rank |
مدى رواج العلامة التجارية على "إعلانات Google" ومساحات العرض المجانية في الفئة والبلد المحدّدَين، وذلك بالاستناد إلى العدد المقدّر للوحدات المباعة |
previousRank |
ترتيب مدى الرواج في الأسبوع أو الشهر السابق |
relativeDemand |
الطلب المقدَّر مقارنةً بالعلامة التجارية الأكثر رواجًا في الفئة والبلد نفسيهما |
previousRelativeDemand |
الطلب المقدَّر مقارنةً بالعلامة التجارية الأكثر رواجًا في الفئة والبلد نفسيهما في الأسبوع أو الشهر الماضيَين |
relativeDemandChange |
التغيير في الطلب المقدَّر. سواء كانت ترتفع أو غرقت أو ظلت مسطّحة |
CompetitiveVisibilityCompetitorView
الحقول المتاحة لطلب البحث في جدول "competitiveVisibilityCompetitorView
".
يقدّم تقرير مستوى الظهور التنافسي تقارير عن الأنشطة التجارية التي تحقّق منتجاتها مستوى ظهور مشابه لمنتجاتك.
يتم ضبط القيم فقط للحقول المطلوبة صراحةً في طلب البحث الخاص بالطلب.
تمثيل JSON |
---|
{ "date": { object ( |
الحقول | |
---|---|
date |
تاريخ هذا الصف. يجب توفير شرط على |
domain |
نطاق منافسك أو نطاقك، إذا كانت "isYourDomain" true. مطلوبة في البند |
isYourDomain |
صحيح إذا كان هذا الصف يحتوي على بيانات لنطاقك. لا يمكن الفلترة في "WHERE" بند واحد. |
reportCountryCode |
البلد الذي ظهرت فيه مرّات الظهور مطلوبة في البند |
reportCategoryId |
معرّف فئة المنتجات من Google لاحتساب التقرير، ويكون هذا المعرّف مطلوبًا في تصنيف المنتجات من Google. مطلوبة في البند |
trafficSource |
مصدر الزيارات لمرّات الظهور مطلوبة في البند |
rank |
موضع النطاق في ترتيب الأنشطة التجارية المشابهة للمفاتيح التي تم اختيارها ( لا يمكن الفلترة في "WHERE" بند واحد. |
adsOrganicRatio |
توضّح نسبة ظهور إعلانات Shopping إلى الإعلانات المجانية عدد المرات التي تلقّى فيها النطاق مرات ظهور من إعلانات Shopping مقارنةً بالزيارات الواردة من نتائج البحث المجانية. يتم تقريب الرقم ووضعه ضمن مجموعة. لا يمكن الفلترة في "WHERE" بند واحد. |
pageOverlapRate |
معدّل التداخل في الصفحة: يعرض عدد المرات التي تظهر فيها عروض بائعي التجزئة المنافسين مع عروضك على الصفحة نفسها. لا يمكن الفلترة في "WHERE" بند واحد. |
higherPositionRate |
معدّل الظهور في موضع أعلى: يعرض عدد المرات التي ظهر فيها عرض أحد المنافسين في موضع أعلى من عرضك في الصفحة. لا يمكن الفلترة في "WHERE" بند واحد. |
relativeVisibility |
يعرض مقياس مستوى الظهور النسبي عدد مرّات ظهور عروض منافسيك مقارنةً بعروضك. بمعنى آخر، يشير هذا المقياس إلى عدد مرّات الظهور المعروضة لبائع تجزئة منافس مقسومًا على عدد مرّات الظهور المعروضة خلال نطاق زمني محدّد لفئة منتج وبلد محدّدَين. لا يمكن الفلترة في "WHERE" بند واحد. |
TrafficSourceEnum
قيم مصادر الزيارات
عمليات التعداد | |
---|---|
TRAFFIC_SOURCE_ENUM_UNSPECIFIED |
لم يتم تحديده. |
ORGANIC |
الزيارات الواردة من نتائج البحث المجانية: |
ADS |
الزيارات الواردة من الإعلانات |
ALL |
الزيارات الواردة من نتائج البحث المجانية والزيارات الواردة من الإعلانات |
CompetitiveVisibilityTopMerchantView
الحقول المتاحة لطلب البحث في جدول "competitiveVisibilityTopMerchantView
".
تقرير مستوى الظهور التنافسي الذي يعرض النشاط التجاري الذي يحقّق أعلى مستوى ظهور.
يتم ضبط القيم فقط للحقول المطلوبة صراحةً في طلب البحث الخاص بالطلب.
تمثيل JSON |
---|
{ "date": { object ( |
الحقول | |
---|---|
date |
تاريخ هذا الصف. لا يمكن اختياره في عبارة |
domain |
نطاق منافسك أو نطاقك، إذا كانت "isYourDomain" true. مطلوبة في البند |
isYourDomain |
صحيح إذا كان هذا الصف يحتوي على بيانات لنطاقك. لا يمكن الفلترة في "WHERE" بند واحد. |
reportCountryCode |
البلد الذي ظهرت فيه مرّات الظهور مطلوبة في البند |
reportCategoryId |
معرّف فئة المنتجات من Google لاحتساب التقرير، ويكون هذا المعرّف مطلوبًا في تصنيف المنتجات من Google. مطلوبة في البند |
trafficSource |
مصدر الزيارات لمرّات الظهور مطلوبة في البند |
rank |
موضع النطاق في أعلى ترتيب للتجّار للمفاتيح المحدّدة ( لا يمكن الفلترة في "WHERE" بند واحد. |
adsOrganicRatio |
توضّح نسبة ظهور إعلانات Shopping إلى الإعلانات المجانية عدد المرات التي تلقّى فيها النطاق مرات ظهور من إعلانات Shopping مقارنةً بالزيارات الواردة من نتائج البحث المجانية. يتم تقريب الرقم ووضعه ضمن مجموعة. لا يمكن الفلترة في "WHERE" بند واحد. |
pageOverlapRate |
معدّل التداخل في الصفحة: يعرض عدد المرات التي تظهر فيها عروض بائعي التجزئة المنافسين مع عروضك على الصفحة نفسها. لا يمكن الفلترة في "WHERE" بند واحد. |
higherPositionRate |
معدّل الظهور في موضع أعلى: يعرض عدد المرات التي ظهر فيها عرض أحد المنافسين في موضع أعلى من عرضك في الصفحة. لا يمكن الفلترة في "WHERE" بند واحد. |
CompetitiveVisibilityBenchmarkView
الحقول المتاحة لطلب البحث في جدول "competitiveVisibilityBenchmarkView
".
تقرير مستوى الظهور التنافسي الذي يتضمّن مقياس أداء الفئة.
يتم ضبط القيم فقط للحقول المطلوبة صراحةً في طلب البحث الخاص بالطلب.
تمثيل JSON |
---|
{ "date": { object ( |
الحقول | |
---|---|
date |
تاريخ هذا الصف. مطلوبة في البند |
reportCountryCode |
البلد الذي ظهرت فيه مرّات الظهور مطلوبة في البند |
reportCategoryId |
معرّف فئة المنتجات من Google لاحتساب التقرير، ويكون هذا المعرّف مطلوبًا في تصنيف المنتجات من Google. مطلوبة في البند |
trafficSource |
مصدر الزيارات لمرّات الظهور مطلوبة في البند |
yourDomainVisibilityTrend |
تغيير في مستوى الرؤية استنادًا إلى مرات الظهور لنطاقك في ما يتعلق ببدء النطاق الزمني المحدّد (أو اليوم الأول بمرات ظهور بخلاف الصفر). لا يمكن الفلترة في "WHERE" بند واحد. |
categoryBenchmarkVisibilityTrend |
يشير ذلك إلى التغيير في مستوى الظهور استنادًا إلى مرات الظهور في ما يتعلق ببداية النطاق الزمني المحدّد (أو في اليوم الأول بمرّات ظهور غير صفرية) لمجموعة مجمّعة من التجّار الذين يسجّلون أعلى مستوى ظهور بالقرب من السوق. لا يمكن الفلترة في "WHERE" بند واحد. |