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

1- مقدمة

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

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

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

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

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

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

المتطلبات

• الإصدار 3.6 من "استوديو Android" أو إصدار أحدث
• حساب Firebase
• حساب إعلانات Google

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

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

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

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

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

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

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

3. اختَر حسابًا على "إحصاءات Google". إذا كان لديك حساب، اختَر هذا التنسيق أو أنشئ حسابًا جديدًا. انقر على الزر "إنشاء مشروع".

4. اكتملت الآن عملية إنشاء مشروع Firebase.

في الخطوة التالية، ستتعرَّف على كيفية إضافة Firebase إلى تطبيقك على Android.

3- إضافة Firebase إلى تطبيقك على Android

تسجيل التطبيق

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

2. املأ المعلومات الضرورية.

بالنسبة إلى اسم حزمة Android، انتقِل إلى دليل التطبيق في "استوديو Android" وافتح اسم ملف build.gradle. في الملف، ابحث عن "applicationId". هذه القيمة هي اسم حزمة Android. انسخ هذه القيمة والصقها.

لا نحتاج إلى مفتاح SHA-1 هنا، ما لم تكن تخطط لاستخدام تسجيل الدخول بحساب Google أو روابط Firebase الديناميكية (تجدر الإشارة إلى أن هذه الروابط ليست جزءًا من هذا الدرس التطبيقي حول الترميز، للحصول على مزيد من المعلومات حول مفتاح SHA-1، يُرجى الرجوع إلى هذا المستند).

ملاحظة: اطّلِع على مقالة ضبط رقم تعريف التطبيق للحصول على مزيد من المعلومات عن أرقام تعريف الحِزم والتطبيقات.

3. انقر على زر تسجيل التطبيق.

تنزيل ملف الإعداد

1. انقر على الزرّ تنزيل google-services.json لتنزيل ملف الإعداد google-services.json.

2. في "استوديو Android"، انتقِل إلى دليل app وانقل ملف google-services.json (الذي نزّلته للتو) إلى دليل app. للرجوع إلى "وحدة تحكُّم Firebase"، انقر على زر "التالي".

تفعيل Firebase في تطبيقك

1. يجب أن يكون لديك مكوّن إضافي لخدمات Google Gradle لقراءة ملف google-services.json الذي تم إنشاؤه من خلال Firebase.
2. في "استوديو Android"، افتح <project>/build.gradle، ثم أضِف الأسطر التالية في الملف:

buildscript { 
   repositories {
      // Check that you have the following line (if not, add it):
      google() //Google's Maven repository
   }
   dependencies {
      ...
      // Add this line
      classpath 'com.google.gms:google-services:4.3.4'
   }
}

allprojects {
   ...
   repositories {
      // Check that you have the following line (if not, add it):
      google() //Google's Maven repository
      ...
      }
   }
}

3. افتح <project>/<app-module>/build.gradle، ثم أضِف الأسطر التالية في الملف:

apply plugin: 'com.android.application'
// Add this line
apply plugin: 'com.google.gms.google-services'

لقد أكملت الآن إضافة Firebase إلى تطبيقك على Android.

في الخطوة التالية، ستتعرف على كيفية إضافة حزمة تطوير البرامج (SDK) لمنصّة Firebase إلى تطبيقك.

4. إضافة حزمة تطوير البرامج (SDK) لمنصّة Firebase إلى تطبيقك

وفي هذه الخطوة، عليك إضافة حزمة تطوير البرامج (SDK) لمنصّة Firebase، وتحديدًا حزمة تطوير البرامج (SDK) لمنصّة Firebase الخاصّة بخدمة "إحصاءات Google".

سنستخدم مستند BoM الخاص بـ Firebase والذي يمكّنك من إدارة إصدارات مكتبة Firebase التي تستخدمها في تطبيقك من خلال تحديد إصدار BoM. لمعرفة إصدارات مكتبة Firebase التي تم ربطها بإصدار معيّن من قائمة BoM، يمكنك الاطّلاع على ملاحظات الإصدار الخاصة بإصدار BoM هذا.

1. افتح <project>/<app-module>/build.gradle، ثم أضِف الأسطر التالية في الملف:

