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

1. مقدمة

تاريخ آخر تعديل: 19‏ شباط (فبراير) 2021

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

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

خلال هذا الدليل التعليمي حول الرموز البرمجية، يمكنك التعرّف على العملية الكاملة لنشاط التطبيقات التجاري التي يواجهها عملائنا. إذا كنت تريد الحصول على مقدمة أكثر سهولة حول Firebase وAdMob على نظام التشغيل iOS، ابدأ بقراءة مقالة AdMob+Firebase 101 Unity: Setup & Analytics Basics (أساسيات إعداد وتحليل AdMob وFirebase).

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

  • كيفية إعداد "إحصاءات Google لبرنامج Firebase" في 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. في Unity > الملف > إعدادات الإصدار. ما عليك سوى تحديد معرّف حزمة iOS الذي ستحصل عليه في الخطوة التالية.

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

7dbfc36bef1d035c.png

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

8be5416883a70def.png

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

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