فترات التقارير المخصّصة

يمكن أن توفّر نوافذ التقارير المخصَّصة تقارير أسرع على مستوى الحدث وتقارير انتقائية للتقارير القابلة للتجميع.

من خلال فترات التقارير المخصّصة لإعداد تقارير الإحالة (التي يتم شحنها في Chrome 110)، يمكنك أن تطلب من المتصفح استبعاد الإحالات الناجحة التي تحدث بعد فترة زمنية معيّنة.

  • بالنسبة إلى التقارير على مستوى الحدث، تسمح لك فترات التقارير بالحصول على التقارير بشكلٍ أسرع، بالإضافة إلى فلترة الإحالات الناجحة التي تحدث بعد إطار زمني معيّن. حسب هدفك، هناك طريقة أخرى للنظر في هذا الأمر تتمثل في المقايضة: يوفر لك استخدام فترات التقارير وصولاً أسرع إلى التقارير، ولكنه يشير ضمنًا إلى احتمال خسارتك لبعض الإحالات الناجحة. راجِع القسم على مستوى الحدث للاطّلاع على التفاصيل.
  • بالنسبة إلى التقارير القابلة للتجميع، تسمح لك فترات التقارير بفلترة الإحالات الناجحة التي تحدث بعد إطار زمني معيّن. راجِع القسم القابل للتجميع للحصول على التفاصيل.

ما المقصود بنافذة التقرير المخصّص؟

وفترة التقرير المخصّص هي الفترة بعد تسجيل المصدر التي يمكن خلالها إنشاء تقارير من النوع المقابل (حدث أو قابل للتجميع) لهذا المصدر.

بالنسبة إلى التقارير على مستوى الحدث، تكون فترة التقرير أيضًا بمثابة النافذة الأخيرة التي سيتم فيها إرسال التقارير من النوع المقابل.

نقاط رئيسية حول فترات إعداد التقارير:

  • إذا لم يتم ضبط report_window، يعود إلى expiry.
  • وفي حال عدم ضبط expiry، يعود إلى القيمة التلقائية التي تبلغ 30 يومًا.
  • الحدّ الأدنى لفترة التقرير المخصّص هو يوم واحد. وحتى في حال ضبط فترة زمنية على أقل من يوم، سيتم تثبيت القيمة على يوم واحد. راجِع أمثلة التقارير على مستوى الحدث.
  • يتم تحديد فترة التقرير بالثواني.

تجدر الإشارة إلى أنّ طريقة عمل expiry لم تتغيّر، ويؤدّي استخدام expiry إلى تغيير مرّات الظهور أو النقرات المؤهَّلة لتحديد المصدر.

التقارير على مستوى الحدث: إعداد التقارير بشكل أسرع وإعداد تقارير انتقائية

يتم إرسال التقارير على مستوى الحدث تلقائيًا باتّباع جدول زمني لنوافذ التقارير المضمّنة: ثلاث نوافذ للنقرات ونافذة واحدة لمرّات المشاهدة.

بالنسبة إلى التقارير على مستوى الحدث، تتيح لك فترات التقارير المخصّصة إمكانية إجراء ما يلي:

  • يمكنك الحصول على التقارير بشكل أسرع. من بين أمور أخرى، تتيح لك فترات التقارير المخصّصة إمكانية الحصول على التقارير بعد يوم واحد من النقرة أو الظهور، بدلاً من الحد الأقصى الذي يبلغ يومين الذي تم فرضه من خلال النوافذ المدمجة لانتهاء الصلاحية قبل الإصدار 110 من Chrome.
  • احرص على فلترة الإحالات الناجحة التي تحدث بعد إطار زمني معيّن.

لاستخدام فترات التقارير للتقارير على مستوى الحدث، أضِف الحقل event_report_window إلى عنوان تسجيل المصدر في Attribution-Reporting-Register-Source.

event_report_window

تمت جدولة إرسال التقارير على مستوى الحدث في أبعد وقت بعد الوصول إلى فترة التقرير بوقت قصير.

أمثلة الجداول الزمنية للتقارير والنقرات على مستوى الحدث

انتهاء الصلاحية 
event_report_window
إذا حدثت إحالة ناجحة بعد يوم واحد من النقر، يُرسِل المتصفّح تقريرًا: التقارير التي تمّت فلترتها (لم يتم إرسالها) المتعلّقة بالإحالات الناجحة التي تحدث:
التلقائي (30 يومًا) (لم يتم الضبط) حوالي يومين بالإضافة إلى ساعة واحدة بعد النقر
سلوك إعداد التقارير التلقائي — النافذة المضمّنة رقم 1		 حوالي 30 يومًا بعد النقر
مخصص، تم ضبطه على 5 أيام (لم يتم الضبط) حوالي يومين بالإضافة إلى ساعة واحدة بعد النقر
سلوك إعداد التقارير التلقائي — النافذة المضمّنة رقم 1		 بعد أكثر من 5 أيام من النقر
التلقائي (30 يومًا) تم الضبط على يوم واحد. حوالي يوم واحد بالإضافة إلى ساعة واحدة بعد النقر

