گزارش منطقه زمانی محلی
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
گزارش منطقه زمانی محلی به شما امکان می دهد گزارش ها را در منطقه زمانی محلی حساب AdSense اجرا کنید. از نسخه 2 API مدیریت AdSense، این عملکرد به طور پیش فرض فعال است.
تنظیم کردن چیزها
در بیشتر موارد، تنها چیزی که برای استفاده از گزارش منطقه زمانی محلی لازم است این است که کاربر AdSense منطقه زمانی محلی حساب خود را پیکربندی کند. این به آنها امکان می دهد منطقه زمانی را انتخاب کنند که بیشتر به آنها مربوط است و از آن در وب سایت AdSense و گزارش های API مدیریت AdSense استفاده کنند.
درخواست گزارش
وب سایت AdSense و AdSense Management API به طور پیش فرض از منطقه زمانی محلی حساب برای تولید گزارش استفاده می کنند. برای API مدیریت AdSense، این انتخاب از طریق یک پارامتر reportingTimeZone (به ReportingTimeZone مراجعه کنید) برای هر دو درخواست تولید گزارش موقت و ذخیره شده کنترل می شود.
برای غیرفعال کردن گزارش منطقه زمانی محلی، پارامتر reportingTimeZone باید روی GOOGLE_TIME_ZONE تنظیم شود. این گزارش با استفاده از منطقه زمانی صورت‌حساب (همیشه آمریکا/لس_آنجلس) تولید می‌کند.
توجه داشته باشید که اگر کاربر هرگز منطقه زمانی محلی را برای حساب تنظیم نکرده باشد، منطقه زمانی حساب او مانند منطقه زمانی صورت‌حساب آمریکا/Los_Angeles در نظر گرفته می‌شود.
چیزهایی که باید مراقب آنها بود
تغییر مناطق زمانی
هر زمان که منطقه زمانی یک حساب تغییر کند، یک دوره انتقال کوتاه تا دو روز وجود خواهد داشت که در آن داده های گزارش به طور بالقوه ناسازگار خواهند بود. این داده‌ها همیشه ناسازگار باقی می‌مانند، بنابراین در صورت امکان مراقب باشید که این نقاط انتقال را در برنامه خود یادداشت کنید.
یکی از مثال‌های مرتبط از این انتقال‌ها زمانی است که منطقه زمانی محلی برای یک حساب برای اولین بار تنظیم می‌شود: این در اصل تغییری از منطقه زمانی پیش‌فرض حساب به منطقه زمانی انتخابی خواهد بود.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eAdSense reports are now generated in the user's local time zone by default, offering a more relevant view of data.\u003c/p\u003e\n"],["\u003cp\u003eUsers can configure their preferred time zone within their AdSense account settings for use across the website and API.\u003c/p\u003e\n"],["\u003cp\u003eReports can be generated using the billing time zone (America/Los_Angeles) by explicitly setting the \u003ccode\u003ereportingTimeZone\u003c/code\u003e parameter to \u003ccode\u003eGOOGLE_TIME_ZONE\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eChanging the account's time zone may result in inconsistent reporting data for a brief period, which should be taken into consideration.\u003c/p\u003e\n"]]],["AdSense's local time zone reporting, enabled by default in API v2, allows reports to use the user's chosen time zone. Users must configure their account's local time zone. The `reportingTimeZone` parameter manages this in the API; setting it to `GOOGLE_TIME_ZONE` uses the billing time zone (America/Los_Angeles). If no user timezone is set the billing time zone is used. Time zone changes may cause up to two days of inconsistent reporting data.\n"],null,["# Local Time Zone Reporting\n\nLocal time zone reporting allows you to run reports in the AdSense account's local time zone. As of v2 of the AdSense Management API, this functionality is enabled by default.\n\nSetting things up\n-----------------\n\nIn most cases, all that is required to use local time zone reporting is for the AdSense user to [configure their account's local time zone](https://support.google.com/adsense/answer/9830725). This allows them to choose a time zone that is more relevant to them, and use it across the AdSense website and AdSense Management API reports.\n\nRequesting a report\n-------------------\n\nThe AdSense website and AdSense Management API will use the account's local time zone by default to generate reports. For the AdSense Management API, this choice is controlled via a `reportingTimeZone` parameter (see [`ReportingTimeZone`](/adsense/management/reference/rest/v2/ReportingTimeZone)) for both [ad hoc](/adsense/management/reference/rest/v2/accounts.reports) and [saved report](/adsense/management/reference/rest/v2/accounts.reports.saved) generation requests.\n\nTo disable local time zone reporting, the `reportingTimeZone` parameter should be set to `GOOGLE_TIME_ZONE`; this generates reports using the billing time zone (always America/Los_Angeles).\n\nNote that if the user has never [set the local time zone for the account](https://support.google.com/adsense/answer/9830725), their account time zone will be considered to be America/Los_Angeles, the same as the billing time zone.\n\nThings to watch out for\n-----------------------\n\n### Changing time zones\n\nWhenever the time zone for an account is changed, there will be a short transition period of up to two days where the reporting data will potentially be inconsistent. This data will always remain inconsistent, so be careful to note these transition points in your application, if possible.\n\nOne particularly relevant example of these transitions is when the local time zone for an account is first set: this will essentially be a switch from the default account time zone to the chosen time zone."]]
