● مجتمع
jtrackingai
⚡ فوري
event-tracking-skill
بواسطة jtrackingai · jtrackingai/event-tracking-skill
أتمتة تتبع الأحداث في GA4 و GTM — تحليل الموقع، وإنشاء مخطط الأحداث، ومزامنة GTM، والتحقق من المعاينة، والنشر من الوكيل الخاص بك.
Skill تتبع الأحداث يؤتمت سير العمل الكامل لتتبع الأحداث في GA4: مسح الموقع، واقتراح مخطط أحداث متوافق مع معايير GA4، والمزامنة مع Google Tag Manager، والتحقق في معاينة GTM، والنشر. يعمل عبر Claude Code و Cursor و Codex. يزيل الجزء المتكرر من عمل التحليلات.
لماذا تستخدمه
الميزات الأساسية
- تحليل آلي للموقع للاستدلال على احتياجات التتبع
- إنشاء مخطط أحداث متوافق مع GA4
- مزامنة حاوية GTM عبر Tag Manager API
- التحقق من المعاينة قبل النشر
- نشر إصدار حاوية العلامات بنقرة واحدة
- متوافق مع الوكلاء المتعددة
عرض مباشر
كيف يبدو في الممارسة
event-tracking-skill.replay
▶ جاهز
حالات الاستخدام
استخدامات عملية: event-tracking-skill
متى تستخدمه: لديك موقع نشط، لا يوجد تتبع حتى الآن، وهناك موعد نهائي.
الخطوات
-
مسح الموقع
مسح https://example.com واقتراح مخطط أحداث GA4 (page_view, view_item, add_to_cart، إلخ).✓ تم النسخ
→ قائمة الأحداث مع المعاملات وعينات الحمولات
-
المزامنة إلى GTM
مزامنة هذا المخطط إلى حاوية GTM GTM-ABCDEF كعلامات + محفزات + متغيرات.✓ تم النسخ
→ تم الإبلاغ عن تغييرات مساحة العمل
-
المعاينة والتحقق
افتح Preview على staging.example.com وتحقق من كل حدث.✓ تم النسخ
→ تقرير الحريق/الفشل لكل حدث
-
النشر
نشر إصدار مع ملاحظات 'إعداد GA4 الأولي'.✓ تم النسخ
→ تم إرجاع معرّف الإصدار المباشر
النتيجة: موقع تتبعه GA4 مع تدفق الأحداث في غضون ساعة.
المزالق
- تطلق الأحداث ولكن لا تظهر في GA4 لمدة 24 ساعة — استخدم DebugView في GA4 للتحقق في الوقت الفعلي أثناء الاختبار
- تضارب مساحة عمل GTM مع التعديلات اليدوية — قم بإنشاء مساحة عمل مخصصة لتغييرات Skill لتجنب التعارض مع الآخرين
متى تستخدمه: لديك تتبع أساسي لكن أنابيب التجارة الإلكترونية فارغة.
الخطوات
-
الاستدلال على أحداث المنتج
امسح /shop و /checkout واقترح قائمة أحداث GA4 الكاملة للتجارة الإلكترونية.✓ تم النسخ
→ view_item_list, view_item, add_to_cart, begin_checkout, purchase مع معامل items[]
-
تكوين أنماط push dataLayer
إنشاء مقاطع JS لدفع كل حدث من مكونات React الخاصة بنا.✓ تم النسخ
→ مقطع dataLayer.push لكل حدث
-
ربط GTM
إنشاء علامات GA4 والمحفزات المطابقة في GTM.✓ تم النسخ
→ علامات مرتبطة بأحداث dataLayer
النتيجة: أنبوب التجارة الإلكترونية الكامل مرئي في GA4.
متى تستخدمه: أنت في فريق جديد؛ تم إعداد GTM منذ سنوات؛ لا أحد يعرف ما هو نشط.
الخطوات
-
حفظ حالة الحاوية
اقرأ حاوية GTM GTM-XXXX وأدرج كل علامة نشطة ومحفز ومتغير.✓ تم النسخ
→ المخزون المعياري
-
المقارنة مع الموقع
الآن امسح الموقع وأظهر أي أحداث تطلق في معاينة GTM لكنها لم تعد ذات معنى، وأي أحداث يجب أن توجد ولا توجد.✓ تم النسخ
→ قائمة الفجوات والفوضى
النتيجة: قائمة PR تنظيف لمساحة عمل GTM الخاصة بك.
التركيبات
اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10
يجد تدقيق SEO مشاكل هيكلية، وتتبع الأحداث يقوم بتوصيل القياس
قم بتشغيل seo-audit وأصلح الفجوات الهيكلية، ثم event-tracking-skill لإعداد GA4.✓ تم النسخ
Skill التجارة الإلكترونية يقوم بإعداد الأنابيب، وتتبع الأحداث يقوم بأداة قياسها
استخدم ecommerce-skill لإعادة تصميم الخروج، ثم event-tracking لربط أحداث الشراء.✓ تم النسخ
التكلفة والحدود
تكلفة التشغيل
- حصة 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
- حساب الخدمة له حقوق تحرير الحاوية. حدد نطاقه على حاوية واحدة، وليس منظمة GCP بأكملها.
- خطوة النشر مباشرة على الموقع. تحقق دائماً في المعاينة أولاً.
استكشاف الأخطاء
الأخطاء الشائعة وحلولها
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 إنشاؤه بأمان | أبطأ وأكثر عرضة للخطأ |