نظرة عامة على 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، يُرجى الاطّلاع على دليل البدء السريع لمكتبة البرامج. لمعرفة كيفية إنشاء طلبات البحث وفلترة السمات وقراءة الردود، يمكنك الاطّلاع على إنشاء تقرير أو تجربة طلبات البحث بشكل تفاعلي في مستكشف طلبات البحث.

عيّنة من طلب 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، يُرجى مراجعة مستندات مخطط واجهة برمجة التطبيقات.