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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

يتم إرسال التقارير القابلة للتجميع في غضون ساعة من التشغيل، ويتم تأجيلها عشوائيًا بين 10 دقائق وساعة.

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

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

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