يمكنك استخدام Data API للوصول آليًا إلى بيانات تقارير "إحصاءات Google" (Google Analytics). لا يتوافق واجهة برمجة التطبيقات هذه مع مواقع Universal Analytics القديمة.
مزيد من المعلومات عن مواقع "إحصاءات Google"
في ما يلي بعض الأمثلة التي يمكنك إعداد تقارير عنها باستخدام الإصدار 1 من Google Analytics Data API:
- عدد المستخدمين النشطين يوميًا في تطبيق Android خلال الأسبوع الماضي
- عدد مشاهدات الصفحة على الويب التي حصدتها أهم 10 صفحات على موقعك الإلكتروني في آخر 28 يومًا
- عدد المستخدمين النشطين في تطبيق iOS لكل بلد خلال آخر 30 دقيقة
يمكنك أيضًا استخدام الإصدار 1 من Google Analytics Data API لإجراء ما يلي:
- إنشاء لوحات بيانات مخصّصة لعرض بيانات "إحصاءات Google"
- أتمتة مهام إعداد التقارير المعقّدة لتوفير الوقت
- دمج بيانات "إحصاءات Google" مع تطبيقات أخرى خاصة بالأنشطة التجارية
البدء
للبدء، يُرجى الاطّلاع على دليل البدء السريع الخاص بمكتبة البرامج. تتوفّر مكتبات برامج بلغات Java وPython وNode.js وغيرها لتسهيل عملية التنفيذ.
الطُرق المتاحة
في ما يلي قائمة بطُرق Data API. لمزيد من التفاصيل، يُرجى الاطّلاع على المستندات المرجعية.
runReportتعرض هذه الطريقة تقريرًا مخصّصًا لبيانات الأحداث في "إحصاءات Google"، وهي الطريقة المفضّلة لإجراء طلبات بحث بسيطة عن التقارير.batchRunReportsهذا الإصدار هو إصدار مجمّع من طريقة runReport التي تتيح لك إنشاء تقارير متعدّدة باستخدام طلب واحد من واجهة برمجة التطبيقات.runPivotReportتعرض هذه الطريقة تقريرًا محوريًا مخصّصًا لبيانات الأحداث في "إحصاءات Google". تُعدّ تقارير Pivot تنسيقات أكثر تقدّمًا وتعبيراً من التقارير العادية. يصف كل جدول محوري أعمدة وصفوف السمات المرئية في رد التقرير.batchRunPivotReportsهذا إصدار مجمّع من طريقة runPivotReport يتيح لك إنشاء تقارير متعددة باستخدام طلب واحد من واجهة برمجة التطبيقات.getMetadataتعرض هذه الطريقة بيانات وصفية للسمات والمقاييس المتاحة في طرق إعداد التقارير. تُستخدَم لاستكشاف السمات والمقاييس. يتضمّن ردّ هذه الطريقة أيضًا السمات والمقاييس المخصّصة المتاحة لموقع "إحصاءات Google" المحدّد.checkCompatibilityتعرض هذه الطريقة السمات والمقاييس التي يمكن إضافتها إلى طلب تقرير والحفاظ على التوافق.runRealtimeReportتعرض هذه الطريقة تقريرًا مخصّصًا لبيانات الأحداث في الوقت الفعلي لموقعك. تظهر الأحداث في تقارير الوقت الفعلي بعد ثوانٍ من إرسالها إلى "إحصاءات Google". تعرِض تقارير "الوقت الفعلي" بيانات الأحداث والاستخدام للفترات الزمنية التي تتراوح من اللحظة الحالية إلى 30 دقيقة مضت (ما يصل إلى 60 دقيقة لمواقع "إحصاءات Google 360").properties.audienceExportsمجموعة من الطرق التي تتيح لك إنشاء عمليات تصدير لشرائح الجمهور، والتي تتضمّن لقطة للمستخدمين في إحدى شرائح الجمهور.properties.recurringAudienceLists(معاينة مبكرة) مجموعة من الطرق التي تتيح لك إدارة عمليات تصدير شرائح الجمهور المتكرّرة. تؤدي عملية تصدير شرائح الجمهور المتكرّرة إلى إنشاء قوائم مستخدمين جديدة كل يوم.runFunnelReport(معاينة مبكرة) تعرض هذه الطريقة تقرير مسار إحالة ناجحة مخصّصًا لبيانات الأحداث في "إحصاءات Google". تتيح لك استكشاف خطوات المستخدِمين إمكانية الاطّلاع على تمثيل بصري للخطوات التي يتّخذها المستخدِمون لإكمال مهمة وبالتالي التعرُّف بشكل سريع على مدى نجاحهم أو فشلهم في كل خطوة.
السمات والمقاييس المتاحة
للاطّلاع على قائمة بجميع السمات والمقاييس التي تتيحها Data API، راجِع مستندات مخطط API.