ربط Novaco بـ Google Analytics

    قم بتمرير الأحداث من مساعدك الافتراضي إلى Google Tag Manager أو Google Analytics 4 وقم بإعداد تقارير عن المحادثات والعملاء المحتملين والمواعيد.

    طريقتان

    هناك طريقتان لربط بيانات Novaco بـ Google Analytics. اختر واحدة — لا تشغّل الطريقتين معًا أبدًا.

    ما هي الأحداث المتاحة؟ راجع مرجع أحداث Google Analytics.

    الربط باستخدام Google Tag Manager

    يقوم GTM بتوزيع الأحداث على أطراف ثالثة عبر العلامات. للقيام بذلك، توفر البيانات في ما يُسمى "طبقة البيانات". أضف مستمعًا (listener) لكل حدث تريد استخدامه.

    مثال: حدث واحد

    <script>
    window.addEventListener('autochat_lead_created', function (e) {
      try {
        dataLayer.push({
          "event": e.type,
          "autochat_event_details": e.detail.eventData
        });
      } catch(e) {
        // Your error handling if relevant
      }
    });
    </script>

    مثال: عدة أحداث

    <script>
    window.addEventListener('autochat_lead_created', function (e) {
      try {
        dataLayer.push({
          "event": e.type,
          "autochat_event_details": e.detail.eventData
        });
      } catch(e) {
        // Your error handling if relevant
      }
    });
    window.addEventListener('autochat_chat_first_user_interaction', function (e) {
      try {
        dataLayer.push({
          "event": e.type,
          "autochat_event_details": e.detail.eventData
        });
      } catch(e) {
        // Your error handling if relevant
      }
    });
    </script>

    عبارة try-catch هي معالجة أخطاء اختيارية — يمكنك تركها كما هي.

    إنشاء متغيرات طبقة البيانات

    بالإضافة إلى الأحداث، توفر Novaco بيانات أحداث إضافية مثل session_id وchat_type وappointment_type. أنشئ متغيرًا لكل منها.

    1. اذهب إلى حاوية GTM الخاصة بك.
    2. اذهب إلى المتغيرات وانقر على "جديد" ضمن "المتغيرات المعرّفة من قبل المستخدم".
    3. اختر "متغير طبقة البيانات" كنوع المتغير.
    4. أعطه اسمًا واضحًا، على سبيل المثال "Novaco – session_id".
    5. كاسم متغير طبقة البيانات، أدخل اسم متغير Novaco.
    6. انقر على حفظ.

    ربط الأحداث بالمشغلات والعلامات

    أنشئ مشغلاً لكل حدث تريد التصرف بناءً عليه، ثم اجمع المشغلات والمتغيرات في علامة GA4.

    إنشاء مشغل

    1. اذهب إلى حاوية GTM الخاصة بك.
    2. اذهب إلى المشغلات وانقر على "جديد".
    3. اختر نوع المشغل "حدث مخصص".
    4. أعطه اسمًا واضحًا، على سبيل المثال "Novaco – Lead created".
    5. استخدم اسم حدث Novaco كاسم للحدث.
    6. انقر على حفظ.

    إنشاء علامة GA4

    1. اذهب إلى العلامات وانقر على "جديد".
    2. اختر نوع العلامة "Google Analytics: GA4 Event".
    3. أعطها اسمًا واضحًا، على سبيل المثال "GA4 – Novaco events".
    4. املأ معرّف القياس الخاص بك أو اربطه بتكوين علامة Google الخاصة بك.
    5. املأ {{Event}} كاسم للحدث.
    6. ضمن "معاملات الحدث"، أضف متغيرات Novaco كمعاملات.
    7. انقر على حفظ.

    أي مشغل حدث Novaco تضيفه الآن يرسل بياناته تلقائيًا إلى GA4. يمكن استخدام نفس العناصر الأساسية لعلامات أخرى، مثل تحويل عميل محتمل في Google Ads.

    الربط المباشر بـ Google Analytics 4

    لا يوجد لديك مدير علامات؟ استخدم تطبيق علامة Google (gtag.js). لا تقم أبدًا بتشغيل هذا الإعداد بالتوازي مع Google Tag Manager — إذا كنت تستخدم GTM، فاتبع الدليل أعلاه بدلاً من ذلك.

    1. قم بإعداد علامة Google الخاصة بك

    <script async src="https://www.googletagmanager.com/gtag/js?id=G-12345678"></script>
    <script>
      window.dataLayer = window.dataLayer || [];
      function gtag(){dataLayer.push(arguments);}
      gtag('js', new Date());
    
      gtag('config', 'G-12345678');
    </script>

    استبدل G-12345678 بمعرّف القياس الخاص بك.

    2. أضف تتبع أحداث Novaco

    أضف هذا المقتطف بعد استدعاء gtag('config', ...) الخاص بك.

    <script>
    window.addEventListener('autochat_lead_created', function (e) {
      try {
        gtag('event', e.type, {
          'session_id': e.detail.eventData.session_id,
          'appointment_type': e.detail.eventData.appointment_type
        });
      } catch(e) {
        // Your error handling if relevant
      }
    });
    window.addEventListener('autochat_chat_first_user_interaction', function (e) {
      try {
        gtag('event', e.type, {
          'session_id': e.detail.eventData.session_id,
          'chat_type': e.detail.eventData.chat_type
        });
      } catch(e) {
        // Your error handling if relevant
      }
    });
    </script>

    يتم حل e.type تلقائيًا إلى اسم الحدث، على سبيل المثال autochat_lead_created. وهذا هو أيضًا اسم الحدث الذي ستراه في GA4. كل ما يأتي بعده هو معاملات الحدث.

    أبعاد GA4 المخصصة

    لإعداد تقارير عن معاملات الأحداث، سجّلها كأبعاد مخصصة في GA4.

    1. اذهب إلى إدارة موقع GA4 الخاص بك.
    2. اذهب إلى "التعريفات المخصصة".
    3. اذهب إلى "الأبعاد المخصصة" وانقر على "إنشاء بُعد مخصص".
    4. استخدم اسم بُعد وصفي، على سبيل المثال "Novaco chat open type".
    5. اضبط النطاق على "حدث".
    6. كمعامل للحدث، استخدم اسم المتغير الذي استخدمته في علامة GA4، على سبيل المثال chat_open_type.

    analyticsSetup.dimensions.note

    تبحث عن قائمة الأحداث؟

    كل حدث، وموعد إطلاقه، والبيانات التي يحملها.

    عرض مرجع الأحداث