## ما هو يمكّنك هذا التكامل من ربط روبوت Botpress الخاص بك مع Google Analytics ، مما يسمح لك بتحديث ملفات تعريف المستخدمين وتتبع طرق عرض العقدة والأحداث المخصصة مباشرةً داخل تدفقات الروبوت الخاص بك. ## كيف يعمل يعمل التكامل باستخدام إجراءات للتفاعل مع Google Analytics عبر بروتوكول القياس. فيما يلي لمحة موجزة عن الإجراءات: 1. ** تحديث ملف تعريف المستخدم**: يرسل تحديثات ملف تعريف المستخدم إلى Google Analytics. 2. **تتبع العقدة**: تتبع عندما يتم تشغيل عقدة معينة داخل الروبوت الخاص بك، وإرسال بيانات الحدث إلى Google Analytics. 3. **تتبع الحدث**: يرسل بيانات الحدث المخصص إلى Google Analytics ، بما في ذلك الخصائص الاختيارية المحددة في الحمولة. تستخدم هذه الإجراءات معرف القياس Google Analytics واختيارياً سر واجهة برمجة التطبيقات لنقل البيانات بشكل آمن. ## ميزات التكامل ### الإجراءات - **تحديث ملف تعريف المستخدم** - يرسل تحديثات لمعلومات ملف تعريف المستخدم إلى Google Analytics. - المدخلات: معرف المستخدم، ملف تعريف المستخدم (سلسلة JSON اختيارية لبيانات تعريف المستخدم) - **تتبع العقدة** - يرسل بيانات التتبع لتفعيل العقدة داخل الروبوت إلى Google Analytics. - المدخلات: معرّف المستخدم، معرّف العقدة - **تتبع الحدث** - يرسل بيانات لحدث مخصص إلى Google Analytics. - المدخلات: معرّف المستخدم، اسم الحدث، حمولة الحدث (سلسلة JSON اختيارية لخصائص الحدث) ### التكوين - ** معرف القياس**: هذا المعرف مطلوب لإرسال البيانات إلى Google Analytics. يمكنك العثور على هذا المعرف في لوحة التحكم Google Analytics ضمن المسؤول > تدفقات البيانات. - ** سر واجهة برمجة التطبيقات**: يُستخدم لتأمين نقل البيانات. يمكن الحصول عليه من نفس قسم معرف القياس ضمن أسرار واجهة برمجة تطبيقات بروتوكول القياس. ## تعليمات الإعداد #### Google Analytics الإعداد 1. سجّل الدخول إلى لوحة التحكم Google Analytics . 2. قم بإنشاء أو تحديد خاصية GA4 موجودة. 3. قم بتكوين أو التحقق من تدفق البيانات للحصول على معرف القياس وسر واجهة برمجة التطبيقات. #### Botpress الإعداد 1. انقر فوق "تثبيت" في أعلى اليمين وحدد الروبوت الخاص بك. 2. اتبع التعليمات المنبثقة لتهيئة التكامل الخاص بك. 3. أدخل مُعرِّف القياس Google Analytics الخاص بك، وفي حالة استخدامه، أدخل مُعرِّف واجهة برمجة التطبيقات السرية في الحقول المناسبة. 4. قم بتمكين التكامل لحفظ إعداداتك.
