پنجره های گزارش سفارشی

پنجره‌های گزارش سفارشی می‌توانند گزارش‌های سریع‌تری در سطح رویداد و گزارش‌های انتخابی برای گزارش‌های تجمیعی ارائه دهند.

با استفاده از پنجره‌های گزارش سفارشی برای گزارش‌دهی نسبت‌دهی (که در کروم ۱۱۰ ارائه شده است)، می‌توانید به مرورگر دستور دهید تبدیل‌هایی را که پس از یک بازه زمانی خاص رخ می‌دهند، فیلتر کند.

  • برای گزارش‌های سطح رویداد، پنجره‌های گزارش به شما این امکان را می‌دهند که گزارش‌ها را سریع‌تر دریافت کنید، علاوه بر این، تبدیل‌هایی را که پس از یک بازه زمانی خاص انجام می‌شوند، فیلتر کنید. بسته به هدف شما، روش دیگری برای نگاه کردن به این موضوع، معامله کردن است: استفاده از پنجره‌های گزارش به شما دسترسی سریع‌تری به گزارش‌ها می‌دهد، اما به این معنی است که ممکن است برخی از تبدیل‌ها را از دست بدهید. برای جزئیات بیشتر ، بخش سطح رویداد را مرور کنید.
  • برای گزارش‌های تجمیعی، پنجره‌های گزارش به شما امکان می‌دهند تبدیل‌هایی را که پس از یک بازه زمانی خاص انجام می‌شوند، فیلتر کنید. برای جزئیات بیشتر ، بخش تجمیعی را مرور کنید.

پنجره گزارش سفارشی چیست؟

یک پنجره گزارش سفارشی، دوره زمانی پس از ثبت منبع است که طی آن می‌توان گزارش‌هایی از نوع مربوطه (رویداد یا قابل تجمیع) برای این منبع ایجاد کرد.

برای گزارش‌های سطح رویداد، یک پنجره گزارش همچنین به عنوان آخرین پنجره‌ای عمل می‌کند که در آن گزارش‌های مربوط به نوع مربوطه ارسال می‌شوند.

نکات کلیدی در مورد گزارش پنجره‌ها:

  • اگر هیچ report_window تنظیم نشده باشد، به expiry برمی‌گردد.
  • اگر expiry تعیین نشود، به حالت پیش‌فرض ۳۰ روز برمی‌گردد.
  • حداقل پنجره گزارش سفارشی یک روز است. حتی اگر پنجره‌ای کمتر از یک روز تنظیم کنید، مقدار آن به یک روز محدود می‌شود. مثال‌های گزارش‌های سطح رویداد را مرور کنید.
  • یک پنجره گزارش بر حسب ثانیه تعریف می‌شود.

توجه داشته باشید که نحوه‌ی عملکرد expiry بدون تغییر است؛ expiry تغییر می‌دهد که کدام نمایش‌ها یا کلیک‌ها واجد شرایط انتساب هستند.

گزارش‌های سطح رویداد: گزارش‌دهی سریع‌تر و گزارش‌دهی گزینشی

به طور پیش‌فرض، گزارش‌های سطح رویداد طبق برنامه‌ای از پنجره‌های گزارش داخلی ارسال می‌شوند: سه پنجره برای کلیک‌ها و یک پنجره برای نمایش‌ها.

برای گزارش‌های سطح رویداد، پنجره‌های گزارش سفارشی شما را قادر می‌سازند تا:

  • دریافت سریع‌تر گزارش‌ها. در میان چیزهای دیگر، پنجره‌های گزارش سفارشی به شما این امکان را می‌دهند که گزارش‌ها را یک روز پس از کلیک یا نمایش دریافت کنید، به جای محدودیت دو روزه که توسط پنجره‌های انقضای داخلی قبل از کروم ۱۱۰ اعمال می‌شد.
  • تبدیل‌هایی که پس از یک بازه زمانی خاص اتفاق می‌افتند را فیلتر کنید.

برای استفاده از پنجره‌های گزارش برای گزارش‌های سطح رویداد، فیلد event_report_window را به سربرگ ثبت منبع Attribution-Reporting-Register-Source خود اضافه کنید.

گزارش‌های سطح رویداد قرار است حداکثر اندکی پس از رسیدن به بازه زمانی گزارش ارسال شوند.

مثال‌هایی برای گزارش‌های سطح رویداد و کلیک‌ها زمان‌بندی کنید

انقضا event_report_window اگر یک روز پس از کلیک، تبدیلی انجام شود، مرورگر گزارش زیر را ارسال می‌کند: گزارش‌های فیلتر شده (ارسال نشده) برای تبدیل‌های در حال انجام:
پیش‌فرض (30 روز) (تنظیم نشده) حدود ۲ روز به اضافه ۱ ساعت بعد از کلیک
رفتار گزارش‌دهی پیش‌فرض — پنجره داخلی شماره ۱		 حدود 30 روز پس از کلیک
سفارشی، تنظیم شده روی ۵ روز (تنظیم نشده) حدود ۲ روز به اضافه ۱ ساعت بعد از کلیک
رفتار گزارش‌دهی پیش‌فرض — پنجره داخلی شماره ۱		 بیش از ۵ روز پس از کلیک
پیش‌فرض (30 روز) روی ۱ روز تنظیم شده حدود ۱ روز به اضافه ۱ ساعت بعد از کلیک

