إعداد التقارير
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
ondemand_video
فيديو: مراجعة عرض التقرير من ورشة العمل لعام 2019
يُعدّ إعداد تقارير بيانات الأداء جزءًا لا يتجزأ من تطبيقات Google Ads API. من خلال خيارات إعداد التقارير المرنة لهذه الواجهة، يمكنك الحصول على بيانات الأداء لجميع المراجع. ويشمل ذلك كل شيء، بدءًا من حملة كاملة إلى مجموعة من الكلمات الرئيسية التي أدّت إلى ظهور إعلانك.
يوضّح هذا الدليل الخطوات اللازمة لإنشاء طلب بحث وإرساله إلى Google Ads API من أجل استرداد البيانات. للحصول على معلومات أكثر تفصيلاً حول إعداد التقارير، يقدّم المستند المرجعي الخاص بالتقارير وصفًا للموارد التي يمكن طلبها في Google Ads API باستخدام GoogleAdsService.SearchStream أو GoogleAdsService.Search.
انتقِل إلى قسم هذا الدليل الذي يناسب حالة الاستخدام الخاصة بك:
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-27 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-27 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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)"]]
