/ الدليل / الملعب / event-tracking-skill
← كل الخوادم ↗ GitHub
● مجتمع jtrackingai ⚡ فوري

event-tracking-skill

بواسطة jtrackingai · jtrackingai/event-tracking-skill

أتمتة تتبع الأحداث في GA4 و GTM — تحليل الموقع، وإنشاء مخطط الأحداث، ومزامنة GTM، والتحقق من المعاينة، والنشر من الوكيل الخاص بك.

Skill تتبع الأحداث يؤتمت سير العمل الكامل لتتبع الأحداث في GA4: مسح الموقع، واقتراح مخطط أحداث متوافق مع معايير GA4، والمزامنة مع Google Tag Manager، والتحقق في معاينة GTM، والنشر. يعمل عبر Claude Code و Cursor و Codex. يزيل الجزء المتكرر من عمل التحليلات.

▶ شاهد العرض 📦 التثبيت 💡 حالات الاستخدام

لماذا تستخدمه

الميزات الأساسية

عرض مباشر

كيف يبدو في الممارسة

event-tracking-skill.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "event-tracking-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jtrackingai/event-tracking-skill",
        "~/.claude/skills/event-tracking-skill"
      ],
      "_inferred": true
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "event-tracking-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jtrackingai/event-tracking-skill",
        "~/.claude/skills/event-tracking-skill"
      ],
      "_inferred": true
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "event-tracking-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jtrackingai/event-tracking-skill",
        "~/.claude/skills/event-tracking-skill"
      ],
      "_inferred": true
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "event-tracking-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jtrackingai/event-tracking-skill",
        "~/.claude/skills/event-tracking-skill"
      ],
      "_inferred": true
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "event-tracking-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jtrackingai/event-tracking-skill",
        "~/.claude/skills/event-tracking-skill"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json
{
  "context_servers": {
    "event-tracking-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/jtrackingai/event-tracking-skill",
          "~/.claude/skills/event-tracking-skill"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add event-tracking-skill -- git clone https://github.com/jtrackingai/event-tracking-skill ~/.claude/skills/event-tracking-skill

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

حالات الاستخدام

استخدامات عملية: event-tracking-skill

كيفية إعداد GA4 + GTM من الصفر على موقع جديد

👤 المسوقون ومطورو الخوادم الكاملة الذين يقومون بأداة قياس موقع جديد ⏱ ~60 min intermediate

متى تستخدمه: لديك موقع نشط، لا يوجد تتبع حتى الآن، وهناك موعد نهائي.

المتطلبات الأساسية
  • تم تثبيت Skill — git clone https://github.com/jtrackingai/event-tracking-skill ~/.claude/skills/event-tracking-skill
  • خاصية GA4 + حاوية GTM — قم بالإنشاء في Google Tag Manager؛ لاحظ معرّف GTM-XXXXXX
  • حساب خدمة مع إمكانية الوصول إلى Tag Manager API — وحدة تحكم GCP → تفعيل Tag Manager API → JSON حساب الخدمة
الخطوات
  1. مسح الموقع
    مسح https://example.com واقتراح مخطط أحداث GA4 (page_view, view_item, add_to_cart، إلخ).✓ تم النسخ
    → قائمة الأحداث مع المعاملات وعينات الحمولات
  2. المزامنة إلى GTM
    مزامنة هذا المخطط إلى حاوية GTM GTM-ABCDEF كعلامات + محفزات + متغيرات.✓ تم النسخ
    → تم الإبلاغ عن تغييرات مساحة العمل
  3. المعاينة والتحقق
    افتح Preview على staging.example.com وتحقق من كل حدث.✓ تم النسخ
    → تقرير الحريق/الفشل لكل حدث
  4. النشر
    نشر إصدار مع ملاحظات 'إعداد GA4 الأولي'.✓ تم النسخ
    → تم إرجاع معرّف الإصدار المباشر

النتيجة: موقع تتبعه GA4 مع تدفق الأحداث في غضون ساعة.

المزالق
  • تطلق الأحداث ولكن لا تظهر في GA4 لمدة 24 ساعة — استخدم DebugView في GA4 للتحقق في الوقت الفعلي أثناء الاختبار
  • تضارب مساحة عمل GTM مع التعديلات اليدوية — قم بإنشاء مساحة عمل مخصصة لتغييرات Skill لتجنب التعارض مع الآخرين
اجمعها مع: seo-audit-skill

إضافة أحداث GA4 للتجارة الإلكترونية على موقع موجود

👤 مشغلو التجارة الإلكترونية بالفعل على GA4 لكن ينقصهم تتبع الشراء/عرض_العنصر ⏱ ~45 min intermediate

متى تستخدمه: لديك تتبع أساسي لكن أنابيب التجارة الإلكترونية فارغة.

الخطوات
  1. الاستدلال على أحداث المنتج
    امسح /shop و /checkout واقترح قائمة أحداث GA4 الكاملة للتجارة الإلكترونية.✓ تم النسخ
    → view_item_list, view_item, add_to_cart, begin_checkout, purchase مع معامل items[]
  2. تكوين أنماط push dataLayer
    إنشاء مقاطع JS لدفع كل حدث من مكونات React الخاصة بنا.✓ تم النسخ
    → مقطع dataLayer.push لكل حدث
  3. ربط GTM
    إنشاء علامات GA4 والمحفزات المطابقة في GTM.✓ تم النسخ
    → علامات مرتبطة بأحداث dataLayer

النتيجة: أنبوب التجارة الإلكترونية الكامل مرئي في GA4.

اجمعها مع: ecommerce-skill

تدقيق حاوية GTM موجودة للعثور على فجوات التغطية

👤 المحللون الذين يرثون GTM فوضوية ⏱ ~30 min advanced

متى تستخدمه: أنت في فريق جديد؛ تم إعداد GTM منذ سنوات؛ لا أحد يعرف ما هو نشط.

الخطوات
  1. حفظ حالة الحاوية
    اقرأ حاوية GTM GTM-XXXX وأدرج كل علامة نشطة ومحفز ومتغير.✓ تم النسخ
    → المخزون المعياري
  2. المقارنة مع الموقع
    الآن امسح الموقع وأظهر أي أحداث تطلق في معاينة GTM لكنها لم تعد ذات معنى، وأي أحداث يجب أن توجد ولا توجد.✓ تم النسخ
    → قائمة الفجوات والفوضى

النتيجة: قائمة PR تنظيف لمساحة عمل GTM الخاصة بك.

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

event-tracking-skill + seo-audit-skill

يجد تدقيق SEO مشاكل هيكلية، وتتبع الأحداث يقوم بتوصيل القياس

قم بتشغيل seo-audit وأصلح الفجوات الهيكلية، ثم event-tracking-skill لإعداد GA4.✓ تم النسخ
event-tracking-skill + ecommerce-skill

Skill التجارة الإلكترونية يقوم بإعداد الأنابيب، وتتبع الأحداث يقوم بأداة قياسها

استخدم ecommerce-skill لإعادة تصميم الخروج، ثم event-tracking لربط أحداث الشراء.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداةالمدخلاتمتى تستدعيهاالتكلفة
scan_site url قبل أي تغييرات GTM Claude tokens
sync_gtm container_id, schema بعد مراجعة المخطط 1+ Tag Manager API calls
preview_verify container_id, target_url قبل النشر 0
publish_version container_id, notes بعد نجاح المعاينة 1 API call
audit_container container_id وراثة GTM موجودة 1+ API calls

التكلفة والحدود

تكلفة التشغيل

حصة API
GTM Tag Manager API: 250 طلب / 100 ثانية لكل مستخدم؛ كريمة للإعداد اليدوي
الرموز لكل استدعاء
10-30 ألف رمز لكل إعداد كامل
التكلفة المالية
مجاني (GA4 و GTM مجاني)
نصيحة
حدد نطاق الفحوصات إلى 5-10 صفحات رئيسية لتجنب الزحف الطويل.

الأمان

الصلاحيات والأسرار ونطاق الأثر

تخزين بيانات الاعتماد: Service account JSON في متغير env أو مسار ملف. نطاق كتابة GTM: tagmanager.edit.containers, tagmanager.publish.
نقل البيانات الخارجي: فحص الموقع يقرأ عناوينك؛ يتم دفع المخطط إلى Google Tag Manager.
لا تمنح أبدًا: tagmanager.delete.containers

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

401 Unauthorized on Tag Manager API

لم يتم إضافة حساب الخدمة كمستخدم في حاوية GTM. أضفه في GTM Admin → User Management.

تحقق: curl -H "Authorization: Bearer $TOKEN" https://tagmanager.googleapis.com/tagmanager/v2/accounts
Preview shows events firing but GA4 DebugView is empty

علامة إعداد GA4 مفقودة أو الإرسال إلى معرّف قياس خاطئ. تحقق مرة أخرى من G-XXXXXX في علامة الإعداد.

Published version rolls back changes

تم نشر مساحة عمل أخرى بعد مساحتك. قم بمطابقة مساحتي العمل، ودمجهما، وأعد نشرهما.

البدائل

event-tracking-skill مقابل البدائل

البديلمتى تستخدمهاالمقايضة
إعداد GTM اليدويتحتاج إلى منطق مخصص لا يمكن للـ LLM إنشاؤه بأمانأبطأ وأكثر عرضة للخطأ

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills