إعلانات Google مع أحداث Google Analytics for Firebase المخصصة - Android

1 المقدمة

آخر تحديث: 2020-12-14

ماذا ستبني

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

يركز مختبر الترميز هذا على تنفيذ الأحداث باستخدام GA4F واستيراد الأحداث في إعلانات Google. إذا كنت تريد معرفة كيفية إنشاء تطبيق android باستخدام Firebase ، فيرجى الرجوع إلى Firebase Android Codelab-Build Friendly Chat .

ماذا ستتعلم

  • كيفية إنشاء مشروع Firebase
  • كيفية تنفيذ Firebase SDK في تطبيق Android
  • كيفية إنشاء الأحداث والمعلمات.
  • كيفية استيراد الأحداث من Firebase إلى إعلانات Google
  • إطلاق حملات إعلانات Google مع أحداث مخصصة.

ماذا ستحتاج

  • Android Studio 3.6 أو أعلى
  • حساب Firebase
  • حساب إعلانات Google

2. إنشاء مشروع Firebase وإعداده

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

أنشئ مشروع Firebase

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

في وحدة تحكم Firebase ، انقر على إضافة مشروع (أو إنشاء مشروع) ، وقم بتسمية مشروع Firebase كما تريد.

8525e77df3536fbb.png

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

e58151a081f0628.png

لمعرفة المزيد حول مشاريع Firebase ، راجع فهم مشاريع Firebase .

  1. اختر حساب Google Analytics. إذا كان لديك واحد ، فاختر ذلك أو أنشئ واحدًا جديدًا. انقر فوق زر إنشاء مشروع.

ac928e5947ba7cbf.png

  1. الآن انتهى بناء مشروع Firebase!

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

3. أضف Firebase إلى تطبيق Android

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

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

6cbb33ad3e7c9132.png

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

3b7d3b33d81fe8ea.png

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

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

  1. انقر فوق زر تسجيل التطبيق.

قم بتنزيل ملف التكوين

  1. انقر فوق الزر تنزيل google-services.json لتنزيل ملف التكوين google-services.json .

52f08aa18c8d59d0.png

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

قم بتمكين Firebase في تطبيقك

  1. أنت بحاجة إلى المكوّن الإضافي Google Services Gradle لقراءة ملف google-services.json الذي تم إنشاؤه بواسطة Firebase.
  2. في Android studio ، افتح <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
      ...
      }
   }
}
  1. افتح <project>/<app-module>/build.gradle ، ثم أضف الأسطر التالية في الملف:
apply plugin: 'com.android.application'
// Add this line
apply plugin: 'com.google.gms.google-services'

الآن ، لقد أكملت إضافة Firebase إلى تطبيق Android الخاص بك!

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

4. أضف Firebase SDK إلى تطبيقك

في هذه الخطوة ، ستضيف Firebase SDK ، وتحديداً Firebase SDK لبرنامج Google Analytics.

سنستخدم Firebase Android BoM الذي يمكّنك من إدارة إصدارات مكتبة 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. ولكن إذا كنت تريد استخدام الإصدار المطلوب لمكتبة Firebase الخاصة بك بغض النظر عن الإصدار المعين في BoM ، فأنت تحتاج فقط إلى تحديد الإصدار المطلوب مثل هذا:

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'
  1. الآن قم بمزامنة تطبيقك بالنقر فوق الزر Sync Now . 937206076c88ae5c.png

الآن ، لقد أكملت إضافة Firebase SDK لـ Google Analytics إلى تطبيق Android الخاص بك!

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

5. سجل الأحداث باستخدام Firebase Analytics

في هذه الخطوة ، ستتعلم كيفية تسجيل الأحداث باستخدام Firebase Analytics في تطبيق Android.

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

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

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

  1. قم بتعريف كائن FirebaseAnalytics أعلى النشاط:
private lateinit var firebaseAnalytics: FirebaseAnalytics
  1. قم بتهيئة الكائن في طريقة onCreate() :
firebaseAnalytics = Firebase.analytics
  1. ابدأ تسجيل الأحداث باستخدام طريقة logEvent() . يسجل الرمز التالي حدث شراء عندما يشتري المستخدم عنصرًا (عناصر) في التطبيق:
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 ، ستتمكن حملات التطبيقات من معرفة المزيد عن الجماهير وتعزيز تعلم حملات التطبيقات ، مما يؤدي عادةً إلى تحسين الأداء والتحويلات.

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

412830708c61fdc0.png

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

796c921fb2b873ae.png

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

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

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

  1. في وحدة تحكم Firebase ، انتقل إلى قائمة الأحداث وحدد الحدث الذي تريد استيراده كتحويل.

a5f302ba01a1863c.png

  1. الآن ، انتقل إلى إعلانات Google وسجّل الدخول إلى الحساب الذي تربطه بـ Firebase.
  2. في إعلانات Google ، انتقل إلى الأدوات ← القياس ← التحويلات 7acf268d7e799a7e.png
  3. انقر فوق زر + d0eed72946d038d8.png
  4. اختر التطبيق ← خصائص Google Analytics 4 (Firebase) وانقر فوق متابعة. 983f06edb15724de.png
  5. يمكنك رؤية جميع أحداث التحليلات التي تم تمييزها على أنها تحويلات. ابحث عن الحدث الذي تريد استيراده. في هذه الحالة ، اختر delete_item event" التي قمنا بتنفيذها من قبل. انقر فوق الزر "استيراد ومتابعة". f9bdee80c0d40999.png
  6. لقد نجحت في استيراد حدث تحويل من Firebase. be75f6a11913236.png

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

في الخطوة التالية ، ستتعلم كيفية إطلاق حملة إجراء مع الحدث الذي قمت باستيراده للتو.

7. إطلاق حملات إجراءات التطبيق مع الأحداث المستوردة

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

19856a65ab999ad7.png

  1. سنطلق حملة ترويج التطبيق مع خيار عمليات تثبيت التطبيق. في الجزء السفلي ، اختر التطبيق الذي تريد الترويج له وانقر فوق متابعة. 8146b5a7a4f961bd.png
  2. في قسم عروض الأسعار ، إذا حددت الإجراءات داخل التطبيق في القائمة المنسدلة ، يمكنك عرض الأحداث. اختر حدثًا (أحداثًا) تريد التركيز عليه.

b75e410c7dbdfec8.png

  1. اضبط باقي إعدادات الحملة وانتهى الأمر.

8. مبروك

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

لقد تعلمت

  • كيفية تكوين Firebase Analytics لنظام Android
  • كيفية تسجيل الأحداث باستخدام Firebase Analytics في تطبيق Android.
  • كيفية استيراد الأحداث واستخدامها في حملات العمل.