تنفيذ التقارير الكبيرة
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يبلغ الحد الأقصى لطول التقارير 100,000 صف في واجهة برمجة تطبيقات AdSense Management بشكل تلقائي. إذا كنت
أوشكت على الاقتراب من هذه الحدود، أو واجهت مشاكل في الأداء أثناء معالجة البيانات، هنا
بعض النصائح التي قد تساعدك.
تقليل حجم تقريرك
أول شيء يجب البحث عنه عند محاولة تصغير التقرير هو قائمة الأبعاد التي
استخدام لكل بُعد تضيفه تأثير ضربي في عدد الصفوف المعروضة. يُرجى التأكد من أنّ:
ما عليك سوى إضافة الأبعاد التي تحتاجها فقط!
تقسيم تقاريرك
في بعض الأحيان، تحتاج فقط إلى بيانات دقيقة للغاية لجزء من التقرير، مع باقي
مما يسمح بتفاصيل أقل. على سبيل المثال، قد تحتاج إلى تفاصيل دقيقة للغاية عن العنصر السابق
مع إحصاءات لكل بلد وقناة يوميًا، ولكنها تحتاج فقط إلى
على مستوى البلد عند البحث عنها قبل ذلك. لذلك، يمكنك تشغيل تقرير معقد
الشهر السابق، بل لخطة أبسط للفترة التي تسبق ذلك.
تجنُّب تحليل JSON من خلال التبديل إلى ملف CSV
تتيح لك AdSense Management API تلقّي التقارير بتنسيق CSV بدلاً من تنسيق JSON المعتاد.
ولإجراء ذلك، ما عليك سوى استدعاء الطريقة البديلة generateCsv.
مثال
DATE,CLICKS
2014-01-01,2
2014-01-02,1
2014-01-03,4
2014-01-04,1
2014-01-05,1
الخطوات التالية
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eAdSense Management API reports have a default maximum length of 100,000 rows, and exceeding this limit may cause performance issues.\u003c/p\u003e\n"],["\u003cp\u003eMinimizing the number of dimensions used in a report can significantly reduce its size and improve performance.\u003c/p\u003e\n"],["\u003cp\u003eFor reports requiring varying levels of granularity, consider splitting them into multiple reports with different dimension sets to optimize data retrieval.\u003c/p\u003e\n"],["\u003cp\u003eSwitching from JSON to CSV format for report retrieval can avoid JSON parsing overhead and improve efficiency.\u003c/p\u003e\n"]]],["To manage large AdSense reports, reduce the scale by minimizing the number of dimensions used, as each dimension increases rows. Split reports into detailed and less detailed sections based on data accuracy needs. For improved performance, switch from JSON to CSV format by using the `generateCsv` method. Consider batching and optimizing dimension usage for further improvements.\n"],null,["# Run Large Reports\n\nReports have a maximum length of 100,000 rows in the AdSense Management API, by default. If you're\nrunning close to these limits, or running into performance issues while processing the data, here\nare some tips that may help.\n\nReducing the scale of your report\n---------------------------------\n\nThe first thing to look for when trying to make a report smaller is the list of dimensions you're\nusing; each dimension you add has a multiplicative effect on the number of returned rows. Make sure\nyou only add the dimensions you need!\n\nSplitting your reports\n----------------------\n\nSometimes, you only need extremely accurate data for a portion of the report, with the rest\nallowing for less detail. For example, you could need extremely accurate details for the previous\nmonth's earnings, with stats per country and channel across every day, but only really need the\ncountry-level data when looking before that. You could therefore run a complex report for the\nprevious month, but a simpler one for the time before that.\n\nAvoid JSON parsing by switching to CSV\n--------------------------------------\n\nThe AdSense Management API allows you to receive your reports in CSV format, rather than the usual JSON.\n\nTo do that, simply call the alternate [generateCsv](/adsense/management/reference/rest/v2/accounts.reports/generateCsv) method.\n\n#### Example\n\n```\nDATE,CLICKS\n2014-01-01,2\n2014-01-02,1\n2014-01-03,4\n2014-01-04,1\n2014-01-05,1\n```\n\nNext steps\n----------\n\n- [Batching](/adsense/management/reporting/batching)\n- [Using Multiple Dimensions Wisely](/adsense/management/reporting/dimensions_metrics#usingmultiple)"]]
