برنامج تعليمي: قياس الإحالات الناجحة في "إعلانات iOS"

الخطوة 2: دمج Google Analytics

بعد تنفيذ نظام مصادقة لجمع عناوين البريد الإلكتروني أو أرقام الهواتف الخاصة بالمستخدمين، يمكنك البدء في دمج Google Analytics لحزمة تطوير البرامج (SDK) الخاصة بمنصة Firebase.

دمج حزمة تطوير البرامج (SDK) الخاصة بـ Google Analytics لبرنامج Firebase

لاستخدام ميزة "قياس الإحالات الناجحة على الجهاز فقط" مع بيانات الطرف الأول كما هو موضّح في هذا البرنامج التعليمي، يجب استخدام الإصدار 11.14.0 أو إصدار أحدث من Google Analytics لحزمة تطوير البرامج (SDK) لمنصات Apple في Firebase. تأكَّد من تعديل تبعيات مشروعك وفقًا لذلك. عند تنفيذ ميزة قياس الإحالات الناجحة على الجهاز (ODM) باستخدام حزمة تطوير البرامج (SDK) Google Analytics لمنصات Apple، احرص على استخدام إصدارات حزمة تطوير البرامج (SDK) المتوافقة والمدرَجة على GitHub. للحصول على معلومات تفصيلية حول وحدات حزمة 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، يمكنك الدمج باتّباع الخطوات التالية:

1. نزِّل ملف zip العام الخاص بـ Firebase من مستودع firebase-ios-sdk على GitHub.
2. اتّبِع تعليمات ملف README من ملف zip المتاح للجميع لإضافة الأُطر إلى المشروع مباشرةً. احرص على إضافة الأُطر من الدليل FirebaseAnalytics.
3. في Xcode، أضِف العلامتَين -ObjC و-lc++ إلى إعدادات الرابط الأخرى (Other Linker Settings) في إعدادات إنشاء هدف تطبيقك.

Unity

1. أضِف حزمة تطوير البرامج (SDK) الخاصة بـ Firebase Unity (FirebaseAnalytics.unitypackage تحديدًا) إلى مشروع Unity. يمكنك الاطّلاع على تعليمات أكثر تفصيلاً في مقالة إضافة حِزم Firebase Unity SDK.

2. اختَر نظام التشغيل iOS في ملف (File) > إعدادات الإنشاء (Build Settings)، ثم انقر على الإنشاء والتشغيل (Build and Run).

3. في مجلد الإصدار الذي تم إنشاؤه، ابحث عن ملف Podfile وأضِف ما يلي:

   pod 'GoogleAdsOnDeviceConversion'
   

تفعيل وضع تصحيح الأخطاء

فعِّل وضع تصحيح الأخطاء من خلال إضافة -FIRDebugEnabled ضمن الوسيطات التي تم تمريرها عند التشغيل في محرّر المخطط في Xcode. عند تشغيل التطبيق في Xcode، تأكَّد من ظهور رسالة مشابهة لما يلي في وحدة تصحيح أخطاء Xcode:

[Firebase/Analytics][I-ACS023007] Analytics v.x.x.x started
...
[Firebase/Analytics][I-ACS023009] Debug logging enabled

arrow_back_iosالخطوة 1: تنفيذ تجربة تسجيل الدخول الخطوة 3: بدء القياسات باستخدام Google Analyticsarrow_forward_ios