"إعلانات Google" مع الأحداث المخصّصة في "إحصاءات Google لبرنامج Firebase" - نظام التشغيل iOS

1- مقدمة

آخر تعديل: 2020-12-14

ما ستنشئونه

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

من خلال هذا الدرس التطبيقي حول الترميز، يمكنكم تجربة العملية الكاملة لنشاط التطبيق التجاري التي يواجهها عملاؤنا. إذا أردتم التعرّف على مقدمة أبسط عن Firebase على أجهزة iOS، ابدأوا بـ الدرس التطبيقي حول الترميز بشأن استخدام Firebase على iOS بلغة Swift

ما ستتعرّفون عليه

  • كيفية تهيئة "إحصاءات Google لبرنامج Firebase"‏ (GA4F) في iOS Swift
  • كيفية إنشاء الأحداث والمعلّمات المخصّصة
  • كيفية استيراد الأحداث من Firebase إلى "إعلانات Google"
  • إطلاق "حملات الأداء" باستخدام الأحداث المخصّصة

ما تحتاجون إليه

  • Xcode
  • حساب على Firebase
  • حساب "إعلانات Google"

2. بدء مشروع جديد على iOS Swift

أنشئوا تطبيقًا بسيطًا على iOS Swift باستخدام نموذج. ستعدّلون هذا التطبيق الأولي لإنشاء التطبيق النهائي.

أولاً، شغِّلوا Xcode.

  1. إذا لم تكن لديكم مشاريع مفتوحة، اختاروا إنشاء مشروع جديد على Xcode من صفحة الترحيب.
  2. اختاروا iOS في أعلى مربّع الحوار.
  3. في قسم "التطبيق"، اختاروا التطبيق ثم انقروا على التالي.
  4. في مربّع الحوار الذي يظهر، استخدموا القيم التالية لتسمية تطبيقكم واختاروا خيارات إضافية لمشروعكم، ثم انقروا على التالي :
  5. اسم المنتج: مثلاً ios-app

يستخدم Xcode اسم المنتج الذي أدخلتموه لتسمية مشروعكم وتطبيقكم.

  1. الفريق: إذا لم يتم ملء هذا الحقل تلقائيًا، اضبطوا الفريق على بلا فريق.
  2. اسم المؤسسة: اسم مؤسستكم أو اسمكم
  3. رقم تعريف الحزمة: يتم إنشاء هذه القيمة تلقائيًا استنادًا إلى اسم المنتج ورقم تعريف المؤسسة.
  4. اللغة: Swift
  5. اختاروا موقعًا لحفظ مشروعكم وانقروا على إنشاء.
  6. يفتح Xcode مشروعكم الجديد في نافذة مساحة العمل.

3- إنشاء مشروع Firebase وإعداده

لبدء استخدام Firebase، عليكم إنشاء مشروع على Firebase وإعداده.

إنشاء مشروع Firebase

إذا كان لديكم مشروع Firebase حالي لم يتم تفعيل "إحصاءات Google" فيه، يمكنكم تفعيل "إحصاءات Google" من علامة التبويب عمليات الدمج ضمن إعداداتكم > إعدادات المشروع. انتقِلوا إلى خطوة إعداد Firebase.

  1. سجّلوا الدخول إلى Firebase.

في وحدة تحكّم Firebase، انقروا على إضافة مشروع(أو إنشاء مشروع)، وسمّوا مشروعكم على Firebase‏ Firebase-iOS-Ads

9b0ae97cc3c6f1d0.png

  1. انقروا على خيارات إنشاء المشروع. اقبلوا بنود Firebase إذا طُلب منكم ذلك. يجب تفعيل "إحصاءات Google" لهذا المشروع، لأنّكم تحتاجون إلى أحداث "إحصاءات Google" لتتبُّع أحداث الأداء والإحالات الناجحة.

e58151a081f0628.png

لمزيد من المعلومات عن مشاريع Firebase، اطّلِعوا على مقالة التعرّف على مشاريع Firebase.

4. إعداد Firebase

  1. في وحدة تحكّم Firebase، اختاروا نظرة عامة على المشروع > إعدادات المشروع في شريط التنقّل الأيمن، ثم انقروا على الزر iOS ضِمن عام > تطبيقاتك

سيظهر لكم مربّع الحوار الموضّح في الشاشة التالية.

425bb1c07921e71d.png

  1. القيمة المهمة التي يجب تقديمها هي رقم تعريف حزمة iOS، والتي ستحصلون عليها باستخدام الخطوة التالية.
  2. في مشروع Xcode لتطبيق iOS، اختاروا التطبيق ذي المستوى الأعلى في أداة التنقّل في المشروع، ثم اختاروا علامة التبويب عام.
  3. قيمة حقل "رقم تعريف الحزمة" هي رقم تعريف حزمة iOS (مثل com.yourcompany.yourproject). انسخوا هذه القيمة.
  4. في مربّع حوار Firebase، ألصقوا رقم تعريف الحزمة المنسوخ في حقل iOS bundle ID.
  5. انقروا على تسجيل التطبيق.
  6. تابعوا في Firebase، واتّبعوا التعليمات لتنزيل ملف الإعداد GoogleService-Info.plist

