تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يمكنك استخدام Data API للقيام بالوصول آليًا إلى بيانات تقارير "إحصاءات Google". واجهة برمجة التطبيقات هذه
غير متوافقة مع مواقع Universal Analytics القديمة.
في ما يلي بعض الأمثلة التي يمكنك إعداد تقارير عنها باستخدام الإصدار 1 من Google Analytics Data API:
عدد المستخدمين النشطين يوميًا الذين جذبهم تطبيق Android في الأسبوع الماضي
عدد مشاهدات الصفحات التي حصدتها أهم 10 صفحات على موقعك الإلكتروني في آخر 28 يومًا
عدد المستخدمين النشطين لكل بلد حصل عليه تطبيقك المتوافق مع نظام التشغيل iOS في آخر 30 دقيقة
يمكنك أيضًا استخدام الإصدار 1 من Google Analytics Data API لتنفيذ ما يلي:
إنشاء لوحات بيانات مخصّصة لعرض بيانات "إحصاءات Google"
يمكنك برمجة المهام المعقّدة لإعداد التقارير لتوفير الوقت.
دمج بيانات "إحصاءات Google" مع تطبيقات النشاط التجاري الأخرى
البدء
للبدء، اطّلِع على مكتبة العميل
quickstart. تتوفّر مكتبات عملاء بلغات Java و
Python وNode.js ولغات أخرى لتبسيط عملية التنفيذ.
الطرق المتاحة
في ما يلي قائمة بأساليب Data API. لمزيد من التفاصيل، يُرجى الاطّلاع على مستندات
المرجع.
runReport تعرِض هذه الطريقة
تقريرًا مخصّصًا لبيانات الأحداث في "إحصاءات Google"، وهي الطريقة المفضّلة
لطلبات البحث البسيطة عن التقارير.
batchRunReports هذه هي برمجة برمجية لإصدار ملف شخصي من طريقة runReport تتيح لك إنشاء عدة تقارير باستخدام طلب واحد لواجهة برمجة التطبيقات.
runPivotReport تعرِض هذه الطريقة
تقريرًا محوريًا مخصّصًا لبيانات
الأحداث في "إحصاءات Google". التقارير المحورية هي تنسيقات أكثر تقدّمًا وتعبيرية من التقارير العادية. يصف كلّ محور أعمدة السمات المرئية وصفوفها في
استجابة التقرير.
batchRunPivotReports
هذه هي النسخة المجمّعة من طريقة runPivotReport التي تتيح لك إنشاء
تقارير متعدّدة باستخدام طلب بيانات واحد من واجهة برمجة التطبيقات.
getMetadata تعرض هذه الطريقة
البيانات الوصفية للسمات والمقاييس المتاحة في طرق إعداد التقارير. تُستخدَم لمحاولة
استكشاف السمات والمقاييس. يتضمّن ردّ هذه الطريقة أيضًا
السمات والمقاييس المخصّصة المتاحة لموقع "إحصاءات Google"
المحدّد.
checkCompatibility تعرض هذه المحاولة
السمات والمقاييس التي يمكن إضافتها إلى طلب تقرير
والحفاظ على التوافق.
runRealtimeReport تعرِض هذه المحاولة
تقريرًا مخصّصًا لبيانات الأحداث في الوقت الفعلي
لموقعك. تظهر الأحداث في تقارير "الوقت الفعلي" بعد ثوانٍ من
إرسالها إلى "إحصاءات Google". تعرِض تقارير "الوقت الفعلي" بيانات الأحداث واستخدام الموقع الإلكتروني للفترة الزمنية التي تتراوح بين الوقت الحالي و30
دقيقة (ما يصل إلى 60 دقيقة لمواقع "إحصاءات Google 360").
properties.recurringAudienceLists(ميزة متوفّرة في مرحلة معاينة) مجموعة من الطرق التي تتيح لك إدارة عمليات تصدير ملفّات الجمهور المتكرّرة. تؤدي عملية تصدير الجمهور المتكرّرة إلى إنشاء قوائم جمهور جديدة
كل يوم.
runFunnelReport(إصدار تجريبي مبكر) تعرِض هذه الطريقة تقرير مسار إحالة ناجحة مخصّصًا لبيانات الأحداث في "إحصاءات Google". يتيح لك استكشاف خطوات المستخدِمين
الاطّلاع على تمثيل بصري للخطوات التي يتّخذها المستخدِمون لإكمال مهمة وبالتالي معرفة
مدى نجاحهم أو فشلهم في كلّ خطوة.
تاريخ التعديل الأخير: 2025-03-10 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-03-10 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe Google Analytics Data API (v1) allows programmatic access to Google Analytics report data, excluding Universal Analytics properties.\u003c/p\u003e\n"],["\u003cp\u003eThis API offers methods for retrieving various report types, including standard, pivot, realtime, and funnel reports, and enables tasks like building custom dashboards and automating reporting.\u003c/p\u003e\n"],["\u003cp\u003eUsers can leverage client libraries in Java, Python, Node.js, and other languages for streamlined implementation.\u003c/p\u003e\n"],["\u003cp\u003eThe API is currently in Alpha and Beta stages with potential for breaking changes, particularly in Alpha features.\u003c/p\u003e\n"],["\u003cp\u003eComprehensive documentation, including API schema, quickstart guides, and reference materials, are available to aid developers in utilizing the API effectively.\u003c/p\u003e\n"]]],["The Google Analytics Data API allows programmatic access to report data, excluding legacy Universal Analytics properties. It offers Alpha and Beta channels with varying stability. Key actions include generating reports (simple, pivot, funnel, real-time), batching reports, retrieving metadata, and checking compatibility. The API can build dashboards, automate reporting, and integrate data with other apps. Client libraries simplify implementation. Methods include `runReport`, `runPivotReport`, `runFunnelReport`, and managing audience exports, among others.\n"],null,["# Google Analytics Data API Overview\n\nYou can use the [Data API](/analytics/devguides/reporting/data/v1/rest) to\nprogrammatically access Google Analytics (Google Analytics) report data. This\nAPI isn't compatible with legacy Universal Analytics properties.\n\n[Learn more about Google Analytics\nproperties](//support.google.com/analytics/answer/9325020).\n| This API provides features in Alpha and Beta channels. Alpha and Beta products may have limited support, and changes to these products may not be compatible with other Alpha and Beta versions.\n|\n| **Alpha**:\n| Features are in an early preview stage. While we try to notify you of\n| upcoming changes, expect to encounter breaking changes before the API is publicly released.\n|\n| **Beta**:\n| No breaking changes are expected in this channel.\n|\n| For official Google Analytics API announcements, subscribe to the\n| [Google Analytics API Notify Group](https://groups.google.com/forum/#!forum/google-analytics-api-notify).\n\nHere are some examples you might report on using the Google Analytics Data API v1:\n\n- How many daily active users has your Android app had in the last week.\n- How many page views the top 10 pages on your site had in the last 28 days.\n- How many active users per country your iOS app had in the last 30 minutes.\n\nYou can also use the Google Analytics Data API v1 to do the following:\n\n- Build custom dashboards to display Google Analytics data.\n- Automate complex reporting tasks to save time.\n- Integrate your Google Analytics data with other business applications.\n\nGet started\n-----------\n\nTo get started, see the [client library\nquickstart](/analytics/devguides/reporting/data/v1/quickstart-client-libraries). There are client libraries in Java,\nPython, Node.js, and other languages to simplify your implementation.\n\nAvailable methods\n-----------------\n\nHere's a list of the Data API methods. For more details, see the [reference\ndocumentation](/analytics/devguides/reporting/data/v1/rest).\n\n- [`runReport`](/analytics/devguides/reporting/data/v1/rest/v1beta/properties/runReport) This method returns a customized report of your Google Analytics event data and is the preferred method for [simple report queries](/analytics/devguides/reporting/data/v1/basics).\n- [`batchRunReports`](/analytics/devguides/reporting/data/v1/rest/v1beta/properties/batchRunReports) This is a batch version of the runReport method which lets you generate multiple reports using a single API call.\n- [`runPivotReport`](/analytics/devguides/reporting/data/v1/rest/v1beta/properties/runPivotReport) This method returns a customized [pivot report](/analytics/devguides/reporting/data/v1/pivots) of you Google Analytics event data. Pivot reports are more advanced and expressive formats than regular reports. Each pivot describes the visible dimension columns and rows in the report response.\n- [`batchRunPivotReports`](/analytics/devguides/reporting/data/v1/rest/v1beta/properties/batchRunPivotReports) This is a batch version of the runPivotReport method which lets you generate multiple reports using a single API call.\n- [`getMetadata`](/analytics/devguides/reporting/data/v1/rest/v1beta/properties/getMetadata) This method returns metadata for dimensions and metrics available in reporting methods. Used to explore the dimensions and metrics. The response of this method also includes the Custom dimensions and metrics available for the specified Google Analytics property.\n- [`checkCompatibility`](/analytics/devguides/reporting/data/v1/rest/v1beta/properties/checkCompatibility) This method lists dimensions and metrics that can be added to a report request and maintain compatibility.\n- [`runRealtimeReport`](/analytics/devguides/reporting/data/v1/rest/v1beta/properties/runRealtimeReport) This method returns a customized [report of realtime event data](/analytics/devguides/reporting/data/v1/realtime-basics) for your property. Events appear in realtime reports seconds after they have been sent to the Google Analytics. Realtime reports show events and usage data for the periods of time ranging from the present moment to 30 minutes ago (up to 60 minutes for Google Analytics 360 properties).\n- [`properties.audienceExports`](/analytics/devguides/reporting/data/v1/rest/v1beta/properties.audienceExports) A group of methods that let you [generate Audience\n Exports](/analytics/devguides/reporting/data/v1/audience-export-basics), which include a snapshot of the users in an audience.\n- [`properties.recurringAudienceLists`](/analytics/devguides/reporting/data/v1/rest/v1alpha/properties.recurringAudienceLists) **(Early preview)** A group of methods that let you manage recurring Audience Exports. A recurring audience export produces new audience lists each day.\n- [`runFunnelReport`](/analytics/devguides/reporting/data/v1/rest/v1alpha/properties/runFunnelReport) **(Early preview)** This method returns a customized [funnel\n report](/analytics/devguides/reporting/data/v1/funnels) of your Google Analytics event data. Funnel exploration lets you visualize the steps your users take to complete a task and quickly see how well they are succeeding or failing at each step.\n\nSupported dimensions and metrics\n--------------------------------\n\nFor a list of all the dimensions and metrics supported by the Data API, see the\n[API schema documentation](/analytics/devguides/reporting/data/v1/api-schema)."]]
