بخش 1 از 3 در مورد اشکال زدایی گزارش انتساب. بیاموزید که چرا اشکال زدایی اهمیت دارد و چه زمانی از گزارش های اشکال زدایی در آزمایش استفاده کنید.
چرا به گزارش های اشکال زدایی نیاز دارید؟
اگر در حال آزمایش Attribution Reporting API هستید، باید بررسی کنید که ادغام شما به درستی کار می‌کند، شکاف‌های نتایج اندازه‌گیری بین پیاده‌سازی مبتنی بر کوکی و اجرای گزارش Attribution خود را درک کنید، و هرگونه مشکلی را در ادغام خود عیب‌یابی کنید.
گزارش های اشکال زدایی برای تکمیل این وظایف مورد نیاز است. بنابراین، ما قویاً توصیه می کنیم آنها را تنظیم کنید.
واژه نامه
جنبه های کلیدی گزارش های اشکال زدایی
دو نوع گزارش اشکال زدایی
دو نوع گزارش اشکال زدایی موجود است. از هر دو استفاده کنید، زیرا موارد استفاده متفاوتی را برآورده می کنند.
گزارش های اشکال زدایی موفقیت آمیز
گزارش‌های اشکال‌زدایی موفقیت‌آمیز تولید موفقیت‌آمیز گزارش انتساب را دنبال می‌کنند. آنها مستقیماً به گزارش اسناد مربوط می شوند.
گزارش‌های اشکال‌زدایی موفقیت آمیز از Chrome 101 (آوریل 2022) در دسترس بوده است.
گزارش های عیب یابی کامل
گزارش‌های عیب‌زدایی پرمخاطب به شما دید بیشتری نسبت به منبع و رویدادهای راه‌انداز می‌دهد—بنابراین می‌توانید اطمینان حاصل کنید که منابع با موفقیت ثبت شده‌اند، یا گزارش‌های گمشده را ردیابی کنید و علت گم شدن آنها را تعیین کنید (شکست در رویدادهای منبع یا راه‌انداز، شکست در هنگام ارسال یا تولید گزارش). گزارش های عیب یابی کامل نشان می دهد:
- مواردی که مرورگر با موفقیت یک منبع را ثبت کرده است.
- مواردی که مرورگر با موفقیت یک رویداد منبع یا راه‌انداز را ثبت نکرده است - به این معنی که گزارش انتساب ایجاد نمی‌کند.
- مواردی که به دلایلی نمی توان گزارش انتساب ایجاد یا ارسال کرد .
گزارش‌های اشکال‌زدایی کامل شامل یک فیلد type است که ثبت منبع موفق یا دلیل ایجاد نشدن منبع، راه‌انداز یا گزارش انتساب را توضیح می‌دهد.
گزارش‌های اشکال‌زدایی کامل از Chrome 109 (ژانویه 2023) در دسترس بوده است - به جز گزارش‌های اشکال‌زدایی کامل در ثبت منبع که بعداً در Chrome 112 اضافه شده‌اند.
گزارش‌های نمونه را در قسمت 2 مرور کنید: گزارش‌های اشکال‌زدایی را تنظیم کنید .
گزارش‌های اشکال‌زدایی مبتنی بر کوکی هستند
برای استفاده از گزارش‌های اشکال‌زدایی، منبع گزارش باید یک کوکی تنظیم کند .
اگر منبع پیکربندی شده برای دریافت گزارش ها شخص ثالث باشد، این کوکی یک کوکی شخص ثالث خواهد بود. این چند پیامد کلیدی دارد:
- گزارش‌های اشکال‌زدایی تنها در صورتی ایجاد می‌شوند که کوکی‌های شخص ثالث در مرورگر کاربر مجاز باشند .
- پس از حذف تدریجی کوکی‌های شخص ثالث، گزارش‌های اشکال‌زدایی دیگر در دسترس نخواهند بود .
گزارش های اشکال زدایی بلافاصله ارسال می شود
گزارش های اشکال زدایی بلافاصله توسط مرورگر به مبدا گزارش ارسال می شود. این برخلاف گزارش‌های انتساب است که با تأخیر ارسال می‌شوند.
گزارش‌های اشکال‌زدایی موفقیت‌آمیز به‌محض ایجاد گزارش انتساب مربوطه ایجاد و ارسال می‌شوند: یعنی در هنگام ثبت نام.
گزارش‌های عیب‌زدایی کامل بلافاصله پس از ثبت منبع یا راه‌انداز ارسال می‌شوند.
گزارش های اشکال زدایی مسیرهای نقطه پایانی متفاوتی دارند
مانند گزارش‌های انتساب، همه گزارش‌های اشکال‌زدایی به منبع گزارش ارسال می‌شوند. گزارش‌های اشکال‌زدایی به سه نقطه پایانی جداگانه مبدا گزارش ارسال می‌شوند:
- نقطه پایانی برای گزارش‌های اشکال‌زدایی موفقیت آمیز ، در سطح رویداد
- نقطه پایانی برای گزارش های اشکال زدایی موفقیت آمیز ، قابل جمع آوری
- نقطه پایانی برای گزارش‌های اشکال‌زدایی مفصل ، در سطح رویداد و جمع‌آوری‌پذیر.
در قسمت 2 بیشتر بیاموزید: گزارش های اشکال زدایی را تنظیم کنید .
موارد استفاده کنید
بررسی ادغام در زمان واقعی
گزارش‌های اشکال‌زدایی بر خلاف گزارش‌های انتساب که برای محافظت از حریم خصوصی کاربر به تأخیر می‌افتند، بلافاصله به نقطه پایانی شما ارسال می‌شوند. از گزارش‌های اشکال‌زدایی به‌عنوان یک سیگنال هم‌زمان مبنی بر اینکه ادغام شما با API گزارش Attribution کار می‌کند، استفاده کنید.
نحوه انجام این کار را در قسمت 3: کتاب آشپزی اشکال زدایی بیاموزید.
تجزیه و تحلیل ضرر
برخلاف کوکی‌های شخص ثالث، API گزارش Attribution شامل محافظت‌های داخلی از حریم خصوصی است که برای ایجاد تعادل بین ابزار و حریم خصوصی طراحی شده‌اند. این بدان معناست که با API گزارش Attribution، ممکن است نتوانید تمام داده‌های اندازه‌گیری را که در حال حاضر با کوکی‌ها جمع‌آوری می‌کنید، جمع‌آوری کنید. همه تبدیل‌هایی که می‌توانید با کوکی‌های شخص ثالث پیگیری کنید، گزارش انتساب ایجاد نمی‌کنند.
یک مثال: برای گزارش‌های سطح رویداد، می‌توانید حداکثر یک تبدیل در هر نمایش ثبت کنید. این به این معنی است که برای یک نمایش تبلیغاتی معین، شما فقط یک گزارش انتساب دریافت خواهید کرد، مهم نیست که کاربر چند بار تبدیل کند.
از گزارش‌های اشکال‌زدایی استفاده کنید تا تفاوت‌های بین نتایج اندازه‌گیری مبتنی بر کوکی و نتایجی را که با API گزارش Attribution به دست می‌آورید مشاهده کنید. مشخص کنید کدام تبدیل‌ها گزارش شده‌اند، چه تعداد تبدیل گزارش نشده‌اند، و مشخصاً کدام‌ها و چرا.
نحوه اجرای تجزیه و تحلیل ضرر را در قسمت 3: اشکال زدایی کتاب آشپزی بیاموزید.
عیب یابی
در حالی که خسارات ناشی از حفظ حریم خصوصی یا منابع مورد انتظار است، ضررهای دیگر ممکن است ناخواسته باشد. پیکربندی اشتباه در پیاده سازی شما یا اشکالات در خود مرورگر می تواند باعث از بین رفتن گزارش ها شود.
می‌توانید از گزارش‌های اشکال‌زدایی برای شناسایی و رفع مشکل پیاده‌سازی در سمت خود یا گزارش یک اشکال احتمالی به تیم‌های مرورگر استفاده کنید. نحوه انجام این کار را در قسمت 3: کتاب آشپزی اشکال زدایی بیاموزید.
بررسی تنظیمات پیشرفته
برخی از ویژگی های Attribution Reporting API به شما امکان می دهد رفتارهای API را سفارشی کنید. قوانین فیلترینگ، قوانین حذف مجدد و قوانین اولویت چند نمونه هستند.
هنگام استفاده از این ویژگی ها، از گزارش های اشکال زدایی استفاده کنید تا بررسی کنید که منطق شما به رفتار مورد نظر در تولید منجر می شود، بدون اینکه منتظر گزارش های انتساب باشید. نحوه انجام این کار را در قسمت 3: کتاب آشپزی اشکال زدایی بیاموزید.
آزمایش محلی با گزارش های انبوه
برخلاف گزارش‌های اسناد انباشته‌ای که رمزگذاری شده‌اند، گزارش‌های اشکال‌زدایی قابل جمع‌آوری شامل بار رمزگذاری نشده است.
از گزارش‌های اشکال‌زدایی قابل جمع‌آوری برای اعتبارسنجی محتوای گزارش‌های جمع‌آوری‌شده و برای تولید گزارش‌های خلاصه با ابزار تجمع محلی برای آزمایش استفاده کنید.
پردازش مجدد گزارش های سرویس تجمع
یکی دیگر از مزایای استفاده از حالت اشکال زدایی این است که به شما امکان می دهد دوباره گزارش ها را پردازش کنید. بنابراین، برای پردازش گزارش‌ها بیش از یک بار، مطمئن شوید که گزارش‌های اشکال زدایی را فعال کنید. ممکن است بخواهید گزارش ها را دوباره پردازش کنید زمانی که:
- تلاش برای اشکال زدایی سرویس Aggregation.
- آزمایش با استراتژی های مختلف بچینگ
- آزمایش با مقادیر مختلف اپسیلون
بازیابی اطلاعات
ما به متخصصان تبلیغات توصیه می‌کنیم حالت اشکال‌زدایی را برای دریافت گزارش‌های اشکال‌زدایی فعال کنند تا بتوانند داده‌های گزارش خود را بازیابی کنند. این در مواردی که سرویس‌های جمع‌آوری مشکلاتی دارند، مانند سرویس‌های دردسترس یا غیر پاسخگو که ممکن است باعث شکست تولید گزارش خلاصه شوند، مفید است.
تا بعدی
بخش 2: تنظیم گزارش های اشکال زدایی
،بخش 1 از 3 در مورد اشکال زدایی گزارش انتساب. بیاموزید که چرا اشکال زدایی اهمیت دارد و چه زمانی از گزارش های اشکال زدایی در آزمایش استفاده کنید.
چرا به گزارش های اشکال زدایی نیاز دارید؟
اگر در حال آزمایش Attribution Reporting API هستید، باید بررسی کنید که ادغام شما به درستی کار می‌کند، شکاف‌های نتایج اندازه‌گیری بین پیاده‌سازی مبتنی بر کوکی و اجرای گزارش Attribution خود را درک کنید، و هرگونه مشکلی را در ادغام خود عیب‌یابی کنید.
گزارش های اشکال زدایی برای تکمیل این وظایف مورد نیاز است. بنابراین، ما قویاً توصیه می کنیم آنها را تنظیم کنید.
واژه نامه
جنبه های کلیدی گزارش های اشکال زدایی
دو نوع گزارش اشکال زدایی
دو نوع گزارش اشکال زدایی موجود است. از هر دو استفاده کنید، زیرا موارد استفاده متفاوتی را برآورده می کنند.
گزارش های اشکال زدایی موفقیت آمیز
گزارش‌های اشکال‌زدایی موفقیت‌آمیز تولید موفقیت‌آمیز گزارش انتساب را دنبال می‌کنند. آنها مستقیماً به گزارش اسناد مربوط می شوند.
گزارش‌های اشکال‌زدایی موفقیت آمیز از Chrome 101 (آوریل 2022) در دسترس بوده است.
گزارش های عیب یابی کامل
گزارش‌های عیب‌زدایی پرمخاطب به شما دید بیشتری نسبت به منبع و رویدادهای راه‌انداز می‌دهد—بنابراین می‌توانید اطمینان حاصل کنید که منابع با موفقیت ثبت شده‌اند، یا گزارش‌های گمشده را ردیابی کنید و علت گم شدن آنها را تعیین کنید (شکست در رویدادهای منبع یا راه‌انداز، شکست در هنگام ارسال یا تولید گزارش). گزارش های عیب یابی کامل نشان می دهد:
- مواردی که مرورگر با موفقیت یک منبع را ثبت کرده است.
- مواردی که مرورگر با موفقیت یک رویداد منبع یا راه‌انداز را ثبت نکرده است - به این معنی که گزارش انتساب ایجاد نمی‌کند.
- مواردی که به دلایلی نمی توان گزارش انتساب ایجاد یا ارسال کرد .
گزارش‌های اشکال‌زدایی کامل شامل یک فیلد type است که ثبت منبع موفق یا دلیل ایجاد نشدن منبع، راه‌انداز یا گزارش انتساب را توضیح می‌دهد.
گزارش‌های اشکال‌زدایی کامل از Chrome 109 (ژانویه 2023) در دسترس بوده است - به جز گزارش‌های اشکال‌زدایی کامل در ثبت منبع که بعداً در Chrome 112 اضافه شده‌اند.
گزارش‌های نمونه را در قسمت 2 مرور کنید: گزارش‌های اشکال‌زدایی را تنظیم کنید .
گزارش‌های اشکال‌زدایی مبتنی بر کوکی هستند
برای استفاده از گزارش‌های اشکال‌زدایی، منبع گزارش باید یک کوکی تنظیم کند .
اگر منبع پیکربندی شده برای دریافت گزارش ها شخص ثالث باشد، این کوکی یک کوکی شخص ثالث خواهد بود. این چند پیامد کلیدی دارد:
- گزارش‌های اشکال‌زدایی تنها در صورتی ایجاد می‌شوند که کوکی‌های شخص ثالث در مرورگر کاربر مجاز باشند .
- پس از حذف تدریجی کوکی‌های شخص ثالث، گزارش‌های اشکال‌زدایی دیگر در دسترس نخواهند بود .
گزارش های اشکال زدایی بلافاصله ارسال می شود
گزارش های اشکال زدایی بلافاصله توسط مرورگر به مبدا گزارش ارسال می شود. این برخلاف گزارش‌های انتساب است که با تأخیر ارسال می‌شوند.
گزارش‌های اشکال‌زدایی موفقیت‌آمیز به‌محض ایجاد گزارش انتساب مربوطه ایجاد و ارسال می‌شوند: یعنی در هنگام ثبت نام.
گزارش‌های عیب‌زدایی کامل بلافاصله پس از ثبت منبع یا راه‌انداز ارسال می‌شوند.
گزارش های اشکال زدایی مسیرهای نقطه پایانی متفاوتی دارند
مانند گزارش‌های انتساب، همه گزارش‌های اشکال‌زدایی به منبع گزارش ارسال می‌شوند. گزارش‌های اشکال‌زدایی به سه نقطه پایانی جداگانه مبدا گزارش ارسال می‌شوند:
- نقطه پایانی برای گزارش‌های اشکال‌زدایی موفقیت آمیز ، در سطح رویداد
- نقطه پایانی برای گزارش های اشکال زدایی موفقیت آمیز ، قابل جمع آوری
- نقطه پایانی برای گزارش‌های اشکال‌زدایی مفصل ، در سطح رویداد و جمع‌آوری‌پذیر.
در قسمت 2 بیشتر بیاموزید: گزارش های اشکال زدایی را تنظیم کنید .
موارد استفاده کنید
بررسی ادغام در زمان واقعی
گزارش‌های اشکال‌زدایی بر خلاف گزارش‌های انتساب که برای محافظت از حریم خصوصی کاربر به تأخیر می‌افتند، بلافاصله به نقطه پایانی شما ارسال می‌شوند. از گزارش‌های اشکال‌زدایی به‌عنوان یک سیگنال هم‌زمان مبنی بر اینکه ادغام شما با API گزارش Attribution کار می‌کند، استفاده کنید.
نحوه انجام این کار را در قسمت 3: کتاب آشپزی اشکال زدایی بیاموزید.
تجزیه و تحلیل ضرر
برخلاف کوکی‌های شخص ثالث، API گزارش Attribution شامل محافظت‌های داخلی از حریم خصوصی است که برای ایجاد تعادل بین ابزار و حریم خصوصی طراحی شده‌اند. این بدان معناست که با API گزارش Attribution، ممکن است نتوانید تمام داده‌های اندازه‌گیری را که در حال حاضر با کوکی‌ها جمع‌آوری می‌کنید، جمع‌آوری کنید. همه تبدیل‌هایی که می‌توانید با کوکی‌های شخص ثالث پیگیری کنید، گزارش انتساب ایجاد نمی‌کنند.
یک مثال: برای گزارش‌های سطح رویداد، می‌توانید حداکثر یک تبدیل در هر نمایش ثبت کنید. این به این معنی است که برای یک نمایش تبلیغاتی معین، شما فقط یک گزارش انتساب دریافت خواهید کرد، مهم نیست که کاربر چند بار تبدیل کند.
از گزارش‌های اشکال‌زدایی استفاده کنید تا تفاوت‌های بین نتایج اندازه‌گیری مبتنی بر کوکی و نتایجی را که با API گزارش Attribution به دست می‌آورید مشاهده کنید. مشخص کنید کدام تبدیل‌ها گزارش شده‌اند، چه تعداد تبدیل گزارش نشده‌اند، و مشخصاً کدام‌ها و چرا.
نحوه اجرای تجزیه و تحلیل ضرر را در قسمت 3: اشکال زدایی کتاب آشپزی بیاموزید.
عیب یابی
در حالی که خسارات ناشی از حفظ حریم خصوصی یا منابع مورد انتظار است، ضررهای دیگر ممکن است ناخواسته باشد. پیکربندی اشتباه در پیاده سازی شما یا اشکالات در خود مرورگر می تواند باعث از بین رفتن گزارش ها شود.
می‌توانید از گزارش‌های اشکال‌زدایی برای شناسایی و رفع مشکل پیاده‌سازی در سمت خود یا گزارش یک اشکال احتمالی به تیم‌های مرورگر استفاده کنید. نحوه انجام این کار را در قسمت 3: کتاب آشپزی اشکال زدایی بیاموزید.
بررسی تنظیمات پیشرفته
برخی از ویژگی های Attribution Reporting API به شما امکان می دهد رفتارهای API را سفارشی کنید. قوانین فیلترینگ، قوانین حذف مجدد و قوانین اولویت چند نمونه هستند.
هنگام استفاده از این ویژگی ها، از گزارش های اشکال زدایی استفاده کنید تا بررسی کنید که منطق شما به رفتار مورد نظر در تولید منجر می شود، بدون اینکه منتظر گزارش های انتساب باشید. نحوه انجام این کار را در قسمت 3: کتاب آشپزی اشکال زدایی بیاموزید.
آزمایش محلی با گزارش های انبوه
برخلاف گزارش‌های اسناد انباشته‌ای که رمزگذاری شده‌اند، گزارش‌های اشکال‌زدایی قابل جمع‌آوری شامل بار رمزگذاری نشده است.
از گزارش‌های اشکال‌زدایی قابل جمع‌آوری برای اعتبارسنجی محتوای گزارش‌های جمع‌آوری‌شده و برای تولید گزارش‌های خلاصه با ابزار تجمع محلی برای آزمایش استفاده کنید.
پردازش مجدد گزارش های سرویس تجمع
یکی دیگر از مزایای استفاده از حالت اشکال زدایی این است که به شما امکان می دهد دوباره گزارش ها را پردازش کنید. بنابراین، برای پردازش گزارش‌ها بیش از یک بار، مطمئن شوید که گزارش‌های اشکال زدایی را فعال کنید. ممکن است بخواهید گزارش ها را دوباره پردازش کنید زمانی که:
- تلاش برای اشکال زدایی سرویس Aggregation.
- آزمایش با استراتژی های مختلف بچینگ
- آزمایش با مقادیر مختلف اپسیلون
بازیابی اطلاعات
ما به متخصصان تبلیغات توصیه می‌کنیم حالت اشکال‌زدایی را برای دریافت گزارش‌های اشکال‌زدایی فعال کنند تا بتوانند داده‌های گزارش خود را بازیابی کنند. این در مواردی که سرویس‌های جمع‌آوری مشکلاتی دارند، مانند سرویس‌های دردسترس یا غیر پاسخگو که ممکن است باعث شکست تولید گزارش خلاصه شوند، مفید است.