استخدام المزيد من ميزات "إحصاءات Google" وFirebase مع تطبيقات AdMob

iOS Android

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

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

هذه المستويات المتزايدة من ميزات دعم الإعداد التي يمكن أن تساعدك في تحسين تجربة المستخدم لتطبيقك وأرباح إعلاناتك. اطلع على جدول الميزات التالي وروابطه لمعرفة المزيد!

الميزة	إضافة حزمة تطوير البرامج (SDK) لعرض الإعلانات على الأجهزة الجوّالة + تفعيل مقاييس سلوك المستخدمين	إضافة حزمة SDK لإعلانات الأجهزة الجوّالة + تفعيل مقاييس المستخدم و ربط AdMob بمنصّة Firebase	إضافة حزمة SDK لإعلانات الأجهزة الجوّالة + تفعيل مقاييس المستخدم و ربط AdMob بمنصّة Firebase و إضافة حزمة تطوير البرامج (SDK) لمنصّة Firebase الخاصّة بخدمة "إحصاءات Google"
عرض مقاييس سلوك المستخدِمين في حسابك على AdMob
التجميع التلقائي لما تتضمّنه التحليلات من الأحداث وخصائص المستخدِم من تطبيقك
عرض مقاييس سلوك المستخدِمين المنظّمة في AdMob
الاطّلاع على بيانات الإحصاءات والاستفادة منها من خلال منصّة Firebase
عرض المقاييس الرئيسية في وحدة تحكُّم Firebase
تحديد الإحالات الناجحة للحملات الإعلانية
إنشاء شرائح جمهور مخصّصة
تصدير البيانات وتحليلها في BigQuery
الوصول إلى المزيد من ميزات التخصيص لبيانات الإحصاءات
تسجيل أحداث مخصّصة للإحصاءات والنماذج (مثل تسجيل أحداث ecommerce_purchase لمقياسَي ARPU وARPPU)
ضبط الإحالات الناجحة المخصّصة للحملات الإعلانية
استخدام منتجات Firebase الأخرى (مثل "الإعداد عن بُعد" و"اختبار A/B")

بدء استخدام "إحصاءات Google"

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

لمَ يجب إضافة حزمة تطوير البرامج (SDK) لمنصّة Firebase الخاصّة بخدمة "إحصاءات Google"؟

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

لكن إذا كنت تريد جمع بيانات أحداث أو خصائص مستخدمين مخصّصة إضافية، ستحتاج إلى استخدام حزمة تطوير البرامج (SDK) لمنصّة Firebase الخاصّة بخدمة "إحصاءات Google". باستخدام حزمة تطوير البرامج (SDK) هذه، يمكنك تسجيل ما يصل إلى 500 نوع مختلف من أحداث الإحصاءات، وليس هناك حدّ أقصى لعدد الأحداث التي تسجّلها تطبيقاتك. من الأمثلة على استخدامات تسجيل الأحداث المخصّصة تضمين البيانات في عملية احتساب الأرباح من حدث مخصّص يُسمّى ecommerce_purchase لمساعدتك في تمثيل مقياسَي ARPU وARPPU بشكل أفضل.

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

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

الخطوة 1: إضافة ملف إعداد إلى تطبيقك

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

إذا لم يكن لديك ملف الإعداد هذا في تطبيقك، وسِّع هذا القسم لمعرفة كيفية إضافة هذا الملف.

1. في بطاقة تطبيقاتك على > إعدادات المشروع، اختَر رقم تعريف حزمة التطبيق الذي تحتاج إلى ملف إعداد له.

2. انقر على تنزيل GoogleService-Info.plist للحصول على ملف إعداد Firebase iOS (GoogleService-Info.plist).

   • يمكنك تنزيل ملف إعداد Firebase iOS مرة أخرى في أي وقت من خلال > إعدادات المشروع.

   • تأكَّد من أنّه لم يتم إلحاق أحرف إضافية باسم ملف الإعداد، مثل (2).

3. انقل ملف التكوين إلى جذر مشروع Xcode. اختَر إضافة ملف الإعداد إلى جميع الاستهدافات إذا طُلب منك ذلك

إذا كان لديك عدّة معرّفات حِزم في مشروعك، عليك ربط كل رقم تعريف بتطبيق مسجَّل في وحدة تحكُّم Firebase كي يكون لكل تطبيق ملف GoogleService-Info.plist خاص به.

ملاحظة: يحتوي ملف إعداد Firebase على معرّفات فريدة ولكنها غير سرية لمشروعك.
يمكنك الانتقال إلى فهم مشاريع Firebase لمزيد من المعلومات حول ملف الإعداد هذا.

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

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

   pod 'FirebaseAnalytics'
   

2. شغِّل pod install، ثم افتح ملف .xcworkspace الذي تم إنشاؤه.

3. يمكنك استيراد وحدة FirebaseCore في UIApplicationDelegate، بالإضافة إلى أي وحدات Firebase أخرى يستخدمها المستخدم المفوَّض في تطبيقك. على سبيل المثال، لاستخدام Cloud Firestore والمصادقة:

   واجهة المستخدم

   import SwiftUI
   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Swift

   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Objective-C

   @import FirebaseCore;
   @import FirebaseFirestore;
   @import FirebaseAuth;
   // ...
         

