گزارش نویسی
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
ondemand_video ویدیو: بحث گزارش کارگاه 2019 را بررسی کنید
گزارش داده های عملکرد بخشی جدایی ناپذیر از برنامه های Google Ads API است. با گزینه های گزارش دهی انعطاف پذیر برای این API، می توانید داده های عملکرد را برای همه منابع به دست آورید. این شامل همه چیز از یک کمپین کامل گرفته تا مجموعه ای از کلمات کلیدی است که تبلیغات شما را راه اندازی کرده است.
این راهنما مراحل لازم برای ایجاد و ارسال درخواست به Google Ads API را برای بازیابی داده ها شرح می دهد. برای اطلاعات دقیق تر درباره گزارش، اسناد مرجع گزارش ها منابعی را که می توان در Google Ads API با استفاده از GoogleAdsService.SearchStream یا GoogleAdsService.Search پرس و جو کرد، توصیف می کند.
به بخشی از این راهنما بروید که به بهترین وجه مناسب مورد استفاده شما است:
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-26 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-26 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThe Google Ads API offers flexible reporting options to retrieve performance data for all resources, from campaigns to keywords.\u003c/p\u003e\n"],["\u003cp\u003eThis guide provides steps to create and submit queries for data retrieval, covering various aspects like segmentation, zero metrics handling, and streaming.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can leverage the Google Ads Query Language to define their queries and manage data efficiently using the API.\u003c/p\u003e\n"],["\u003cp\u003eResources are available to learn by example, understand criteria performance metrics, use labels for reporting, and map UI reports to API usage.\u003c/p\u003e\n"]]],[],null,["# Reporting\n\nondemand_video\n[Video: Check out the reporting talk from the 2019 workshop](https://www.youtube.com/watch?v=2GWx6jI7Ib4&list=None&start=795)\n\nReporting of performance data is an integral part of Google Ads API applications. With\nthe flexible reporting options for this API, you can obtain performance data for\nall [resources](/google-ads/api/reference/rpc/v21/overview#resources). This includes everything from\nan entire campaign to a set of keywords that triggered your ad.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nThis guide describes the steps necessary to create and submit a query to the\nGoogle Ads API to get back data. For more detailed information about reporting, the\n[Reports reference documentation](/google-ads/api/fields/v21/overview) describes the\nresources that can be queried in the Google Ads API using\n`GoogleAdsService.SearchStream` or `GoogleAdsService.Search`.\n\nJump to the section of this guide that best fits your use case:\n\n- [Try a quick example](/google-ads/api/docs/reporting/example)\n- [Retrieve criteria performance metrics](/google-ads/api/docs/reporting/criteria-metrics)\n- [Learn about segmentation](/google-ads/api/docs/reporting/segmentation)\n- [Find out how to handle zero metrics](/google-ads/api/docs/reporting/zero-metrics)\n- [Learn about using labels to report on your data](/google-ads/api/docs/reporting/labels)\n- [Learn about streaming your reporting data](/google-ads/api/docs/reporting/streaming)\n- [Learn about paging your data](/google-ads/api/docs/reporting/paging)\n- [Learn about mapping UI reports to API usage](/google-ads/api/docs/reporting/uireports)\n- [Learn the syntax of the Google Ads Query Language](/google-ads/api/docs/query/overview)\n- [Learn about managing data efficiently](/google-ads/api/docs/productionize/manage-data-efficiently)"]]
