الإبلاغ عن المنطقة الزمنية المحلية
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تسمح لك ميزة إعداد تقارير المنطقة الزمنية المحلية بعرض التقارير باستخدام المنطقة الزمنية المحلية لحساب AdSense. بدءًا من الإصدار الثاني من AdSense Management API، يتم تفعيل هذه الوظيفة تلقائيًا.
ضبط الإعدادات
في معظم الحالات، كل ما يلزم لاستخدام إعداد تقارير المنطقة الزمنية المحلية هو أن يتولى مستخدم AdSense ضبط المنطقة الزمنية المحلية لحسابه. وهذا يتيح لهم اختيار منطقة زمنية أكثر ملاءمة لهم، واستخدامها في موقع AdSense الإلكتروني وتقارير واجهة برمجة تطبيقات AdSense Management.
طلب تقرير
وسيستخدم موقع AdSense الإلكتروني وAdSense Management API المنطقة الزمنية المحلية للحساب تلقائيًا لإنشاء التقارير. بالنسبة إلى واجهة برمجة تطبيقات AdSense Management، يتم التحكّم في هذا الخيار من خلال مَعلمة reportingTimeZone (راجِع ReportingTimeZone) لكل من طلبات إنشاء المخصّصة والتقارير المحفوظة.
لإيقاف إعداد تقارير المنطقة الزمنية المحلية، يجب ضبط المعلَمة reportingTimeZone على GOOGLE_TIME_ZONE، يؤدي ذلك إلى إنشاء تقارير باستخدام المنطقة الزمنية للفوترة (أمريكا/لوس أنجلوس دائمًا).
تجدر الإشارة إلى أنّه إذا لم يكُن المستخدم قد ضبط المنطقة الزمنية المحلية للحساب من قبل، سيتمّ اعتبار المنطقة الزمنية لحسابه هي America/Los_Angeles، وهي نفسها المنطقة الزمنية للفوترة.
أمور يجب الانتباه إليها
تغيير المناطق الزمنية
وفي حال تغيير المنطقة الزمنية لأحد الحسابات، ستكون هناك فترة انتقالية قصيرة تصل إلى يومَين من المحتمل أن تكون بيانات إعداد التقارير فيها غير متسقة. وستظل هذه البيانات غير متسقة دائمًا، لذلك عليك ملاحظة نقاط الانتقال هذه في تطبيقك، إن أمكن.
من الأمثلة ذات الصلة على عمليات النقل هذه عندما يتمّ تحديد المنطقة الزمنية المحلية للحساب لأوّل مرّة: ستكون هذه العملية في الأساس التبديل من المنطقة الزمنية التلقائية للحساب إلى المنطقة الزمنية المختارة.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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."]]
