النطاقات الزمنية

تتيح لك لغة طلب البحث في "إعلانات Google" تحديد النطاق الزمني بالطرق التالية:

نطاق زمني مخصص

يمكنك تحديد التواريخ بتنسيق ISO 8601 الموسّع (YYYY-MM-DD) أو الأساسي (YYYYMMDD). يُنصح باستخدام التنسيق الموسّع (YYYY-MM-DD) لتسهيل القراءة. استخدِم BETWEEN أو عوامل المقارنة (= أو > أو >= أو < أو <=) مع سلاسل التاريخ المخصّصة:

segments.date BETWEEN '2026-01-01' AND '2026-01-31'

segments.date >= '20260701' AND segments.date <= '20260731'

نطاق زمني محدّد مسبقًا

استخدِم عامل التشغيل DURING مع القيم الحرفية للنطاق الزمني المحدّد مسبقًا. يتيح عامل التشغيل DURING استخدام النطاقات الزمنية المحدّدة مسبقًا فقط، ولا يمكن استخدامه مع سلاسل التاريخ المخصّصة.

في ما يلي قائمة بالنطاقات الزمنية الصالحة والمحدّدة مسبقًا:

النطاق الزمني يتم إنشاء التقارير لـ...
TODAY اليوم فقط.
YESTERDAY أمس فقط
LAST_7_DAYS آخر 7 أيام، ولا يشمل ذلك اليوم.
LAST_BUSINESS_WEEK أسبوع العمل المكون من 5 أيام، من الاثنين إلى الجمعة، من أسبوع العمل السابق.
THIS_MONTH جميع الأيام في الشهر الحالي
LAST_MONTH جميع أيام الشهر الماضي
LAST_14_DAYS آخر 14 يومًا، باستثناء اليوم
LAST_30_DAYS آخر 30 يومًا، باستثناء اليوم.
THIS_WEEK_SUN_TODAY الفترة بين الأحد السابق واليوم الحالي
THIS_WEEK_MON_TODAY الفترة بين الاثنين السابق واليوم الحالي
LAST_WEEK_SUN_SAT الفترة التي تبلغ 7 أيام وتبدأ من يوم الأحد السابق
LAST_WEEK_MON_SUN الفترة التي تبلغ 7 أيام وتبدأ من يوم الاثنين السابق.

مثال:

segments.date DURING LAST_30_DAYS

فترة زمنية محدّدة مسبقًا

تشير بعض حقول التاريخ إلى فترة زمنية محدّدة مسبقًا، وتحديدًا:

  • segments.week
  • segments.month
  • segments.quarter

عند الفلترة حسب هذه الشرائح باستخدام سلاسل تاريخ مخصّصة (باستخدام = أو BETWEEN أو >= أو <= أو > أو <)، عليك تحديد تاريخ يمثّل اليوم الأول من الفترة الزمنية:

  • ‫segments.week: يوم الاثنين من الأسبوع (على سبيل المثال، '2026-05-04')
  • ‫segments.month: اليوم الأول من الشهر (YYYY-MM-01، على سبيل المثال، '2026-05-01').
  • ‫segments.quarter: اليوم الأول من ربع السنة التقويمية (YYYY-01-01 أو YYYY-04-01 أو YYYY-07-01 أو YYYY-10-01).

إذا حدّدت تاريخًا ليس اليوم الأول من الفترة، سيظهر الخطأ QueryError.MISALIGNED_DATE_FOR_FILTER. يمكنك أيضًا فلترة هذه الشرائح باستخدام عامل التشغيل DURING مع نطاق زمني محدّد مسبقًا.

على سبيل المثال، لتحديد شهر مايو في عام 2026، استخدِم الشرط التالي، مع تحديد اليوم الأول من ذلك الشهر:

segments.month = '2026-05-01'

حدود فترة معاينة الإعلان السابقة

يعتمد مدى توفّر بيانات التقارير السابقة على دقة شرائح التواريخ المحدّدة أو التي تمت فلترتها:

  • الدقة اليومية والأسبوعية وكل ساعة (segments.date وsegments.week وsegments.hour): تتيح فترة معاينة الإعلان تصل إلى 37 شهرًا. طلبات البحث التي تقسّم حسب segments.date أو segments.week أو segments.hour (أو تفلتر حسب نطاق زمني أقل من شهر) للتواريخ التي تتجاوز فترة الـ 37 شهرًا تتعذّر مع ظهور الخطأ DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED في الإصدار 24 والإصدارات الأحدث (أو DateRangeError.UNKNOWN في الإصدار 23).
  • مستوى عرض التفاصيل الشهري أو الربع سنوي أو السنوي أو غير المقسّم (segments.month أو segments.quarter أو segments.year أو بدون شريحة تاريخ): يتيح عرض بيانات سابقة لمدة تصل إلى 11 سنة. للاستعلام عن البيانات السابقة التي تتجاوز فترة الـ 37 شهرًا، يمكنك التقسيم حسب segments.month أو segments.quarter أو segments.year أو حذف شرائح التاريخ في SELECT، والتأكّد من أنّ النطاق الزمني لـ WHERE يبدأ في اليوم الأول من الشهر وينتهي في اليوم الأخير من الشهر (أو الفلاتر في segments.month أو segments.quarter أو segments.year).
السابق
بنية طلب البحث
التالي
الحساسية لحالة الأحرف