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

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


مقدّمة: قياس الإحالات الناجحة على "إعلانات iOS"
الخطوة 1: تنفيذ تجربة تسجيل الدخول

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

الخطوة 3: بدء قياس الإحالات الناجحة على الجهاز فقط باستخدام Google Analytics
الخطوة 4: تحديد المشاكل الشائعة وحلّها


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

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

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

Unity

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

  2. اختر منصّة iOS في ملف > إعدادات الإصدار، ثمّ انقر على الإصدار والتشغيل.

  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



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