رفتار سفارشی به دلیل پنجره گزارش سفارشی شما. توجه داشته باشید که چگونه این کار این گزارش را سریعتر از ردیف اول به شما می‌دهد، جایی که باید برای اولین پنجره داخلی (۲ روز) منتظر بمانید.		 بیش از ۱ روز پس از کلیک
سفارشی، تنظیم شده روی ۵ روز روی ۱ روز تنظیم شده حدود ۱ روز به اضافه ۱ ساعت بعد از کلیک

رفتار سفارشی ناشی از پنجره گزارش سفارشی شما		 بیش از ۱ روز پس از کلیک
پیش‌فرض (30 روز) روی ۴ ساعت تنظیم شده حدود ۱ روز به اضافه ۱ ساعت بعد از کلیک
رفتار سفارشی به دلیل پنجره گزارش سفارشی شما. این به دلیل محدودیت زمانی است: حداقل پنجره گزارش یک روز است. حتی اگر یک پنجره گزارش را روی کمتر از یک روز، مثلاً ۴ ساعت، تنظیم کنید، مقدار آن به یک روز محدود می‌شود.		 بیش از ۱ روز پس از کلیک

مثال‌های زمان‌بندی برای گزارش‌ها و نماهای سطح رویداد

انقضا event_report_window اگر یک روز پس از کلیک، تبدیلی انجام شود، مرورگر گزارش زیر را ارسال می‌کند:
پیش‌فرض (30 روز) (تنظیم نشده) حدود ۳۰ روز به علاوه ۱ ساعت پس از مشاهده
رفتار گزارش‌دهی پیش‌فرض
سفارشی، تنظیم شده روی ۵ روز (تنظیم نشده) حدود ۵ روز به اضافه ۱ ساعت پس از مشاهده
رفتار گزارش‌دهی پیش‌فرض
پیش‌فرض (30 روز) روی ۱ روز تنظیم شده حدود ۱ روز به اضافه ۱ ساعت پس از مشاهده
رفتار سفارشی ناشی از پنجره گزارش سفارشی شما
سفارشی، تنظیم شده روی ۵ روز روی ۱ روز تنظیم شده حدود ۱ روز به اضافه ۱ ساعت پس از مشاهده
رفتار سفارشی ناشی از پنجره گزارش سفارشی شما

گزارش‌های قابل جمع‌آوری: گزارش‌دهی گزینشی

برای گزارش‌های تجمیعی، مزیت پنجره‌های گزارش فقط فیلتر کردن تبدیل‌هایی است که پس از یک بازه زمانی خاص اتفاق می‌افتند. هیچ مزیتی از نظر دریافت سریع‌تر گزارش‌ها وجود ندارد.

برای استفاده از پنجره‌های گزارش برای گزارش‌های تجمیعی، فیلد aggregatable_report_window را به سربرگ ثبت منبع Attribution-Reporting-Register-Source خود اضافه کنید.

این کار تبدیل‌هایی را که پس از یک بازه زمانی مشخص اتفاق می‌افتند، فیلتر می‌کند.

گزارش‌های تجمیعی ظرف یک ساعت پس از فعال شدن ارسال می‌شوند؛ آن‌ها به صورت تصادفی بین ۱۰ دقیقه تا یک ساعت تأخیر دارند.

انقضا aggregatable_report_window گزارش‌های فیلتر شده (ارسال نشده) برای تبدیل‌های در حال انجام:
پیش‌فرض (30 روز) (تنظیم نشده) بیش از 30 روز پس از کلیک یا مشاهده
سفارشی، تنظیم شده روی ۵ روز (تنظیم نشده) بیش از ۵ روز پس از کلیک یا مشاهده
پیش‌فرض (30 روز) روی ۱ روز تنظیم شده بیش از ۱ روز پس از کلیک یا مشاهده
سفارشی، تنظیم شده روی ۵ روز روی ۱ روز تنظیم شده بیش از ۱ روز پس از کلیک یا مشاهده
پیش‌فرض (30 روز) روی ۴ ساعت تنظیم شده بیش از ۱ روز پس از کلیک یا مشاهده. این به دلیل محدودیت زمانی است: حداقل پنجره گزارش یک روز است. حتی اگر پنجره گزارش را روی کمتر از یک روز، مثلاً ۴ ساعت، تنظیم کنید، مقدار آن به یک روز محدود می‌شود.

مشارکت کنید و بازخورد خود را به اشتراک بگذارید

شما می‌توانید در این API شرکت کنید و آن را آزمایش کنید .