دليل تعليمي: قياس الإحالات الناجحة في إعلانات iOS باستخدام بيانات الأحداث

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

بعد ربط حسابك على "إعلانات Google"، يمكنك البدء في دمج Google Analytics لحزمة تطوير البرامج (SDK) لمنصة Firebase.

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

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

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

التحقّق من عملية الدمج

فعِّل وضع تصحيح الأخطاء من خلال إضافة -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

arrow_back_iosالخطوة 1 ربط حسابك على "إعلانات Google" بحساب Google Analytics الخطوة 3: تحديد المشاكل الشائعة وحلّهاarrow_forward_ios