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

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


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

الخطوة 1: ربط حسابك على "إعلانات Google" بحساب Google Analytics

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

الخطوة 3: تحديد المشاكل الشائعة وحلّها


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

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

أجرِ عملية الدمج مع أحدث إصدار من حزمة تطوير البرامج (SDK) لمنصّة Google Analytics.

استخدام Cocoapods

إذا كان تطبيقك يستخدم Cocoapods، تأكَّد من أنّ ملف Podfile الخاص بمشروعك يحتوي على حِزمة GoogleAppAdsOnDeviceConversion، إما من خلال حِزمة FirebaseAnalytics الرئيسية أو عن طريق تضمينها صراحةً كحِزمة مستقلة:

pod 'FirebaseAnalytics' # includes GoogleAdsOnDeviceConversion

أو

pod 'FirebaseAnalytics/Core'
pod 'GoogleAdsOnDeviceConversion'

بعد ذلك، نفِّذ الأمرَين pod repo update وpod install.

استخدام أداة إدارة حِزم Swift

إذا كان تطبيقك يستخدم Swift Package Manager، اتّبِع الخطوات الواردة في مقالة Swift Package Manager لـ Firebase. عند الوصول إلى الخطوة "اختيار مكتبات Firebase التي تريد تضمينها في تطبيقك"، ضَع علامة في المربّع FirebaseAnalytics قبل المتابعة إلى الخطوات التالية. بدلاً من ذلك، يمكنك التحقق من FirebaseAnalytics/Core و GoogleAdsOnDeviceConversion.

الدمج البديل

إذا كان تطبيقك لا يستخدم Cocoapods أو Swift Package Manager، يمكنك دمج الرمز على النحو التالي:

  1. نزِّل ملف zip العلني لمنصّة Firebase من مستودع GitHub الخاص بحزمة firebase-ios-sdk.
  2. اتّبِع تعليمات README من ملف zip العلني لإضافة الإطارات المرجعية إلى المشروع مباشرةً. احرص على إضافة الإطارات من ملف FirebaseAnalyticsdirectory.
  3. في 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: تحديد المشاكل الشائعة وحلّها