استخدم المزيد من ميزات Google Analytics وFirebase مع تطبيقات AdMob

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

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

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

ابدأ باستخدام Google Analytics

Google Analytics هو محرك تحليلات Firebase الذي يتيح لك الوصول إلى رؤى قوية حول بياناتك. ابدأ في استخدام Google Analytics في تطبيقك عن طريق إضافة Firebase SDK لبرنامج Google Analytics.

لماذا تضيف Firebase SDK لبرنامج Google Analytics؟

باستخدام إعداد AdMob الأساسي ، يمكنك عرض الإحصائيات المجمعة من الأحداث المجمعة تلقائيًا وخصائص المستخدمين في لوحة تحكم Analytics بوحدة تحكم Firebase دون إضافة أي تعليمات برمجية إضافية إلى تطبيقك.

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

ومن خلال إضافة Firebase SDK لبرنامج Google Analytics، يمكنك أيضًا إضافة تحويلات مخصصة للحملات الإعلانية وتمكين استخدام منتجات Firebase الأخرى .

توضح الخطوات التالية كيفية بدء استخدام Firebase SDK لبرنامج Google Analytics في تطبيقك. بعد تهيئة SDK، تفضل بزيارة وثائق Analytics للتعرف على كيفية بدء تسجيل الأحداث في تطبيقك.

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

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

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

في بطاقة تطبيقاتك في > إعدادات المشروع ، حدد معرف حزمة التطبيق الذي تحتاج إلى ملف تكوين له.
انقر فوق تنزيل GoogleService-Info.plist للحصول على ملف تكوين Firebase iOS ( GoogleService-Info.plist ).
- يمكنك تنزيل ملف تكوين Firebase iOS الخاص بك مرة أخرى في أي وقت من > إعدادات المشروع .
- تأكد من عدم إلحاق اسم ملف التكوين بأحرف إضافية، مثل (2) .
انقل ملف التكوين الخاص بك إلى جذر مشروع Xcode الخاص بك. إذا طُلب منك ذلك، حدد إضافة ملف التكوين إلى كافة الأهداف.

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

الخطوة 2: أضف Firebase SDK for Analytics إلى تطبيقك

أضف تبعية Firebase SDK لبرنامج Google Analytics إلى ملف Podfile الخاص بك:
```
pod 'FirebaseAnalytics'
```
قم بتشغيل pod install ، ثم افتح ملف .xcworkspace الذي تم إنشاؤه.
قم باستيراد وحدة FirebaseCore في UIApplicationDelegate ، بالإضافة إلى أي وحدات Firebase أخرى يستخدمها مندوب تطبيقك. على سبيل المثال، لاستخدام Cloud Firestore والمصادقة:
سويفتويي
```
import SwiftUI
import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...
      
```
سويفت
```
import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...
      
```
ج موضوعية
```
@import FirebaseCore;
@import FirebaseFirestore;
@import FirebaseAuth;
// ...
      
```

قم بتكوين مثيل FirebaseApp مشترك في طريقة application(_:didFinishLaunchingWithOptions:) :

سويفتويي

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

سويفت

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

ج موضوعية

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

إذا كنت تستخدم SwiftUI، فيجب عليك إنشاء مفوض تطبيق وإرفاقه ببنية App الخاص بك عبر UIApplicationDelegateAdaptor أو NSApplicationDelegateAdaptor . يجب عليك أيضًا تعطيل swizzling مندوب التطبيق. لمزيد من المعلومات، راجع تعليمات SwiftUI .
سويفتويي
```
@main
struct YourApp: App {
  // register app delegate for Firebase setup
  @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate

  var body: some Scene {
    WindowGroup {
      NavigationView {
        ContentView()
      }
    }
  }
}
      
```

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

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

ما سبب أهمية ecommerce_purchase لـ ARPU وARPPU؟

أحد المقاييس الرئيسية لتطبيقك هو الإيرادات حسب المستخدم ، والتي يمكن تقسيمها إلى ARPU و ARPPU . يتم عرض هذين المقياسين في بطاقة مقاييس المستخدم بحسابك في AdMob وفي لوحة تحكم Analytics بوحدة تحكم Firebase. ومع ذلك، لا يتم قياس الإيرادات بشكل مباشر؛ وبدلاً من ذلك، فهو مجموع أرباحك المقدرة من AdMob وقيمتي حدث التحليلات التاليتين:

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

ecommerce_purchase : عندما يُكمل المستخدم عملية شراء، مثل التسوق عبر الإنترنت، أو شراء كوبونات أو عناصر الخصم، أو شراء تذاكر السينما

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

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

تأكد من إكمال قسم بدء استخدام Google Analytics في هذه الصفحة، والذي يتضمن تهيئة تطبيقك لاستخدام Firebase، وإضافة Firebase SDK لـ Google Analytics، وتهيئة SDK.

قم بتسجيل حدث ecommerce_purchase ( Swift | Obj-C ). هنا مثال:

سويفت

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

ج موضوعية

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

لمعرفة المزيد حول تسجيل الأحداث المخصصة في تطبيقك، تفضل بزيارة وثائق Analytics .

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

بعد إضافة Firebase SDK لبرنامج Google Analytics، يمكنك أيضًا البدء في استخدام منتجات Firebase الأخرى، مثل Firebase Remote Config وFirebase A/B Testing.

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

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

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

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