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