إعلانات 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 بأحداث مخصصة.

ماذا ستحتاج

  • أندرويد ستوديو 3.6 أو أعلى
  • حساب فاير بيس
  • حساب إعلانات جوجل

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

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

إنشاء مشروع Firebase

  1. قم بتسجيل الدخول إلى Firebase .

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

8525e77df3536fbb.png

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

e58151a081f0628.png

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

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

ac928e5947ba7cbf.png

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

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

3. أضف Firebase إلى تطبيق Android الخاص بك

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

  1. في وحدة تحكم Firebase، حدد نظرة عامة على المشروع في شريط التنقل الأيمن، ثم انقر على زر 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 studio، انتقل إلى دليل 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() . تسجل التعليمة البرمجية التالية حدث 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، ستتمكن حملات التطبيقات من معرفة المزيد عن الجماهير وتعزيز ما تعلمته حملات التطبيقات، وهو ما يؤدي عادةً إلى تحسين الأداء والتحويلات.

  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" 4 (Firebase) وانقر على "متابعة". 983f06edb15724de.png
  5. يمكنك رؤية جميع أحداث التحليلات التي تم وضع علامة عليها كتحويلات. ابحث عن الحدث الذي تريد استيراده. في هذه الحالة اختر حدث delete_item الذي قمنا بتنفيذه من قبل. انقر فوق الزر "استيراد ومتابعة". 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.
  • كيفية استيراد الأحداث واستخدامها في حملات العمل.