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