الخطوة 2: دمج Google Analytics
| مقدّمة: قياس الإحالات الناجحة في "إعلانات iOS" |
| الخطوة 1: ربط حسابك على "إعلانات Google" بـ Google Analytics |
|
الخطوة 2: دمج Google Analytics |
| الخطوة 3: تحديد المشاكل الشائعة وحلّها |
بعد ربط حسابك على "إعلانات Google"، يمكنك البدء بدمج الـ Google Analytics لحزمة تطوير البرامج (SDK) لـ Firebase.
دمج Google Analytics لـ Firebase SDK
لاستخدام ميزة "قياس الإحالات الناجحة على الجهاز فقط باستخدام بيانات الأحداث" كما هو موضّح في هذا البرنامج التعليمي، عليك استخدام الإصدار 11.14.0 أو إصدار أعلى من Google Analytics لحزمة تطوير البرامج (SDK) لـ Firebase لمنصّات Apple. تأكَّد من تعديل تبعيات مشروعك وفقًا لذلك. للحصول على معلومات مفصّلة عن وحدات حزمة تطوير البرامج (SDK) والإعدادات المُضمّنة، يُرجى الرجوع إلى إمكانات الاستهداف.
استخدام Cocoapods
إذا كان تطبيقك يستخدم Cocoapods، تأكَّد من أنّ ملف Podfile الخاص بمشروعك يتضمّن وحدة GoogleAppAdsOnDeviceConversion، إما من خلال وحدة FirebaseAnalytics الرئيسية أو من خلال تضمينها بشكلٍ صريح كوحدة مستقلة:
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++إلى إعدادات الرابط الأخرى في إعدادات الإصدار لهدف تطبيقك.
التأكّد من التكامل
فعِّل وضع تصحيح الأخطاء من خلال إضافة -FIRDebugEnabled ضمن الوسيطات التي تم تمريرها عند التشغيل في محرّر المخطط في Xcode.
احذف التطبيق في المحاكي أو الجهاز. عند تشغيل التطبيق في Xcode، تأكَّد من ظهور رسالة مشابهة للرسالة التالية في وحدة تصحيح الأخطاء في Xcode:
[Firebase/Analytics][I-ACS023007] Analytics v.X.X.X started
...
[Firebase/Analytics][I-ACS023009] Debug logging enabled
...
[FirebaseAnalytics][I-ACS023278] Conversion service GoogleAdsOnDeviceConversion framework is linked
انتظِر حوالي 15 ثانية وتأكَّد من ظهور الرسالة _psmvalue_gads في وحدة تصحيح الأخطاء في Xcode:
[FirebaseAnalytics][I-ACS023087] User property set. Name, value: _psmvalue_gads, XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
الخطوة 1 ربط حسابك على "إعلانات Google" بخدمة "Google Analytics الخطوة 3: تحديد المشاكل الشائعة وحلّها