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

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

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

في ما يلي بعض الأمثلة التي يمكنك إعداد تقارير عنها باستخدام الإصدار 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.audienceExports مجموعة من الطرق التي تتيح لك إنشاء عمليات تصدير شرائح الجمهور، والتي تتضمّن نبذة عن المستخدِمين في شريحة جمهور معيّنة.
  • properties.recurringAudienceLists (ميزة متوفّرة في مرحلة معاينة) مجموعة من الطرق التي تتيح لك إدارة عمليات تصدير ملفّات الجمهور المتكرّرة. تؤدي عملية تصدير الجمهور المتكرّرة إلى إنشاء قوائم جمهور جديدة كل يوم.
  • runFunnelReport (إصدار تجريبي مبكر) تعرِض هذه الطريقة تقرير مسار إحالة ناجحة مخصّصًا لبيانات الأحداث في "إحصاءات Google". يتيح لك استكشاف خطوات المستخدِمين الاطّلاع على تمثيل بصري للخطوات التي يتّخذها المستخدِمون لإكمال مهمة وبالتالي معرفة مدى نجاحهم أو فشلهم في كلّ خطوة.

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

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