/ الدليل / الملعب / event-tracking-skill
● مجتمع 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

التثبيت

مستودع المؤلف · وثائق Claude Skills الرسمية

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

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

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

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

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

الخطوات
  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