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

يمكنك استخدام Data API للوصول آليًا إلى بيانات تقارير "إحصاءات Google".

مزيد من المعلومات عن المواقع على "إحصاءات 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 أو PHP أو C#‎ أو Go أو Ruby، يُرجى الاطّلاع على دليل البدء السريع لمكتبة البرامج. لمعرفة كيفية إنشاء طلبات البحث وفلترة السمات وقراءة الردود، يُرجى الاطّلاع على مقالة إنشاء تقرير أو اختبار طلبات البحث بشكل تفاعلي في Query Explorer.

نموذج طلب واستجابة runReport

لطلب بيانات الأحداث عبر REST، أرسِل طلب POST إلى نقطة النهاية runReport مع نص JSON RunReportRequest يحدّد dateRanges وdimensions وmetrics:

POST https://analyticsdata.googleapis.com/v1beta/properties/GA_PROPERTY_ID:runReport
{
  "dateRanges": [
    { "startDate": "7daysAgo", "endDate": "yesterday" }
  ],
  "dimensions": [
    { "name": "country" }
  ],
  "metrics": [
    { "name": "activeUsers" }
  ]
}

أو يمكنك تنفيذ أمر curl المكافئ باستخدام بيانات الاعتماد التلقائية للتطبيق:

curl -X POST \
  "https://analyticsdata.googleapis.com/v1beta/properties/GA_PROPERTY_ID:runReport" \
  -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
  -H "x-goog-user-project: PROJECT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "dateRanges": [
      { "startDate": "7daysAgo", "endDate": "yesterday" }
    ],
    "dimensions": [
      { "name": "country" }
    ],
    "metrics": [
      { "name": "activeUsers" }
    ]
  }'

تعرض واجهة برمجة التطبيقات RunReportResponse يحتوي على عناوين الأعمدة وصفوف البيانات:

{
  "dimensionHeaders": [
    { "name": "country" }
  ],
  "metricHeaders": [
    { "name": "activeUsers", "type": "TYPE_INTEGER" }
  ],
  "rows": [
    {
      "dimensionValues": [{ "value": "United States" }],
      "metricValues": [{ "value": "4820" }]
    },
    {
      "dimensionValues": [{ "value": "Japan" }],
      "metricValues": [{ "value": "2541" }]
    }
  ],
  "rowCount": 2,
  "kind": "analyticsData#runReport"
}

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

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

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

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

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