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

1. مقدمة

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

ما الذي ستنشئه

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

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

المعلومات التي ستطّلع عليها

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

المتطلبات

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

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

يمكنك إنشاء تطبيق iOS Swift بسيط وفقًا لنموذج. يمكنك تعديل تطبيق إجراء التفعيل هذا لإنشاء التطبيق النهائي.

أولاً، قم بتشغيل Xcode.

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

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

2. الفريق: إذا لم يتم ملء هذا الحقل تلقائيًا، يُرجى تعيين الفريق على "بدون".
3. اسم المؤسسة: اسم مؤسستك أو اسمك.
4. معرّف الحزمة: يتم إنشاء هذه القيمة تلقائيًا استنادًا إلى اسم المنتج ومعرّف المؤسسة.
5. اللغة: سويفت
6. حدد موقعًا لحفظ مشروعك وانقر على "Create" (إنشاء).
7. يفتح Xcode مشروعك الجديد في نافذة مساحة العمل.

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

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

إنشاء مشروع على Firebase

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

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

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

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

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

4. إعدادات Firebase

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

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

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

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

5- ضبط "إحصاءات Firebase" في Xcode

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

ملاحظة: تستخدم خدمات Google CocoaPods لتثبيت الموارد التابعة وإدارتها. إذا لم يسبق لك استخدام CocoaPods، عليك أولاً تثبيته من خلال تنفيذ الأمر التالي في الوحدة الطرفية:

$ sudo gem install cocoapods

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

$ pod init

3. افتح Podfile وأضِف :

$ vi Podfile

$ pod 'Firebase/Analytics'

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

$ pod install

5. إضافة رمز إعداد :

لربط 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
  }
}

6. اكتملت عملية الإعداد. يُرجى المتابعة إلى وحدة التحكّم.

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

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

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

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

أحداث السجلّ

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

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

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

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

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

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

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

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

1. في Xcode، اختَر المنتج >. المخطط > تعديل المخطّط...
2. اختَر تشغيل من القائمة اليمنى.
3. اختَر علامة التبويب الوسيطات.
4. في قسم Arguments Passed On Launch، أضِف -FIRAnalyticsDebugEnabled.

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

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

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

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

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

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

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

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

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

تنبيه: إذا لم يتم وضع علامة "إحالة ناجحة" على الحدث المستهدَف، لن تتمكّن "إعلانات Google" من استيراده. تأكَّد من أنّ الحدث قد تم تصنيفه بشكلٍ سليم على أنّه إحالة ناجحة.

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

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

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

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

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

5. تحقق وانقر فوق الزر استيراد ومتابعة.

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

8. إطلاق حملات التطبيقات الإجرائية مع الأحداث التي تم استيرادها

ملاحظة مُهمّة: لإطلاق حملة تطبيقات، تحتاج إلى تطبيق على مستوى الإنتاج في Google Play. إذا لم تكن مستعدًا لنشر التطبيق، اترك هذه الخطوة الآن.

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

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

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

9. تهانينا

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

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

لقد تعلمت

• كيفية ضبط Firebase لنظام التشغيل iOS
• كيفية تسجيل الأحداث المخصّصة باستخدام "إحصاءات Firebase" وiOS
• كيفية استيراد الأحداث واستخدامها للحملات الإجرائية