Google Analytics MCP: بيانات GA4 مجانية للوكلاء

يتيح خادم zaDojo MCP لوكيل الذكاء الاصطناعي الخاص بك قراءة خاصية Google Analytics 4 لديك: الزوار، والجلسات، ومشاهدات الصفحات، ومعدل الارتداد، والأحداث الرئيسية، والإيرادات، مقسّمة بحسب القناة أو الصفحة أو البلد أو المدينة أو الجهاز أو المتصفح، إضافة إلى من يتصفح الموقع الآن. تربط GA4 داخل zaDojo بتسجيل دخول Google عادي، فلا حاجة إلى مشروع Google Cloud، ولا إلى تفعيل API، ولا إلى ملف بيانات اعتماد. قراءة Google Analytics لا تستهلك أي رصيد، والبيانات نفسها تظهر كلوحة معلومات في تطبيق zaDojo.

اربطه في ثلاث خطوات

1. أنشئ حسابًا في zaDojo ومشروعًا لموقعك. التسجيل لا يحتاج إلى بطاقة.
2. في المشروع، افتح My Site > Analytics واربط Google Analytics. سجّل الدخول بحساب Google يستطيع رؤية خاصية GA4، ووافق على الوصول للقراءة فقط، واختر الخاصية.
3. أضف عنوان الخادم أدناه إلى عميل الذكاء الاصطناعي الخاص بك، ووافق على تسجيل الدخول إلى zaDojo عند الاتصال لأول مرة.

https://app.zadojo.com/mcp

Claude Code

claude mcp add --transport http --scope user zadojo https://app.zadojo.com/mcp

Codex CLI

codex mcp add zadojo --url https://app.zadojo.com/mcp

Cursor: أضف ما يلي إلى mcp.json ضمن Settings > Tools & Integrations > MCP Tools.

{
  "mcpServers": {
    "zadojo": {
      "url": "https://app.zadojo.com/mcp"
    }
  }
}

Claude Desktop: افتح Customize > Connectors، واختر Add custom connector، والصق العنوان.

ChatGPT يحتاج إلى اتصال مخصص، ويسرد دليل ChatGPT الخطوات والخطط التي تدعمه. والعملاء الآخرون الذين يدعمون خوادم MCP البعيدة يقبلون العنوان نفسه، ويغطي دليل إعداد MCP كل عميل.

ما يستطيع وكيلك قراءته

كل أداة تجيب عن نوع واحد من الأسئلة، لذا يختار وكيلك التقرير المناسب من سؤالك بدلًا من بناء استعلام GA4 من الصفر.

نظرة عامة على الزيارات والتقسيمات

تغطي النظرة العامة على الزيارات كل القنوات. وتعيد الزوار (المستخدمون النشطون في GA4)، والجلسات، ومشاهدات الصفحات، ومعدل الارتداد، ومتوسط مدة الجلسة، والأحداث الرئيسية، وإيرادات الشراء، وكل منها مقارنة بالفترة السابقة ذات الطول نفسه، إضافة إلى اتجاه يومي.

تقبل النظرة العامة والتقسيم المرشحات نفسها: القناة، والمصدر، والحملة، وصفحة الهبوط، والصفحة، والبلد، والمنطقة، والمدينة، والجهاز، والمتصفح، ونظام التشغيل. وتُدمج المرشحات معًا، لذا يستطيع سؤال واحد تضييق الأرقام إلى "زوار الهاتف المحمول من ألمانيا القادمين من Google". ويسرد التقسيم أعلى 50 قيمة لبُعد واحد من هذه الأبعاد، وبهذه الطريقة ينتقل الوكيل من البلدان إلى المدن داخل بلد واحد.

Search Console وGA4 معًا

إذا كان المشروع مرتبطًا أيضًا بـ Search Console، فإن get_search_opportunities تجمع بينهما. تأخذ الصفحات التي تحتل المراتب من 4 إلى 20 في Search Console، وتطابقها مع جلساتها وأحداثها الرئيسية في GA4، وتمنحها درجة بحسب الطلب والقيمة التجارية ومدى قربها من الصفحة الأولى. والصفحات التي لا توجد لها بيانات في GA4 تبقى في القائمة دون درجة.

البيانات نفسها كلوحة معلومات

لا تحتاج إلى وكيل لترى الأرقام. بعد ربط GA4، يعرض قسم My Site > Analytics في تطبيق zaDojo:

• سبعة أرقام رئيسية (الزوار، والجلسات، ومشاهدات الصفحات، ومعدل الارتداد، ومتوسط الجلسة، والأحداث الرئيسية، والإيرادات)، كل منها مع التغير مقارنة بالفترة السابقة؛
• مخططًا يوميًا لأي من هذه الأرقام تختاره؛
• أربع لوحات: Sources (القناة، والمصدر، والحملة)، وPages (صفحة الهبوط، والصفحة)، وLocations (البلد، والمنطقة، والمدينة)، وDevices (الجهاز، والمتصفح، ونظام التشغيل)؛
• عدًّا حيًّا للزوار على الموقع خلال آخر 30 دقيقة، يُحدَّث كل دقيقة.

انقر أي صف، بلدًا أو متصفحًا مثلًا، فتضيق الصفحة كلها إليه. تتراكم المرشحات، ويمكنك اختيار آخر 7 أو 28 أو 90 يومًا، أو آخر 12 شهرًا، أو تواريخك الخاصة. عرض لوحة المعلومات لا يستهلك أي رصيد.

أسئلة تستحق الطرح

