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

يمنحك الإصدار الأول من Data API على "إحصاءات Google" وصولاً آليًا إلى بيانات تقارير "إحصاءات Google 4" (GA4). تساعدك "إحصاءات Google 4" في فهم كيفية استخدام الأشخاص لتطبيقك على الويب أو iOS أو Android. اطّلِع على مزيد من المعلومات عن مواقع "إحصاءات Google 4".

باستخدام الإصدار 1 من Data API على "إحصاءات Google"، يمكنك إنشاء تقارير للإجابة عن أسئلة مثل:

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

يمكن أيضًا استخدام الإصدار الأول من Data API على "إحصاءات Google" للأغراض التالية:

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

دليل البدء السريع

يمكنك طلب بيانات من واجهة برمجة التطبيقات لإنشاء تقريرك الأول باستخدام بضعة أسطر من الرموز. يمكنك الاطلاع على البدء السريع في استخدام مكتبات العملاء للبدء. توجد مكتبات للعملاء في Java وPython وNode.js ولغات أخرى لتبسيط عملية التنفيذ.

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

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

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

تسرد مستندات مخطط واجهة برمجة التطبيقات السمات والمقاييس المتوافقة حاليًا مع Analytics Data API.