گزارش های بزرگ را اجرا کنید
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
حداکثر طول گزارش‌ها 100000 ردیف در AdSense Management API، به طور پیش‌فرض است. اگر نزدیک به این محدودیت‌ها هستید یا در حین پردازش داده‌ها با مشکلات عملکردی مواجه می‌شوید، در اینجا چند نکته وجود دارد که ممکن است کمک کند.
کاهش مقیاس گزارش شما
اولین چیزی که هنگام تلاش برای کوچکتر کردن گزارش باید به دنبال آن باشید، فهرست ابعادی است که استفاده می کنید. هر بُعدی که اضافه می‌کنید اثر ضربی بر تعداد ردیف‌های برگشتی دارد. مطمئن شوید که فقط ابعاد مورد نیاز خود را اضافه کرده اید!
تقسیم گزارشات شما
گاهی اوقات، شما فقط برای بخشی از گزارش به داده های بسیار دقیق نیاز دارید، در حالی که بقیه جزئیات کمتری را در اختیار شما قرار می دهند. برای مثال، می‌توانید به جزئیات بسیار دقیقی برای درآمد ماه قبل نیاز داشته باشید، با آمار هر کشور و کانال در هر روز، اما زمانی که قبل از آن نگاه می‌کنید، واقعاً به داده‌های سطح کشور نیاز دارید. بنابراین می توانید یک گزارش پیچیده برای ماه قبل اجرا کنید، اما یک گزارش ساده تر برای زمان قبل از آن.
با جابجایی به CSV از تجزیه JSON اجتناب کنید
AdSense Management API به شما امکان می دهد گزارش های خود را به جای JSON معمولی، در قالب CSV دریافت کنید.
برای انجام این کار، به سادگی متد generalCsv جایگزین را فراخوانی کنید.
مثال
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 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\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)"]]