26e5b98711c2787a.png

  1. انتقِلوا إلى مشروع Xcode، ثم انقلوا ملف GoogleService-Info.plist (الذي نزّلتموه للتو) إلى جذر مشروع Xcode.
  2. تخطّوا الخطوات المتبقية وارجعوا إلى الصفحة الرئيسية لوحدة تحكّم Firebase.

5. إعداد "إحصاءات Firebase" في Xcode

في هذه الخطوة، ستبدأون إضافة حزمة تطوير البرامج (SDK) لمنصة Firebase إلى مشروع Xcode.

  1. افتحوا نافذة أوامر طرفية وانتقِلوا إلى موقع مشروع Xcode لتطبيقكم.
  2. أنشئوا Podfile في حال عدم وجود واحد:

$ pod init

  1. افتحوا Podfile وأضيفوا :

$ vi Podfile

$ pod 'Firebase/Analytics' 54204c9ce2a49666.png

  1. احفظوا الملف وشغِّلوا :

$ pod install

  1. أضيفوا رمز التهيئة :

لربط Firebase عند بدء تشغيل تطبيقكم، أضيفوا رمز الإعداد التالي إلى فئة AppDelegate الرئيسية.

import UIKit
import Firebase

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

  var window: UIWindow?

  func application(_ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions:
      [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
    FirebaseApp.configure()
    return true
  }
}
  1. إذًا أنتم على أتمّ استعداد. تابعوا إلى وحدة التحكّم.

أنتم الآن جاهزون لتسجيل بعض سجلّات الأحداث المخصّصة.

6. تسجيل الأحداث المخصّصة باستخدام "إحصاءات Firebase"

في هذه الخطوة، ستتعرّفون على كيفية تسجيل الأحداث المخصّصة باستخدام "إحصاءات Firebase" في تطبيق iOS.

تسجِّل "إحصاءات Firebase" تلقائيًا بعض الأحداث، وليس عليكم إضافة أي رمز لتلقّيها. إذا كان تطبيقكم بحاجة إلى جمع بيانات إضافية، يمكنكم تسجيل ما يصل إلى 500 نوع مختلف من الأحداث المخصّصة في "إحصاءات Google".

أحداث السجلّ

بعد إعداد مثيل FirebaseApp، يمكنكم البدء في تسجيل الأحداث باستخدام طريقة logEvent().

Analytics.logEvent("text_search", parameters: [
  "name": name as NSObject,
  "full_text": text as NSObject
  ])

ضبط مَعلمات الأحداث التلقائية

يمكنكم تسجيل المَعلمات في جميع الأحداث باستخدام setDefaultEventParameters. ترتبط المَعلمات التلقائية بجميع الأحداث المستقبلية التي يتم تسجيلها.

Analytics.setDefaultEventParameters([
  "level_name": "Caverns01",
  "level_difficulty": 4
])

عرض الأحداث في وحدة تحكّم تصحيح الأخطاء في Xcode

يمكنكم تفعيل التسجيل المطوَّل لمراقبة تسجيل الأحداث من خلال حزمة تطوير البرامج (SDK) للمساعدة في التأكّد من تسجيل الأحداث بشكلٍ صحيح. ويشمل ذلك الأحداث التي يتم تسجيلها تلقائيًا ويدويًا.

يمكنكم تفعيل التسجيل المطوَّل على النحو التالي:

  1. في Xcode، انقروا على المنتج (Product) > المخطّط (Scheme) > تعديل المخطّط… (Edit scheme…‎)
  2. انقر على تشغيل (Run) من القائمة اليمنى.
  3. انقروا على علامة التبويب الوسيطات (Arguments).
  4. في قسم المَعلمات التي تم ضبطها عند الإطلاق (Arguments Passed On Launch) ، أضيفوا ‎-FIRAnalyticsDebugEnabled.

في المرة التالية التي تشغّلون فيها تطبيقكم، ستظهر أحداثكم في وحدة تحكّم تصحيح الأخطاء في Xcode، ما يساعدكم في التأكّد فورًا من إرسال الأحداث.

عرض الأحداث في لوحة البيانات

سيظهر الحدث الذي سجّلتموه في وحدة تحكّم Firebase خلال بضع ساعات. يقع الحدث في "إحصاءات Google" ← الأحداث. يمكنكم أيضًا العثور على قيم المَعلمات من خلال النقر على الحدث.

286b640ed4646163.png

ستضعون علامة على "text_search" كإحالة ناجحة من خلال تحريك مفتاح "وضع علامة كإحالة ناجحة" إلى اليسار.

a933a338990cba3a.png

