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

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

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

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

ما هي نافذة التقرير المخصّص؟

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

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

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

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

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

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

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

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

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

لاستخدام نوافذ التقارير للتقارير على مستوى الحدث، أضِف الحقل 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 يومًا تقريبًا و1 ساعة من المشاهدة
السلوك التلقائي لإعداد التقارير
مخصّص، تم الإعداد على 5 أيام (لم يتم الضبط) بعد 5 أيام تقريبًا و1 ساعة من المشاهدة
السلوك التلقائي لإعداد التقارير
الإعداد التلقائي (30 يومًا) ضبطها على يوم واحد بعد يوم واحد تقريبًا وساعة واحدة من المشاهدة
سلوك مخصّص بسبب نافذة التقرير المخصّص
مخصّص، تم الإعداد على 5 أيام ضبطها على يوم واحد بعد يوم واحد تقريبًا وساعة واحدة من المشاهدة
سلوك مخصّص بسبب نافذة التقرير المخصّص

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

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

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

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

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

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

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

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