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

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

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

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

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