تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

نظرة عامة على Google Analytics Data API

يمكنك استخدام Data API من أجل الوصول إلى بيانات تقرير "إحصاءات Google" (Google Analytics) آليًا. هذا النمط لا تتوافق واجهة برمجة التطبيقات مع مواقع Universal Analytics القديمة.

مزيد من المعلومات عن "إحصاءات Google" .

توفّر واجهة برمجة التطبيقات هذه ميزات في قنوات الإصدار الأولي والإصدار التجريبي. قد يكون هناك دعم محدود لمنتجات الإصدار الأولي والتجريبي، وقد لا تتوافق التغييرات التي يتم إجراؤها على هذه المنتجات مع الإصدارات الأولية والتجريبية الأخرى.

الإصدار الأولي: لا تزال الميزات في مرحلة المعاينة المبكرة. بينما نحاول إعلامك التغييرات القادمة، من المتوقع حدوث تغييرات قد تؤدي إلى أعطال قبل إصدار واجهة برمجة التطبيقات بشكل علني.

الإصدار التجريبي: من غير المتوقّع أن تحدث أي تغييرات قد تؤدي إلى أعطال في هذه القناة.

للحصول على إعلانات Google Analytics API الرسمية، اشترِك في مجموعة إشعارات Google Analytics API.

في ما يلي بعض الأمثلة التي يمكنك الإبلاغ عنها باستخدام الإصدار 1 من Google Analytics Data API:

عدد المستخدمين النشطين يوميًا الذين لديهم تطبيق Android خلال الأسبوع الماضي
عدد مشاهدات الصفحات في أهم 10 صفحات على موقعك الإلكتروني خلال آخر 28 يومًا
عدد المستخدمين النشطين لكل بلد لتطبيق iOS خلال آخر 30 دقيقة

يمكنك أيضًا استخدام الإصدار 1 من Google Analytics Data API لإجراء ما يلي:

إنشاء لوحات بيانات مخصصة لعرض بيانات "إحصاءات Google".
يمكنك تنفيذ مهام إعداد التقارير المعقدة تلقائيًا لتوفير الوقت.
دمج بيانات "إحصاءات Google" مع تطبيقات الأنشطة التجارية الأخرى.

البدء

للبدء، يُرجى الاطّلاع على مكتبة البرامج. التشغيل السريع. توجد مكتبات للعملاء في Java، بايثون وNode.js ولغات أخرى لتبسيط عملية التنفيذ.

الطرق المتاحة

في ما يلي قائمة بطرق Data API. لمزيد من التفاصيل، يُرجى الاطّلاع على المرجع. ذات الصلة.

runReport تعرض هذه الطريقة المخصص لبيانات الأحداث في "إحصاءات Google" وهو الخيار المفضّل لطلبات بحث بسيطة للتقارير.
batchRunReports هذا نسخة مجمّعة من طريقة runReport التي تتيح لك إنشاء العديد باستخدام طلب بيانات واحد من واجهة برمجة التطبيقات.
runPivotReport هذه الطريقة عرض تقرير محوري مخصّص لحدث "إحصاءات Google" البيانات. التقارير المحورية هي تنسيقات أكثر تقدمًا وتعبيرًا من التقارير العادية التقارير. يصف كل عنصر محوري أعمدة وصفوف المكونات المرئية في الرد على الإبلاغ.
batchRunPivotReports هذا إصدار مجمّع من طريقة runPivotReport الذي يتيح لك إنشاء تقارير متعددة باستخدام طلب بيانات واحد من واجهة برمجة التطبيقات.
getMetadata تعرض هذه الطريقة البيانات الوصفية للأبعاد والمقاييس المتاحة في طرق إعداد التقارير. اعتادت على استكشاف الأبعاد والمقاييس. كما أن الاستجابة لهذه الطريقة يتضمّن السمات والمقاييس المخصّصة المتاحة للسمة المحدّدة موقع على "إحصاءات Google".
checkCompatibility هذه تسرد طريقة الأبعاد والمقاييس التي يمكن إضافتها إلى طلب تقرير والحفاظ على التوافق.
runRealtimeReport هذه تعرض تقريرًا مخصصًا لبيانات الأحداث في الوقت الفعلي لموقعك. وتظهر الأحداث في تقارير الوقت الفعلي بعد ثوانٍ من حصولها على تم إرسالها إلى "إحصاءات Google" تعرض تقارير "الوقت الفعلي" الأحداث والاستخدام لفترات زمنية تتراوح من اللحظة الحالية إلى 30 دقيقة قبل (ما يصل إلى 60 دقيقة لمواقع "إحصاءات Google 360").
properties.audienceExports مجموعة من الطرق التي تتيح لك إنشاء شريحة جمهور عمليات التصدير، التي تتضمن نبذة عن المستخدمين في لجمهور.
properties.recurringAudienceLists (معاينة مبكرة) مجموعة من الطرق التي تتيح لك إدارة الإحالات الناجحة المتكررة عمليات تصدير شرائح الجمهور يؤدي تصدير شرائح الجمهور المتكرّرة إلى إنشاء قوائم مستخدمين جديدة. كل يوم
runFunnelReport (معاينة مبكرة) تعرض هذه الطريقة مسار إحالة ناجحة مخصّصًا تقرير بيانات أحداث "إحصاءات Google". استكشاف خطوات المستخدمين تتيح لك تصور الخطوات التي يتخذها المستخدمون لإكمال مهمة بسرعة ورؤية مدى نجاحهم أو فشلهم في كل خطوة.

السمات والمقاييس المتوافقة

للاطّلاع على قائمة بجميع السمات والمقاييس المتاحة في Data API، يمكنك الاطّلاع على مستندات مخطّط واجهة برمجة التطبيقات