• "كيف تغيرت زيارات الهاتف المحمول من ألمانيا خلال آخر 7 أيام مقارنة بالأسبوع الذي قبله؟"
• "أي المدن الأمريكية أرسلت أكبر عدد من الزوار هذا الشهر؟"
• "أي صفحات الهبوط تجلب زوارًا عضويين يسجّلون بعد ذلك؟"
• "هل يوجد أحد على الموقع الآن؟"
• "أي الصفحات تظهر في الصفحة الثانية في Search Console وتحقق تحويلات أصلًا في GA4؟"
• "هل تتبع البحث داخل الموقع مفعّل، وأي الأحداث الرئيسية مُعدة؟"

التكلفة

قراءة Google Analytics لا تستهلك أي رصيد مهما كان عدد الأسئلة، وعرض لوحة المعلومات مجاني. ويمكنك ربط GA4 في حساب جديد دون إدخال بطاقة.

اتصال MCP نفسه يخدم أيضًا أدوات البحث المدفوعة في zaDojo، مثل بحث الكلمات المفتاحية (نحو 0.07 يورو للبحث)، والروابط الخلفية، وتتبع الترتيب. وهذه تستهلك الرصيد: الاشتراك بـ 10 يورو شهريًا ويتضمن استخدامًا بقيمة 10 يورو. ويوضح وصف كل أداة إن كانت تستهلك رصيدًا، ليتمكن وكيلك من التمييز بين النوعين.

للقراءة فقط بحكم التصميم

يطلب zaDojo من Google النطاق analytics.readonly. يستطيع وكيلك قراءة التقارير، لكنه لا يستطيع تغيير الإعدادات أو تعديل الأحداث الرئيسية أو إضافة مستخدمين أو المساس بكود التتبع. ويمكنك قطع الاتصال في zaDojo في أي وقت، أو إزالة وصول zaDojo من إعدادات حساب Google الخاص بك.

مقارنة بخادم MCP الرسمي من Google

تنشر Google خادم Google Analytics MCP مفتوح المصدر، مصنّفًا كتجريبي. يعمل على جهازك باستخدام Python، وتعده بنفسك:

1. أنشئ مشروع Google Cloud أو اختر مشروعًا.
2. فعّل Google Analytics Admin API وData API.
3. أعدّ بيانات الاعتماد بالنطاق analytics.readonly، عبر عميل OAuth أو حساب خدمة.
4. وجّه الخادم إلى ملف بيانات الاعتماد ومعرّف مشروعك.

خادم Google هو الخيار الأفضل إذا أردت كل شيء على جهازك، أو كنت تحتاج إلى تقارير لا يقدمها zaDojo، مثل مسارات التحويل أو الأبعاد المخصصة. أما zaDojo فيناسب من يريد بيانات GA4 في وكيله اليوم، بجانب أدوات Search Console والكلمات المفتاحية والترتيب، دون تثبيت أي شيء.

حدود يجب معرفتها

• تغطي التقارير الأيام المكتملة فقط. تنتهي الفترات بالأمس، بحسب المنطقة الزمنية لخاصيتك.
• تحجب Google بعض البيانات أو تأخذ منها عيّنات لأسباب تتعلق بالخصوصية. وعندما يحدث ذلك، تشير الأدوات إلى أن التقرير محدود، والصفوف المفقودة مجهولة القيمة وليست صفرًا.
• تعيد التقسيمات أعلى 50 قيمة. ويمكن أن تغطي الفترات المخصصة حتى 366 يومًا.
• تطابق المرشحات القيم بدقة. تستخدم البلدان رموزًا من حرفين مثل DE، وأكثر القيم أمانًا للتصفية هي التي أعادها تقسيم سابق.
• يغطي العدّ الفوري الموقع كله ولا يقبل مرشحات.
• لا توجد بيانات ديموغرافية ولا بيانات على مستوى المستخدم ولا أبعاد مخصصة.
• خصائص GA4 فقط. ويحتاج حساب Google الذي تربطه إلى صلاحية الوصول إلى الخاصية.
• تحدد Google حجم التقارير التي يمكن لكل خاصية تشغيلها في الساعة وفي اليوم. تعرض التقارير الحصة المتبقية عندما ترسلها Google. وإذا نفدت الحصة، تعيد الأدوات خطأ بدلًا من أرقام جزئية، مع وقت إعادة المحاولة عندما تحدده Google.

الأسئلة الشائعة

هل أحتاج إلى مشروع Google Cloud؟

لا. تسجّل الدخول بحساب Google داخل zaDojo وتوافق على الوصول للقراءة فقط. ويتولى zaDojo الاتصال بواجهة API.

هل تستهلك قراءة Google Analytics رصيدًا؟

لا. قراءة Google Analytics وSearch Console لا تستهلك أي رصيد، في التطبيق وعبر وكيلك.

هل يستطيع الوكيل تغيير أي شيء في Google Analytics؟

لا. يطلب zaDojo النطاق analytics.readonly، لذا يستطيع الوكيل قراءة التقارير لكنه لا يستطيع تغيير الإعدادات أو الأحداث أو المستخدمين.

أي عملاء الذكاء الاصطناعي يمكنهم استخدامه؟

Claude Code، وClaude Desktop، وCursor، وCodex CLI، وCodex في تطبيق ChatGPT لسطح المكتب، وChatGPT مع اتصال مخصص، وغيرها من العملاء الذين يدعمون خوادم MCP البعيدة.

هل يعمل مع Universal Analytics؟

لا. يقرأ خصائص GA4 فقط.