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

تتيح لك "لغة طلبات البحث في إعلانات 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 سوى النطاقات الزمنية المحدّدة مسبقًا، ولا يمكن استخدامه مع سلاسل التاريخ المخصّصة.

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

مثال:

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).