"إعلانات Google" مع الأحداث المخصّصة من "إحصاءات Google لبرنامج Firebase" - Unity

1. مقدمة

تاريخ آخر تعديل: 19/02/2021

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

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

خلال هذا الدرس التطبيقي حول الترميز، يمكنك تجربة كل مراحل النشاط التجاري للتطبيقات التي يواجهها عملاؤنا. للاطّلاع على مقدمة أبسط عن Firebase وAdMob على iOS، ابدأ بمنصة AdMob 101 Unity: الإعداد أساسيات "إحصاءات Google":

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

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

المتطلبات

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

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

يمكنك إنشاء تطبيق Unity بسيط. يمكنك تعديل هذا التطبيق البسيط لإنشاء التطبيق النهائي.

إطلاق Unity

  1. إذا لم يكن لديك مشاريع مفتوحة، اختَر "إنشاء مشروع جديد".
  2. اختَر النماذج الثلاثية الأبعاد من مربع الحوار.
  3. املأ اسم المشروع: على سبيل المثال حدث Unity Firebase المخصّص.
  4. حدد موقعًا لحفظ مشروعك وانقر على "CREATE" (إنشاء).
  5. يفتح Unity مشروعك الجديد في نافذة مساحة العمل.

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

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

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

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

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

d9519856fc3b4bd0.png

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

e58151a081f0628.png

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

4. إعدادات Unity

  1. في الوحدة > ملف > إنشاء الإعدادات. ما عليك سوى تحديد معرّف حزمة iOS الذي ستحصل عليه في الخطوة التالية.

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

7dbfc36bef1d035c.png

  1. في مشروع Unity لتطبيق iOS، افتح مربّع الحوار Build Settings (إعدادات إنشاء الملفات)، انقر على File (ملف) > (File) > إعدادات الإصدار (إذا لم يتم ضبط النظام الأساسي على iOS، يمكنك اختيار "نظام iOS الأساسي" ثم النقر على الزر تبديل النظام الأساسي)

8be5416883a70def.png

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

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

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

  1. انتقِل إلى وحدة تحكُّم Firebase.
  2. في منتصف صفحة النظرة العامة على المشروع، انقر على رمز Unity ( 8c8fc0e0e05dc749.png) لبدء سير عمل الإعداد. إذا سبق لك إضافة تطبيق إلى مشروع Firebase، انقر على إضافة تطبيق لعرض خيارات النظام الأساسي.
  3. اختَر التصميم المستهدَف لمشروع Unity الذي تريد تسجيله، أو يمكنك اختيار تسجيل كلا الهدفَين الآن في الوقت نفسه.
  1. أدخِل أرقام التعريف الخاصة بالمنصّة الخاصة بمشروع Unity.
  • لنظام التشغيل iOS: أدخِل رقم تعريف iOS لمشروع Unity في الحقل رقم تعريف حزمة iOS.
  • لنظام التشغيل Android: أدخِل معرّف Android لمشروع Unity في حقل اسم حزمة Android. غالبًا ما يتم استخدام المصطلحين اسم الحزمة ومعرّف التطبيق بالتبادل.
  1. أين يمكنك العثور على رقم تعريف مشروع Unity؟
  1. (اختياري) أدخِل الأسماء المستعارة الخاصة بمنصة مشروع Unity. هذه الألقاب هي معرّفات داخلية ومعرّفات ملائمة ولا تظهر إلا لك في "وحدة تحكُّم Firebase".
  2. انقر على تسجيل التطبيق.

إضافة حِزم تطوير البرامج (SDK) الخاصة بـ Unity في "إحصاءات Firebase"

  1. في وحدة تحكُّم Firebase، انقر على تنزيل حزمة تطوير البرامج (SDK) لمنصة Firebase Unity، ثمّ فُكّ ضغط حزمة SDK في مكان مناسب.
  1. في مشروع Unity المفتوح، انتقِل إلى Assets > استيراد حزمة > الحزمة المخصّصة:
  2. من حزمة SDK غير المضغوطة، اختَر منتجات Firebase المتوافقة التي تريد استخدامها في تطبيقك.
  • إضافة حزمة Firebase لبرنامج "إحصاءات Google" : FirebaseAnalytics.unitypackage
  • أضِف الحِزم لأي منتجات أخرى من Firebase تريد استخدامها في تطبيقك. على سبيل المثال، لاستخدام مصادقة Firebase وقاعدة بيانات Firebase في الوقت الفعلي: FirebaseAuth.unitypackage وFirebaseDatabase.unitypackage
  1. في نافذة استيراد حزمة Unity، انقر على استيراد.
  2. في "وحدة تحكُّم Firebase"، انقر على التالي في سير عمل الإعداد.

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

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

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

أحداث السجلّ

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

Firebase.Analytics.FirebaseAnalytics.LogEvent("text_search", name, text);

عرض الأحداث في وحدة تحكم تصحيح الأخطاء في 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

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

ab35e341dff32e48.png

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

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

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

af98c44d1476558.png

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

a1f145794f949109.png

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

9. تهانينا

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

لقد تعلمت

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

المستندات المرجعية