الخطوة 2: دمج Google Analytics
| مقدمة: قياس الإحالات الناجحة في "إعلانات iOS" |
|
الخطوة 1: تنفيذ تجربة تسجيل الدخول |
|
الخطوة 2: الدمج Google Analytics |
| الخطوة 3: بدء عملية قياس الإحالات الناجحة على الجهاز فقط باستخدام Google Analytics |
| الخطوة 4: تحديد المشاكل الشائعة وحلّها |
بعد تنفيذ نظام مصادقة لجمع عناوين البريد الإلكتروني أو أرقام الهواتف الخاصة بالمستخدمين، يمكنك البدء في دمج Google Analytics لحزمة تطوير البرامج (SDK) الخاصة بمنصة Firebase.
دمج حزمة تطوير البرامج (SDK) Google Analytics لنظام Firebase
لاستخدام ميزة "قياس الإحالات الناجحة على الجهاز فقط باستخدام بيانات الطرف الأول" كما هو موضّح في هذا البرنامج التعليمي، يجب استخدام الإصدار 11.14.0 أو إصدار أحدث من Google Analytics لحزمة تطوير البرامج (SDK) لمنصات Apple من Firebase. تأكَّد من تعديل التبعيات في مشروعك وفقًا لذلك. للحصول على معلومات تفصيلية حول وحدات حزمة SDK والإعدادات المضمّنة، يُرجى الرجوع إلى الاستهداف حسب الإمكانات.
استخدام Cocoapods
إذا كان تطبيقك يستخدم Cocoapods، تأكَّد من أنّ ملف Podfile الخاص بمشروعك يحتوي على أحد الخيارَين التاليَين:
pod 'FirebaseAnalytics' # includes GoogleAdsOnDeviceConversion
أو
pod 'FirebaseAnalytics/Core'
pod 'GoogleAdsOnDeviceConversion'
بعد ذلك، شغِّل الأمرَين pod repo update وpod install.
استخدام Swift Package Manager
إذا كان تطبيقك يستخدم Swift Package Manager، اتّبِع الخطوات الواردة في Swift Package Manager لخدمة Firebase.
عند الوصول إلى الخطوة "اختيار مكتبات Firebase التي تريد تضمينها في تطبيقك"، ضَع علامة في المربّع FirebaseAnalytics قبل المتابعة إلى الخطوات التالية.
يمكنك بدلاً من ذلك التحقّق من FirebaseAnalytics/Core و
GoogleAdsOnDeviceConversion.
عملية الدمج البديلة
إذا كان تطبيقك لا يستخدم Cocoapods أو Swift Package Manager، يمكنك الدمج باتّباع الخطوات التالية:
- نزِّل ملف zip العام الخاص بـ Firebase من مستودع firebase-ios-sdk على GitHub.
- اتّبِع تعليمات ملف README من ملف zip المتاح للجميع لإضافة الأُطر إلى المشروع مباشرةً. احرص على إضافة الأُطر من الدليل
FirebaseAnalytics. - في Xcode، أضِف العلامتَين
-ObjCو-lc++إلى إعدادات الرابط الأخرى (Other Linker Settings) في إعدادات الإصدار الخاصة بهدف تطبيقك.
Unity
أضِف حزمة تطوير البرامج (SDK) الخاصة بـ Firebase Unity (
FirebaseAnalytics.unitypackageتحديدًا) إلى مشروع Unity. يمكنك الاطّلاع على تعليمات أكثر تفصيلاً في مقالة إضافة حِزم تطوير البرامج (SDK) لبرنامج Firebase Unity.اختَر نظام التشغيل iOS من خلال ملف (File) > إعدادات الإنشاء (Build Settings)، ثم انقر على الإنشاء والتشغيل (Build and Run).
في مجلد الإصدار الذي تم إنشاؤه، ابحث عن ملف Podfile وأضِف ما يلي:
pod 'GoogleAdsOnDeviceConversion'
تفعيل وضع تصحيح الأخطاء
فعِّل وضع تصحيح الأخطاء من خلال إضافة -FIRDebugEnabled ضمن الوسيطات التي تم تمريرها عند التشغيل في محرِّر المخطط في Xcode. عند تشغيل التطبيق في Xcode، تأكَّد من ظهور رسالة مشابهة لما يلي في وحدة تصحيح أخطاء Xcode:
[Firebase/Analytics][I-ACS023007] Analytics v.x.x.x started
...
[Firebase/Analytics][I-ACS023009] Debug logging enabled
الخطوة 1: تنفيذ تجربة تسجيل الدخول الخطوة 3: بدء القياسات باستخدام Google Analytics