4. يمكنك ضبط المثيل المشترك ضمن FirebaseApp في طريقة application(_:didFinishLaunchingWithOptions:) الخاصة بمفوَّض تطبيقك:

   واجهة المستخدم

   // Use Firebase library to configure APIs
   FirebaseApp.configure()

   Swift

   // Use Firebase library to configure APIs
   FirebaseApp.configure()

   Objective-C

   // Use Firebase library to configure APIs
   [FIRApp configure];

5. إذا كنت تستخدم SwiftUI، عليك إنشاء تفويض تطبيق وإرفاقه ببنية App من خلال UIApplicationDelegateAdaptor أو NSApplicationDelegateAdaptor. ويجب أيضًا إيقاف إيماءة تفويض التطبيق. لمزيد من المعلومات، راجِع تعليمات SwiftUI.

   واجهة المستخدم

   @main
   struct YourApp: App {
     // register app delegate for Firebase setup
     @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
   
     var body: some Scene {
       WindowGroup {
         NavigationView {
           ContentView()
         }
       }
     }
   }
         

في حال تتبُّع عمليات الشراء داخل التطبيق، يجب إعداد مراقبة المعاملات في application:didFinishLaunchingWithOptions: قبل إعداد Firebase، وإلا قد لا يتلقّى المراقِب جميع الإشعارات بشأن عمليات الشراء. يمكنك الاطّلاع على أفضل ممارسات الشراء داخل التطبيق من Apple لمعرفة مزيد من المعلومات.

تنفيذ تسجيل الأحداث المخصص

يعرض هذا القسم مثالاً على كيفية تنفيذ تسجيل الأحداث المخصّصة في تطبيقك. يتناول هذا المثال تحديدًا الحدث المخصَّص "ecommerce_purchase" الذي يُعدّ حدثًا مفيدًا لتسجيل التطبيقات المرتبطة بـ AdMob، لا سيما عند احتساب متوسط الأرباح لكل مستخدم يدفع رسومًا (ARPU) ومتوسط الأرباح لكل مستخدم يدفع رسومًا.

ما أهمية السمة ecommerce_purchase بالنسبة إلى متوسط الأرباح من كل مستخدم (ARPU) ومتوسط الأرباح لكل مستخدم يدفع رسومًا (ARPPU)؟

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

• in_app_purchase: عندما يُكمل المستخدم عملية شراء داخل التطبيق تتم معالجتها في App Store على iTunes، مثل الاشتراك الأولي أو الاستفادة من الخدمات المدفوعة أو شراء عناصر داخل اللعبة.

• ecommerce_purchase: عندما يُكمل المستخدم عملية شراء، مثل التسوّق على الإنترنت أو شراء قسائم أو منتجات بأسعار مخفَّضة أو شراء تذاكر سينما

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

في ما يلي كيفية تنفيذ ميزة تسجيل الأحداث المخصّصة في تطبيقك:

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

2. تسجيل حدث ecommerce_purchase (Swift | Obj-C) وفي ما يلي مثال لذلك:

   Swift

   Analytics.logEvent(AnalyticsEventPurchase, parameters: [
     AnalyticsParameterCoupon: "SummerPromo",
     AnalyticsParameterCurrency: "JPY",
     AnalyticsParameterValue: 10000,
     AnalyticsParameterShipping: 500,
     AnalyticsParameterTransactionID: "192803301",
   ])

   Objective-C

   [FIRAnalytics logEventWithName:kFIREventPurchase
                       parameters:@{
     kFIRParameterCoupon: @"SummerPromo",
     kFIRParameterCurrency: @"JPY",
     kFIRParameterValue: @10000,
     kFIRParameterShipping: @500,
     kFIRParameterTransactionID: @"192803301",
   }];

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

استخدام منتجات Firebase الأخرى في تطبيقك

بعد إضافة حزمة تطوير البرامج (SDK) لمنصّة Firebase الخاصّة بخدمة "إحصاءات Google"، يمكنك أيضًا بدء استخدام منتجات Firebase الأخرى، مثل "الإعداد عن بُعد في Firebase" و"اختبار A/B من Firebase".

• تمكِّنك ميزة الإعداد عن بُعد من تغيير سلوك تطبيقك ومظهره بدون نشر تحديث للتطبيق، وذلك بدون أي تكلفة، وذلك لعدد غير محدود من المستخدمين النشطين يوميًا.

• من خلال اختبار A/B، يمكنك اختبار التغييرات في واجهة المستخدم أو الميزات أو حملات التفاعل مع تطبيقك لمعرفة ما إذا كانت تؤثر في المقاييس الرئيسية (مثل الأرباح والاحتفاظ بالمستخدمين) قبل طرحها على نطاق واسع.

تحسين تحقيق الربح من الإعلانات لتطبيقك

جرِّب أشكال الإعلانات أو صيغها المختلفة مع مجموعة فرعية صغيرة من المستخدمين، ثم اتّخِذ قرارات مستندة إلى البيانات بشأن تنفيذ الإعلان لجميع المستخدمين. لمعرفة المزيد، تحقق من البرامج التعليمية التالية:

• اختبار استخدام أشكال الإعلانات الجديدة (نظرة عامة | عملية التنفيذ).

• تحسين معدّل تكرار الإعلانات (نظرة عامة | عملية التنفيذ).