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

1. مقدمة

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

ما ستنشئه

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

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

ما ستتعلمه

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

المتطلبات

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

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

أنشِئ تطبيقًا بسيطًا مستندًا إلى نموذج Unity. يمكنك تعديل هذا التطبيق البسيط لإنشاء التطبيق النهائي.

إطلاق Unity

  1. إذا لم يكن لديك مشاريع مفتوحة، اختَر إنشاء مشروع جديد.
  2. اختَر نماذج ثلاثية الأبعاد من مربّع الحوار.
  3. املأ حقل "اسم المشروع": مثلاً Unity Firebase Custom Event.
  4. اختَر مكانًا لحفظ مشروعك وانقر على "إنشاء".
  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، افتح مربّع الحوار "إعدادات الإنشاء" (Build Settings)، ملف (File) > إعدادات الإنشاء (Build Settings) (إذا لم يكن النظام الأساسي مضبوطًا على iOS، يمكنك اختيار نظام iOS الأساسي والنقر على الزر تبديل النظام الأساسي (Switch Platform))

8be5416883a70def.png

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

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

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

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

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

  1. في وحدة تحكّم Firebase، انقر على تنزيل Firebase Unity SDK، ثم فكّ ضغط الحزمة في مكان مناسب.
  1. في مشروع Unity المفتوح، انتقِل إلى الأصول (Assets) > استيراد حزمة (Import Package) > حزمة مخصّصة (Custom Package).
  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، انقر على المنتج (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"

اكتمل إعداد 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

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

ab35e341dff32e48.png

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

8. إطلاق "حملات تحثّ على اتّخاذ إجراء داخل التطبيق" باستخدام أحداث مستورَدة

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

af98c44d1476558.png

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

a1f145794f949109.png

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

9- تهانينا

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

لقد تعلّمت

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

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