درخواست‌ها، پاسخ‌ها و پیام‌های خلاصه ارسال شده به API گوگل ادز را می‌توان با ثبت‌کننده‌ی سفارشی خودتان یا ثبت‌کننده‌ی پیش‌فرض در کتابخانه‌ی کلاینت برای پرل ثبت کرد.
سطوح لاگ
این کتابخانه انواع مختلف رویدادها را در سطوح مختلف گزارش ثبت می‌کند. در یک پاسخ موفق API، خلاصه در INFO و درخواست و پاسخ کامل در DEBUG ثبت می‌شوند. در درخواستی که منجر به خطای API می‌شود، پیام خلاصه در WARN و درخواست و پاسخ کامل در INFO ثبت می‌شوند.
| نوع گزارش | نام لاگ | سطح موفقیت | سطح شکست |
|---|---|---|---|
| خلاصه | خلاصه. تبلیغات گوگل. تبلیغات گوگل | اطلاعات | هشدار |
| جزئیات | جزئیات تبلیغات گوگل | اشکال‌زدایی | اطلاعات |
برای خرابی‌های جزئی، جزئیات خرابی جزئی در ثبت‌کننده‌ی DETAIL در DEBUG ثبت می‌شود.
پیکربندی
کتابخانه کلاینت از یک کلاس سفارشی برای تمام اهداف ثبت وقایع استفاده می‌کند و از طریق ماژول GoogleAdsLogger در دسترس است. این کلاس یک پیکربندی پیش‌فرض ارائه می‌دهد که در آن، هم ثبت‌کننده‌های خلاصه و هم ثبت‌کننده‌های جزئیات، در فایل‌هایی در پوشه logs در زیر دایرکتوری HOME شما می‌نویسند.
پیکربندی Log4perl را سفارشی کنید
شما می‌توانید با ارائه یک فایل log4perl.conf سفارشی در دایرکتوری HOME خود، یا با مقداردهی اولیه Log::Log4perl مستقیماً در برنامه خود قبل از برقراری تماس‌های API، پیکربندی پیش‌فرض را لغو کنید.
فعال یا غیرفعال کردن لاگ‌ها
ثبت وقایع می‌تواند با استفاده از روش‌های کمکی زیر به صورت برنامه‌نویسی فعال یا غیرفعال شود:
فعال کردن گزارش‌گیری برای هر دو ثبت‌کننده‌ی لاگ (logger) (برای تنظیم سطح
DEBUGعدد1را وارد کنید تا تمام داده‌های درخواست و پاسخ برای فراخوانی‌های موفق ثبت شوند):use Google::Ads::GoogleAds::Logging::GoogleAdsLogger; Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_all_logging(1);غیرفعال کردن تمام گزارش‌گیری‌ها:
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_all_logging();غیرفعال کردن ثبت خلاصه اطلاعات:
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_summary_logging();غیرفعال کردن ثبت جزئیات:
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_detail_logging();
شما می‌توانید برای کنترل بیشتر بر نحوه ثبت درخواست‌ها، مستقیماً از متدهای کلاس GoogleAdsLogger استفاده کنید.