سلوك مخصّص بسبب فترة التقرير المخصّص. لاحظ كيف أن ذلك يجعلك هذا التقرير أسرع مقارنةً بالصف الأول، حيث تحتاج إلى انتظار أول نافذة مضمّنة (يومان).		 بعد أكثر من يوم واحد من النقر
مخصص، تم ضبطه على 5 أيام تم الضبط على يوم واحد. حوالي يوم واحد بالإضافة إلى ساعة واحدة بعد النقر

سلوك مخصّص بسبب فترة التقرير المخصّص		 بعد أكثر من يوم واحد من النقر
التلقائي (30 يومًا) ضبط على 4 ساعات حوالي يوم واحد بالإضافة إلى ساعة واحدة بعد النقر
سلوك مخصّص بسبب فترة التقرير المخصّص. ويرجع ذلك إلى سياسة التقييد: الحد الأدنى لفترة التقرير هو يوم واحد. وحتى في حال ضبط فترة تقرير على أقل من يوم واحد، على سبيل المثال 4 ساعات، سيتم تثبيت قيمتها على يوم واحد.		 بعد أكثر من يوم واحد من النقر

أمثلة على الجداول الزمنية للتقارير على مستوى الحدث وطرق العرض

انتهاء الصلاحية event_report_window إذا حدثت إحالة ناجحة بعد يوم واحد من حدوث النقرة، يُرسِل المتصفّح التقرير:
التلقائي (30 يومًا) (لم يتم الضبط) حوالي 30 يومًا بالإضافة إلى ساعة واحدة بعد المشاهدة
سلوك إعداد التقارير التلقائي
مخصص، تم ضبطه على 5 أيام (لم يتم الضبط) حوالي 5 أيام بالإضافة إلى ساعة واحدة بعد المشاهدة
سلوك إعداد التقارير التلقائي
التلقائي (30 يومًا) تم الضبط على يوم واحد. حوالي يوم واحد بالإضافة إلى ساعة واحدة بعد العرض
سلوك مخصّص بسبب فترة التقرير المخصّص
مخصص، تم ضبطه على 5 أيام تم الضبط على يوم واحد. حوالي يوم واحد بالإضافة إلى ساعة واحدة بعد العرض
سلوك مخصّص بسبب فترة التقرير المخصّص

التقارير المجمّعة: التقارير الانتقائية

بالنسبة إلى التقارير القابلة للتجميع، تكمن فائدة فترات التقارير في فلترة الإحالات الناجحة التي تحدث بعد إطار زمني معيّن فقط. لا فائدة من الحصول على التقارير بشكل أسرع.

لاستخدام نوافذ التقارير للتقارير القابلة للتجميع، أضِف الحقل التالي إلى عنوان تسجيل المصدر في Attribution-Reporting-Register-Source:

aggregatable_report_window

سيؤدي ذلك إلى استبعاد الإحالات الناجحة التي تحدث بعد إطار زمني معيّن.

تُرسَل التقارير المجمّعة في غضون ساعة من وقت التشغيل، وتتأخر بشكلٍ عشوائي لمدة تتراوح بين 10 دقائق وساعة.

انتهاء الصلاحية 
aggregatable_report_window
التقارير التي تمّت فلترتها (لم يتم إرسالها) المتعلّقة بالإحالات الناجحة التي تحدث:
التلقائي (30 يومًا) (لم يتم الضبط) أكثر من 30 يومًا بعد النقر أو المشاهدة
مخصص، تم ضبطه على 5 أيام (لم يتم الضبط) أكثر من 5 أيام بعد النقر أو المشاهدة
التلقائي (30 يومًا) تم الضبط على يوم واحد. أكثر من يوم واحد بعد النقر أو المشاهدة
مخصص، تم ضبطه على 5 أيام تم الضبط على يوم واحد. أكثر من يوم واحد بعد النقر أو المشاهدة
التلقائي (30 يومًا) ضبط على 4 ساعات أكثر من يوم واحد بعد النقر أو المشاهدة ويرجع ذلك إلى سياسة التقييد: الحد الأدنى لفترة التقرير هو يوم واحد. وحتى في حال ضبط فترة تقرير على أقل من يوم واحد، على سبيل المثال 4 ساعات، سيتم تثبيت قيمتها على يوم واحد.

التفاعل مع الملاحظات ومشاركتها

يمكنك المشاركة والتجريب باستخدام واجهة برمجة التطبيقات هذه.