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

تتيح لك "لغة طلبات البحث في إعلانات 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).
السابق
بنية طلب البحث
التالي
الحساسية لحالة الأحرف