يمنحك الإصدار 1 من Google Analytics Data API إمكانية الوصول الآلي إلى بيانات تقارير "إحصاءات Google 4" (GA4). تساعدك "إحصاءات Google 4" في فهم كيفية استخدام الأشخاص لموقعك الإلكتروني أو تطبيقك على iOS أو Android. اطّلِع على مزيد من المعلومات عن مواقع "إحصاءات Google 4".
باستخدام الإصدار 1 من Google Analytics Data API، يمكنك إنشاء تقارير للإجابة عن أسئلة مثل:
- كم عدد المستخدمين النشطين يوميًا لتطبيق Android الخاص بي في الأسبوع الماضي؟
- كم عدد مشاهدات الصفحة التي تلقّاها كل عنوان من أهم 10 عناوين URL لصفحات موقعي الإلكتروني خلال آخر 28 يومًا؟
- كم عدد المستخدمين النشطين لكل بلد في تطبيق iOS خلال آخر 30 دقيقة؟
يمكن أيضًا استخدام الإصدار 1 من Google Analytics Data API لتنفيذ ما يلي:
- إنشاء لوحات بيانات مخصّصة لعرض بيانات "إحصاءات 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.