تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

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

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

ميزة	إضافة SDK + لإعلانات الجوال تمكين مقاييس المستخدم	إضافة SDK + لإعلانات الجوال تمكين مقاييس المستخدم و اربط AdMob بـ Firebase	إضافة SDK + لإعلانات الجوال تمكين مقاييس المستخدم و اربط AdMob بـ Firebase و أضف Firebase SDK لبرنامج Analytics
اعرض مقاييس المستخدم في حسابك في 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 والمصادقة:
SwiftUI
```
import SwiftUI
import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...
      
```
سويفت
```
import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...
      
```
ج موضوعية
```
@import FirebaseCore;
@import FirebaseFirestore;
@import FirebaseAuth;
// ...
      
```

قم بتهيئة مثيل FirebaseApp مشترك في application(_:didFinishLaunchingWithOptions:) :

SwiftUI

// 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 . يجب عليك أيضًا تعطيل استخدام مفوض التطبيق. لمزيد من المعلومات ، راجع تعليمات SwiftUI .
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 القدرة على اختبار التغييرات التي تطرأ على واجهة المستخدم لتطبيقك أو الميزات أو حملات التفاعل لمعرفة ما إذا كان لها تأثير على مقاييسك الرئيسية (مثل الإيرادات والاحتفاظ) قبل طرح التغييرات على نطاق واسع.

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

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

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