نظرة عامة على Data API في "إحصاءات Google 4"

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

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

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

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

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

لتلقّي الإشعارات الرسمية من واجهة برمجة تطبيقات "إحصاءات Google"، يمكنك الاشتراك في مجموعة إشعارات واجهة Google Analytics API.

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

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

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

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

البدء

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

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

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

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

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

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