بخش ۱ از ۳ درباره اشکالزدایی گزارشدهی انتسابی. بیاموزید که چرا اشکالزدایی اهمیت دارد و چه زمانی باید از گزارشهای اشکالزدایی در آزمایش استفاده کرد.
چرا به گزارشهای اشکالزدایی نیاز دارید
اگر در حال آزمایش API گزارشدهی نسبتدهی هستید، باید بررسی کنید که آیا ادغام شما به درستی کار میکند، شکافهای موجود در نتایج اندازهگیری بین پیادهسازی مبتنی بر کوکی و پیادهسازی گزارشدهی نسبتدهی خود را درک کنید و هرگونه مشکل مربوط به ادغام خود را عیبیابی کنید.
گزارشهای اشکالزدایی برای تکمیل این وظایف ضروری هستند. بنابراین، اکیداً توصیه میکنیم که آنها را تنظیم کنید.
واژهنامه
جنبههای کلیدی گزارشهای اشکالزدایی
دو نوع گزارش اشکالزدایی
دو نوع گزارش اشکالزدایی موجود است. از هر دو استفاده کنید، زیرا موارد استفاده متفاوتی را برآورده میکنند.
گزارشهای اشکالزدایی موفقیتآمیز
گزارشهای اشکالزدایی موفقیتآمیز، تولید موفقیتآمیز یک گزارش انتساب را ردیابی میکنند. آنها مستقیماً به یک گزارش انتساب مربوط میشوند.
گزارشهای اشکالزدایی موفقیتآمیز از زمان کروم ۱۰۱ (آوریل ۲۰۲۲) در دسترس بودهاند.
گزارشهای اشکالزدایی مفصل
گزارشهای اشکالزدایی مفصل، دید بیشتری نسبت به منبع و رویدادهای محرک به شما میدهند - بنابراین میتوانید مطمئن شوید که منابع با موفقیت ثبت شدهاند، یا گزارشهای از دست رفته را پیگیری کنید و دلیل از دست رفتن آنها را تعیین کنید (خرابی در منبع یا رویدادهای محرک، خرابی هنگام ارسال یا تولید گزارش). گزارشهای اشکالزدایی مفصل موارد زیر را نشان میدهند:
- مواردی که مرورگر با موفقیت یک منبع را ثبت کرده است.
- مواردی که مرورگر با موفقیت منبع یا رویدادی را ثبت نکرده است - به این معنی که گزارش انتساب ایجاد نمیکند.
- مواردی که به دلایلی گزارش انتساب قابل تولید یا ارسال نیست .
گزارشهای اشکالزدایی مفصل شامل یک فیلد type هستند که یا ثبت موفقیتآمیز منبع را شرح میدهد، یا دلیل عدم تولید گزارش منبع، تریگر یا انتساب را.
گزارشهای اشکالزدایی مفصل از کروم ۱۰۹ (ژانویه ۲۰۲۳) در دسترس بودهاند - به جز گزارشهای اشکالزدایی مفصل موفقیتآمیز ثبت منبع که بعداً در کروم ۱۱۲ اضافه شدهاند.
گزارشهای نمونه را در بخش 2 مرور کنید: تنظیم گزارشهای اشکالزدایی .
گزارشهای اشکالزدایی مبتنی بر کوکی هستند
برای استفاده از گزارشهای اشکالزدایی، مبدأ گزارشدهی باید یک کوکی تنظیم کند .
اگر مبدا پیکربندی شده برای دریافت گزارشها یک شخص ثالث باشد، این کوکی یک کوکی شخص ثالث خواهد بود. این بدان معناست که گزارشهای اشکالزدایی فقط در صورتی تولید میشوند که کوکیهای شخص ثالث در مرورگر کاربر مجاز باشند .
گزارشهای اشکالزدایی بلافاصله ارسال میشوند
گزارشهای اشکالزدایی بلافاصله توسط مرورگر به مبدا گزارش ارسال میشوند. این برخلاف گزارشهای انتساب است که با تأخیر ارسال میشوند.
گزارشهای اشکالزدایی موفقیتآمیز به محض تولید گزارش انتساب مربوطه تولید و ارسال میشوند: یعنی در زمان ثبت تریگر.
گزارشهای اشکالزدایی مفصل بلافاصله پس از ثبت منبع یا تریگر ارسال میشوند.
گزارشهای اشکالزدایی مسیرهای انتهایی متفاوتی دارند
مانند گزارشهای انتساب، تمام گزارشهای اشکالزدایی به مبدأ گزارشدهنده ارسال میشوند. گزارشهای اشکالزدایی به سه نقطه انتهایی جداگانه از مبدأ گزارشدهنده ارسال میشوند:
- نقطه پایانی برای گزارشهای اشکالزدایی موفقیتآمیز ، سطح رویداد
- گزارشهای اشکالزدایی موفقیتآمیز نقطه پایانی، قابل تجمیع
- نقطه پایانی برای گزارشهای اشکالزدایی مفصل ، در سطح رویداد و قابل تجمیع.
در بخش ۲ بیشتر بیاموزید: گزارشهای اشکالزدایی را تنظیم کنید .
موارد استفاده
بررسی اولیه ادغام در زمان واقعی
گزارشهای اشکالزدایی بلافاصله به نقطه پایانی شما ارسال میشوند، برخلاف گزارشهای انتساب که برای محافظت از حریم خصوصی کاربر با تأخیر ارسال میشوند. از گزارشهای اشکالزدایی به عنوان یک سیگنال بلادرنگ استفاده کنید که نشان میدهد ادغام شما با API گزارشدهی انتساب کار میکند.
یاد بگیرید که چگونه این کار را در بخش 3: اشکالزدایی کتاب آشپزی انجام دهید.
تحلیل ضرر
برخلاف کوکیهای شخص ثالث، API گزارشدهی نسبتدهی شامل محافظتهای حریم خصوصی داخلی است که برای ایجاد تعادل بین سودمندی و حریم خصوصی طراحی شدهاند. این بدان معناست که با API گزارشدهی نسبتدهی، ممکن است نتوانید تمام دادههای اندازهگیری را که میتوانید با کوکیها جمعآوری کنید، جمعآوری کنید. همه تبدیلهایی که میتوانید با کوکیهای شخص ثالث ردیابی کنید، گزارش نسبتدهی ایجاد نمیکنند.
یک مثال: برای گزارشهای سطح رویداد، میتوانید حداکثر یک تبدیل به ازای هر نمایش ثبت کنید. این بدان معناست که برای یک نمایش تبلیغ مشخص، صرف نظر از تعداد دفعات تبدیل کاربر، فقط یک گزارش انتساب دریافت خواهید کرد.
از گزارشهای اشکالزدایی برای مشاهده تفاوتهای بین نتایج اندازهگیری مبتنی بر کوکی و نتایجی که با API گزارشدهی انتساب به دست میآورید، استفاده کنید. دقیقاً مشخص کنید کدام تبدیلها گزارش شدهاند، چه تعداد تبدیل گزارش نشدهاند، و بهطور خاص کدامها و چرا.
یاد بگیرید که چگونه در بخش ۳: کتاب آشپزی اشکالزدایی، یک تحلیل ضرر اجرا کنید.
عیبیابی
اگرچه از دست دادن اطلاعات به دلیل حفظ حریم خصوصی یا حفاظت از منابع قابل پیشبینی است، اما از دست دادن اطلاعات دیگر ممکن است ناخواسته باشد. پیکربندیهای نادرست در پیادهسازی شما یا اشکالات موجود در خود مرورگر میتواند باعث از دست رفتن گزارشها شود.
شما میتوانید از گزارشهای اشکالزدایی برای شناسایی و رفع مشکل پیادهسازی در سمت خود یا گزارش یک اشکال احتمالی به تیمهای مرورگر استفاده کنید. نحوه انجام این کار را در بخش 3: کتاب آشپزی اشکالزدایی بیاموزید.
بررسی پیکربندی پیشرفته
برخی از ویژگیهای API گزارشدهی تخصیص به شما امکان میدهد رفتارهای API را سفارشی کنید. قوانین فیلترینگ، قوانین حذف دادههای تکراری و قوانین اولویتبندی، نمونههایی از این موارد هستند.
هنگام استفاده از این ویژگیها، از گزارشهای اشکالزدایی استفاده کنید تا بررسی کنید که منطق شما به رفتار مورد نظر در محیط تولید منجر میشود، بدون اینکه منتظر گزارشهای انتساب باشید. نحوه انجام این کار را در بخش 3: کتاب آشپزی اشکالزدایی بیاموزید.
آزمایش محلی با گزارشهای قابل جمعآوری
برخلاف گزارشهای انتساب قابل تجمیع که رمزگذاری شدهاند، گزارشهای اشکالزدایی قابل تجمیع شامل محتوای رمزگذاری نشده نیز میشوند.
از گزارشهای اشکالزدایی تجمیعی برای اعتبارسنجی محتوای گزارشهای تجمیعی و تولید گزارشهای خلاصه با ابزار تجمیع محلی برای آزمایش استفاده کنید.
گزارشهای سرویس تجمیع پردازش مجدد
یکی دیگر از مزایای استفاده از حالت اشکالزدایی این است که به شما امکان میدهد گزارشها را دوباره پردازش کنید. بنابراین، برای پردازش گزارشها بیش از یک بار، مطمئن شوید که گزارشهای اشکالزدایی فعال هستند. ممکن است بخواهید گزارشها را در موارد زیر دوباره پردازش کنید:
- تلاش برای اشکالزدایی سرویس تجمیع.
- آزمایش با استراتژیهای مختلف دستهبندی.
- آزمایش با مقادیر مختلف اپسیلون.
بازیابی اطلاعات
ما به تکنسینهای تبلیغات توصیه میکنیم حالت اشکالزدایی (debug mode) را برای دریافت گزارشهای اشکالزدایی فعال کنند تا بتوانند دادههای گزارش خود را بازیابی کنند. این قابلیت در مواردی که مشکلات سرویس تجمیع (Aggregation Service) مانند سرویسهای در دسترس نبودن یا عدم پاسخگویی وجود دارد و ممکن است باعث عدم موفقیت در تولید گزارش خلاصه شود، مفید است.
بعدی
بخش دوم: تنظیم گزارشهای اشکالزدایی