dependencies { 
   // ... 
   
   //Import the Firebase BoM
   implementation platform('com.google.firebase:firebase-bom:26.1.1')
   
   //Declare the dependency for the Firebase SDK for Google Analytics
   implementation 'com.google.firebase:firebase-analytics-ktx'

كما ترى، من خلال تحديد إصدار BoM فقط، لست بحاجة إلى تحديد إصدار مكتبة Firebase Analytics. ولكن إذا أردت استخدام النسخة المطلوبة لمكتبتك في Firebase بغض النظر عن الإصدار المخصص في قائمة العناصر، ما عليك سوى تحديد النسخة المطلوبة على النحو التالي:

dependencies { 
   // ... 
   
   //Import the Firebase BoM
   implementation platform('com.google.firebase:firebase-bom:26.1.1')
   
   //Declare the dependency for the Firebase SDK for Google Analytics
   implementation 'com.google.firebase:firebase-analytics-ktx:17.0.0'

2. يمكنك الآن مزامنة تطبيقك عن طريق النقر على زر Sync Now.

لقد أكملت الآن إضافة حزمة تطوير البرامج (SDK) لمنصّة Firebase الخاصة بخدمة "إحصاءات Google" إلى تطبيقك على Android.

في الخطوة التالية، ستتعرَّف على كيفية تسجيل أحداث Firebase في تطبيقك على Android.

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

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

تتوفّر طريقتان لتسجيل الأحداث، وهما: استخدام الأحداث المقترَحة أو الأحداث المخصَّصة.

استخدام الأحداث المقترَحة

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

1. تعريف كائن FirebaseAnalytics في أعلى النشاط:

private lateinit var firebaseAnalytics: FirebaseAnalytics

2. إعداد الكائن بطريقة onCreate():

firebaseAnalytics = Firebase.analytics

3. بدء تسجيل الأحداث باستخدام الطريقة logEvent() يسجِّل الرمز التالي حدث PURCHASE عندما يشتري أحد المستخدمين عنصرًا في التطبيق:

firebaseAnalytics.logEvent(FirebaseAnalytics.Event.PURCHASE) {
   param(FirebaseAnalytics.Param.VALUE, 10)
   param(FirebaseAnalytics.Param.CURRENCY, "USE")
}

استخدام الأحداث المخصّصة

إذا كنت بحاجة إلى أحداث لا تغطيها الأحداث المقترَحة، يمكنك تسجيل أحداثك المخصّصة باستخدام المَعلمات المخصَّصة:

firebaseAnalytics.logEvent("delete_item"){
   param("item name", name)
   param("reason", text)
}

أحداث تصحيح الأخطاء

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

لأغراض الاختبار وتصحيح الأخطاء على الفور، يمكنك استخدام Firebase Debugview. يتيح لك DebugView الاطّلاع على بيانات الأحداث التي سجّلها تطبيقك على أجهزة التطوير في الوقت الفعلي تقريبًا. بالنسبة إلى DebugView، يُرجى الرجوع إلى قسم حدث تصحيح الأخطاء.

لقد انتهيت الآن من تسجيل الأحداث في تطبيق Android.

وفي الخطوة التالية، ستتعرّف على كيفية استيراد هذه الأحداث إلى "إعلانات Google".

6- استيراد أحداث Firebase إلى "إعلانات Google"

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

الربط بين Firebase و"إعلانات Google"

1. انتقِل إلى "إعدادات Firebase" من خلال النقر على الزرّ بجانب "نظرة عامة على المشروع" مباشرةً.

2. في علامة التبويب "عمليات الدمج"، ستظهر لك "إعلانات Google" وزر "ربط". انقر فوق ارتباط ومتابعة.

3. اختَر حساب "إعلانات Google" الذي تريد ربطه.

لقد أكملت الآن ربط Firebase و"إعلانات Google". لنبدأ باستيراد أحداث Firebase إلى "إعلانات Google".

استيراد أحداث Firebase

1. في "وحدة تحكُّم Firebase"، انتقِل إلى قائمة "الأحداث" وضَع علامة على الحدث الذي تريد استيراده كإحالة ناجحة.

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

2. انتقِل الآن إلى "إعلانات Google" وسجِّل الدخول إلى الحساب الذي تربطه بمنصّة Firebase.
3. في "إعلانات Google"، انتقِل إلى الأدوات ← القياس ← الإحالات الناجحة .
4. انقر على الزر + .
5. اختَر التطبيق ← مواقع "إحصاءات Google 4" (Firebase)، ثم انقر على "متابعة".
6. يمكنك الاطّلاع على جميع أحداث الإحصاءات التي تمّ وضع علامة "إحالة ناجحة" عليها. ابحث عن الحدث الذي تريد استيراده. في هذه الحالة، اختَر حدث delete_item الذي سبق أن نفّذناه. انقر فوق الزر استيراد ومتابعة.
7. لقد استوردت حدث إحالة ناجحة من Firebase بنجاح.

لقد أكملت الآن استيراد أحداث Firebase إلى "إعلانات Google".

في الخطوة التالية، ستتعرّف على كيفية إطلاق حملة إجرائية تتضمّن الحدث الذي استوردته للتو.

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

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

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

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

4. تم ضبط باقي إعدادات الحملة وتم الانتهاء من ذلك.

8- تهانينا

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

لقد تعلمت

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