يمكنكم التأكّد مما إذا تم وضع علامة على الحدث بنجاح كإحالة ناجحة من خلال علامة التبويب "الإحالات الناجحة" في "إحصاءات Firebase". من خلال وضع علامة على الحدث كإحالة ناجحة، سيتمكّن "إعلانات Google" أيضًا من استيراد الحدث كإحالة ناجحة.

7. استيراد أحداث "إحصاءات Google" في "إعلانات Google"

اكتمل إعداد Firebase على أجهزة iOS، وأنتم جاهزون لإطلاق "حملة التطبيقات" باستخدام أحداث الأداء المسجَّلة. ستبدأون بربط Firebase بـ "إعلانات Google". من خلال ربط Firebase بـ "إعلانات Google"، ستتمكّن "حملات التطبيقات" من معرفة المزيد عن شرائح الجمهور وتعزيز المعلومات التي يتم جمعها في "حملات التطبيقات"، ما يؤدي عادةً إلى تحسين الأداء والإحالات الناجحة.

  1. انتقِلوا إلى إعدادات Firebase من خلال النقر على الزر بجانب "نظرة عامة على المشروع".
  2. في علامة التبويب عمليات الدمج، سيظهر لكم "إعلانات Google" وزر الربط. انقروا على الربط والمتابعة.

b711bf2e94fa0895.png

  1. اختاروا حسابًا على "إعلانات Google".

اكتمل الآن جزء Firebase.

انتقِلوا الآن إلى "إعلانات Google" وسجِّلوا الدخول.

  1. انتقِلوا إلى "إعلانات Google" وسجِّلوا الدخول، ثم انتقِلوا إلى الأدوات والإعدادات ← القياس ← الإحالات الناجحة لاستيراد الأحداث المخصّصة كإحالات ناجحة.
  2. انقروا على الزر + لإضافة إجراء إحالة ناجحة جديد.

73cec8d2e80eab03.png

  1. اختاروا مواقع "إحصاءات Google‏ 4" (Firebase) وانقروا على متابعة.

4b1d8f6a712b2ac6.png

  1. يمكنكم الاطّلاع على جميع أحداث "إحصاءات Google" التي تم وضع علامة عليها كإحالات ناجحة. ابحثوا عن حدث clicked_counter الذي نفّذناه سابقًا.

ba1bbe6b2924fac8.png 2b9abde9fb95d188.png

  1. ضَعوا علامة في المربّع وانقروا على الزر استيراد ومتابعة.

ab35e341dff32e48.png

بعد ضبط text_search كإجراء إحالة ناجحة، حان الوقت لإطلاق حملة تستهدف المستخدِمين الذين من المرجّح أن يسجّلوا أحداث text_search.

8. إطلاق "حملات التطبيقات" باستخدام الأحداث المستورَدة

  1. انتقِلوا إلى علامة التبويب "الحملات" في حسابكم الحالي، وابدأوا حملة جديدة من خلال النقر على الزر +. انقروا على الحملة الجديدة وتابعوا.
  2. في هذه المرة، سنطلق "حملة ترويج التطبيقات" باستخدام خيار "عمليات تثبيت التطبيق".

af98c44d1476558.png

  1. ابحثوا عن تطبيقكم من خلال تقديم اسم التطبيق أو اسم الحزمة أو الناشر.
  2. في قسم عروض الأسعار، اختاروا الإجراءات داخل التطبيق في القائمة المنسدلة لكي تركّز الإعلانات على الإجراءات.
  3. يمكنكم العثور على أحداثكم المخصّصة في القائمة المقدَّمة. اضبطوا سقف التكلفة المحدد لكل إجراء، واملأوا الخيارات الأخرى أيضًا.

a1f145794f949109.png 3dc838d7f4eeeba5.png

  1. اضبطوا إعدادات الحملة. سيكون ذلك خارج نطاق الدرس التطبيقي حول الترميز، لذا يُرجى الرجوع إلى هذه المستندات أو التواصل من خلال أي قنوات أخرى لتحسين الإعدادات.

9- تهانينا

تهانينا، لقد نجحتم في دمج Firebase و"إعلانات Google". سيساعدكم ذلك في تعزيز أداء حملتكم.

لقد ثبّتم النص البرمجي وأنشأتم قائمة تغييرات جديدة للدرس التطبيقي حول الترميز وجهّزتموها، وعدّلتم قائمة تغييرات الدرس التطبيقي حول الترميز المعلقة وجهّزتموها، وراجعتُم قائمة تغييرات الدرس التطبيقي حول الترميز ووافقتم عليها، وأرسلتم قائمة تغييرات الدرس التطبيقي حول الترميز ونشرتموها.

ما تعلّمتموه

  • كيفية إعداد Firebase على أجهزة iOS
  • كيفية تسجيل الأحداث المخصّصة باستخدام iOS و"إحصاءات Firebase"
  • كيفية استيراد الأحداث واستخدامها في "حملات الأداء"