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

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

لمحة عن هذا الدرس التطبيقي حول الترميز

subjectتاريخ التعديل الأخير: يوليو 29, 2021
account_circleتأليف: Hyemin Kim

1. مقدمة

تاريخ آخر تعديل: 14‏ كانون الأول (ديسمبر) 2020

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

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

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

  • كيفية إعداد "إحصاءات Google لبرنامج Firebase" في 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، حدد تطبيق المستوى الأعلى في متصفح المشروع، ثم حدد علامة التبويب "General" (عام).
  3. قيمة حقل Bundle Identifier هي معرّف حزمة 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، اختَر المنتج > المخطط > تعديل المخطط...
  2. اختَر تشغيل من القائمة اليمنى.
  3. اختَر علامة التبويب الوسيطات.
  4. في قسم Arguments Passed On Launch، أضِف -FIRAnalyticsDebugEnabled.

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

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

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

286b640ed4646163.png

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

a933a338990cba3a.png

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

7. استيراد أحداث الإحصاءات في "إعلانات 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. يمكنك الاطّلاع على جميع أحداث الإحصاءات التي تم وضع علامة عليها كإحالات ناجحة. ابحث عن حدث 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"
  • كيفية استيراد الأحداث واستخدامها للحملات الإجرائية