پس از تکمیل تنظیمات اولیه AdMob ، میتوانید Firebase SDK را برای Google Analytics نیز اضافه کنید تا از سایر ویژگیهای Google Analytics و Firebase بهرهمند شوید. در ادامه در همین صفحه نحوه شروع به کار با Google Analytics را بیاموزید.
این سطوح فزاینده پیکربندی، از ویژگیهایی پشتیبانی میکنند که میتوانند به شما در بهینهسازی تجربه کاربری برنامه و درآمد تبلیغاتیتان کمک کنند. برای کسب اطلاعات بیشتر، جدول ویژگیها و پیوندهای آن را در ادامه بررسی کنید!
| ویژگی | اضافه کردن SDK + Mobile Ads معیارهای کاربر را فعال کنید | اضافه کردن SDK + Mobile Ads معیارهای کاربر را فعال کنید و اتصال AdMob به فایربیس | اضافه کردن SDK + Mobile Ads معیارهای کاربر را فعال کنید و AdMob به Firebase لینک کنید و اضافه کردن Firebase SDK برای Analytics |
| مشاهده معیارهای کاربر در حساب AdMob شما | |||
| رویدادهای تحلیلی و ویژگیهای کاربر را بهطور خودکار از برنامه خود جمعآوری کنید | |||
| مشاهده معیارهای کاربر انتخابشده در AdMob | |||
| کاوش و کار با دادههای تحلیلی خود از طریق Firebase | |||
| مشاهده معیارهای کلیدی در کنسول Firebase | |||
| تبدیلها را برای کمپینهای تبلیغاتی علامتگذاری کنید | |||
| مخاطبان سفارشی بسازید | |||
| استخراج و تجزیه و تحلیل دادهها در BigQuery | |||
| به ویژگیهای سفارشیسازی بیشتری برای دادههای تحلیلی خود دسترسی پیدا کنید | |||
| ثبت رویدادهای سفارشی برای تجزیه و تحلیل و مدلها (مانند ثبت رویدادهای ecommerce_purchase برای معیارهای ARPU و ARPPU ) | |||
| پیکربندی تبدیلهای سفارشی برای کمپینهای تبلیغاتی | |||
| استفاده از سایر محصولات فایربیس (مانند Remote Config و A/B Testing ) | |||
شروع کار با Google Analytics
Google Analytics موتور تحلیلی فایربیس است که به شما امکان دسترسی به بینشهای قدرتمندی از دادههایتان را میدهد. با اضافه کردن کیت توسعه نرمافزار فایربیس برای Google Analytics ، استفاده از Google Analytics را در برنامه خود شروع کنید.
با تنظیمات اولیه AdMob ، میتوانید آمار جمعآوریشده از رویدادها و ویژگیهای کاربر که بهطور خودکار جمعآوری شدهاند را در داشبورد Analytics کنسول Firebase بدون اضافه کردن هیچ کد اضافی به برنامه خود مشاهده کنید.
با این حال، اگر میخواهید دادههای رویدادهای سفارشی اضافی یا ویژگیهای کاربر را جمعآوری کنید، باید از Firebase SDK برای Google Analytics استفاده کنید. با استفاده از این SDK، میتوانید تا ۵۰۰ نوع رویداد تحلیلی مختلف را ثبت کنید و هیچ محدودیتی در حجم کل رویدادهایی که برنامه شما ثبت میکند، وجود ندارد. یک مثال از کاربرد ثبت رویدادهای سفارشی، گنجاندن دادهها در محاسبه درآمد شما از یک رویداد سفارشی به نام ecommerce_purchase است تا به شما در نمایش بهتر معیارهای ARPU و ARPPU کمک کند.
با افزودن Firebase SDK برای Google Analytics ، میتوانید تبدیلهای سفارشی را برای کمپینهای تبلیغاتی اضافه کنید و استفاده از سایر محصولات Firebase را فعال کنید.
مراحل زیر نحوه شروع استفاده از Firebase SDK برای Google Analytics در برنامه شما را شرح میدهد. پس از مقداردهی اولیه SDK، برای یادگیری نحوه شروع ثبت وقایع در برنامه خود، به مستندات Analytics مراجعه کنید.
مرحله ۱: یک فایل پیکربندی به برنامه خود اضافه کنید
اگر قبل از ایجاد لینک AdMob ، برنامه خود را در Firebase ثبت کرده باشید، در واقع یک فایل پیکربندی Firebase به برنامه خود اضافه کردهاید.فایل GoogleService-Info.plist را در ریشه پروژه Xcode خود بررسی کنید. همچنین مطمئن شوید که فایل پیکربندی به همه targetها اضافه شده است.
در کارت برنامههای شما در > تنظیمات پروژه ، شناسه بسته برنامهای را که برای آن به فایل پیکربندی نیاز دارید، انتخاب کنید.
برای دریافت فایل پیکربندی Firebase iOS خود (
GoogleService-Info.plist) روی دانلود GoogleService-Info.plist کلیک کنید.شما میتوانید فایل پیکربندی Firebase iOS خود را در هر زمانی از > تنظیمات پروژه دوباره دانلود کنید.
مطمئن شوید که نام فایل پیکربندی با کاراکترهای اضافی مانند
(2)ضمیمه نشده باشد.
فایل پیکربندی خود را به ریشه پروژه Xcode خود منتقل کنید. در صورت درخواست، گزینه افزودن فایل پیکربندی به همه اهداف را انتخاب کنید.
اگر چندین شناسه بسته در پروژه خود دارید، باید هر شناسه بسته را با یک برنامه ثبت شده در کنسول Firebase مرتبط کنید تا هر برنامه بتواند فایل GoogleService-Info.plist مخصوص به خود را داشته باشد.
مرحله ۲: کیت توسعه نرمافزار Firebase برای Analytics را به برنامه خود اضافه کنید
وابستگی مربوط به Firebase SDK برای Google Analytics را به Podfile خود اضافه کنید:
pod 'FirebaseAnalytics'دستور
pod installاجرا کنید، سپس فایل.xcworkspaceایجاد شده را باز کنید.- ماژول
FirebaseCoreرا درUIApplicationDelegateخود وارد کنید، و همچنین هر ماژول Firebase دیگری که app delegate شما از آن استفاده میکند. به عنوان مثال، برای استفاده از Cloud Firestore و Authentication :سویفتیوآی
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 استفاده میکنید، باید یک نماینده برنامه ایجاد کنید و آن را از طریق
UIApplicationDelegateAdaptorیاNSApplicationDelegateAdaptorبه ساختارAppخود پیوست کنید. همچنین باید 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 است.
یکی از معیارهای کلیدی برای برنامه شما، درآمد بر اساس کاربر است که میتواند به ARPU و ARPPU تقسیم شود. این دو معیار در کارت معیارهای کاربر حساب AdMob شما و در داشبورد Analytics کنسول Firebase نمایش داده میشوند. با این حال، درآمد به طور مستقیم اندازهگیری نمیشود؛ در عوض، مجموع درآمد تخمینی AdMob شما و دو مقدار رویداد تحلیلی زیر است:
-
in_app_purchase: زمانی که کاربر یک خرید درونبرنامهای را که توسط اپ استور در iTunes پردازش میشود، مانند اشتراک اولیه، باز کردن قفل سرویسهای پریمیوم یا خرید اقلام درون بازی، تکمیل میکند.
-
ecommerce_purchase: زمانی که کاربر خریدی را انجام میدهد، مانند خرید آنلاین، خرید کوپن یا اقلام تخفیفدار یا خرید بلیط سینما
بدون هیچ کد اضافی در برنامه شما، SDK Mobile Ads به طور خودکار دادههای تحلیلی را برای رویدادهای in_app_purchase جمعآوری میکند. با این حال، اگر میخواهید دادههای رویداد ecommerce_purchase را نیز در محاسبه درآمد لحاظ کنید، باید از طریق Firebase SDK برای Google Analytics گزارشگیری سفارشی را پیادهسازی کنید.
در اینجا نحوه پیادهسازی ثبت وقایع سفارشی در برنامه شما آورده شده است:
مطمئن شوید که بخش « شروع به کار با Google Analytics این صفحه را تکمیل کردهاید، که شامل پیکربندی برنامه شما برای استفاده از فایربیس، افزودن کیت توسعه نرمافزار فایربیس برای Google Analytics و مقداردهی اولیه کیت توسعه نرمافزار است.
یک رویداد
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 Testing به شما این قدرت را میدهد که تغییرات در رابط کاربری، ویژگیها یا کمپینهای تعامل برنامه خود را آزمایش کنید تا ببینید آیا آنها قبل از اعمال تغییرات به طور گسترده، بر معیارهای کلیدی شما (مانند درآمد و حفظ مشتری) تأثیر میگذارند یا خیر.
بهینهسازی کسب درآمد از تبلیغات برای اپلیکیشن شما
قالبها یا پیکربندیهای مختلف تبلیغات را با زیرمجموعه کوچکی از کاربران امتحان کنید و سپس تصمیمات مبتنی بر داده در مورد اجرای تبلیغ برای همه کاربران خود بگیرید. برای کسب اطلاعات بیشتر، آموزشهای زیر را بررسی کنید:
پذیرش قالب تبلیغاتی جدید را آزمایش کنید ( مرور کلی | پیادهسازی ).
پس از تکمیل تنظیمات اولیه AdMob ، میتوانید Firebase SDK را برای Google Analytics نیز اضافه کنید تا از سایر ویژگیهای Google Analytics و Firebase بهرهمند شوید. در ادامه در همین صفحه نحوه شروع به کار با Google Analytics را بیاموزید.
این سطوح فزاینده پیکربندی، از ویژگیهایی پشتیبانی میکنند که میتوانند به شما در بهینهسازی تجربه کاربری برنامه و درآمد تبلیغاتیتان کمک کنند. برای کسب اطلاعات بیشتر، جدول ویژگیها و پیوندهای آن را در ادامه بررسی کنید!
| ویژگی | اضافه کردن SDK + Mobile Ads معیارهای کاربر را فعال کنید | اضافه کردن SDK + Mobile Ads معیارهای کاربر را فعال کنید و اتصال AdMob به فایربیس | اضافه کردن SDK + Mobile Ads معیارهای کاربر را فعال کنید و AdMob به Firebase لینک کنید و اضافه کردن Firebase SDK برای Analytics |
| مشاهده معیارهای کاربر در حساب AdMob شما | |||
| رویدادهای تحلیلی و ویژگیهای کاربر را بهطور خودکار از برنامه خود جمعآوری کنید | |||
| مشاهده معیارهای کاربر انتخابشده در AdMob | |||
| کاوش و کار با دادههای تحلیلی خود از طریق Firebase | |||
| مشاهده معیارهای کلیدی در کنسول Firebase | |||
| تبدیلها را برای کمپینهای تبلیغاتی علامتگذاری کنید | |||
| مخاطبان سفارشی بسازید | |||
| استخراج و تجزیه و تحلیل دادهها در BigQuery | |||
| به ویژگیهای سفارشیسازی بیشتری برای دادههای تحلیلی خود دسترسی پیدا کنید | |||
| ثبت رویدادهای سفارشی برای تجزیه و تحلیل و مدلها (مانند ثبت رویدادهای ecommerce_purchase برای معیارهای ARPU و ARPPU ) | |||
| پیکربندی تبدیلهای سفارشی برای کمپینهای تبلیغاتی | |||
| استفاده از سایر محصولات فایربیس (مانند Remote Config و A/B Testing ) | |||
شروع کار با Google Analytics
Google Analytics موتور تحلیلی فایربیس است که به شما امکان دسترسی به بینشهای قدرتمندی از دادههایتان را میدهد. با اضافه کردن کیت توسعه نرمافزار فایربیس برای Google Analytics ، استفاده از Google Analytics را در برنامه خود شروع کنید.
با تنظیمات اولیه AdMob ، میتوانید آمار جمعآوریشده از رویدادها و ویژگیهای کاربر که بهطور خودکار جمعآوری شدهاند را در داشبورد Analytics کنسول Firebase بدون اضافه کردن هیچ کد اضافی به برنامه خود مشاهده کنید.
با این حال، اگر میخواهید دادههای رویدادهای سفارشی اضافی یا ویژگیهای کاربر را جمعآوری کنید، باید از Firebase SDK برای Google Analytics استفاده کنید. با استفاده از این SDK، میتوانید تا ۵۰۰ نوع رویداد تحلیلی مختلف را ثبت کنید و هیچ محدودیتی در حجم کل رویدادهایی که برنامه شما ثبت میکند، وجود ندارد. یک مثال از کاربرد ثبت رویدادهای سفارشی، گنجاندن دادهها در محاسبه درآمد شما از یک رویداد سفارشی به نام ecommerce_purchase است تا به شما در نمایش بهتر معیارهای ARPU و ARPPU کمک کند.
با افزودن Firebase SDK برای Google Analytics ، میتوانید تبدیلهای سفارشی را برای کمپینهای تبلیغاتی اضافه کنید و استفاده از سایر محصولات Firebase را فعال کنید.
مراحل زیر نحوه شروع استفاده از Firebase SDK برای Google Analytics در برنامه شما را شرح میدهد. پس از مقداردهی اولیه SDK، برای یادگیری نحوه شروع ثبت وقایع در برنامه خود، به مستندات Analytics مراجعه کنید.
مرحله ۱: یک فایل پیکربندی به برنامه خود اضافه کنید
اگر قبل از ایجاد لینک AdMob ، برنامه خود را در Firebase ثبت کرده باشید، در واقع یک فایل پیکربندی Firebase به برنامه خود اضافه کردهاید.فایل GoogleService-Info.plist را در ریشه پروژه Xcode خود بررسی کنید. همچنین مطمئن شوید که فایل پیکربندی به همه targetها اضافه شده است.
در کارت برنامههای شما در > تنظیمات پروژه ، شناسه بسته برنامهای را که برای آن به فایل پیکربندی نیاز دارید، انتخاب کنید.
برای دریافت فایل پیکربندی Firebase iOS خود (
GoogleService-Info.plist) روی دانلود GoogleService-Info.plist کلیک کنید.شما میتوانید فایل پیکربندی Firebase iOS خود را در هر زمانی از > تنظیمات پروژه دوباره دانلود کنید.
مطمئن شوید که نام فایل پیکربندی با کاراکترهای اضافی مانند
(2)ضمیمه نشده باشد.
فایل پیکربندی خود را به ریشه پروژه Xcode خود منتقل کنید. در صورت درخواست، گزینه افزودن فایل پیکربندی به همه اهداف را انتخاب کنید.
اگر چندین شناسه بسته در پروژه خود دارید، باید هر شناسه بسته را با یک برنامه ثبت شده در کنسول Firebase مرتبط کنید تا هر برنامه بتواند فایل GoogleService-Info.plist مخصوص به خود را داشته باشد.
مرحله ۲: کیت توسعه نرمافزار Firebase برای Analytics را به برنامه خود اضافه کنید
وابستگی مربوط به Firebase SDK برای Google Analytics را به Podfile خود اضافه کنید:
pod 'FirebaseAnalytics'دستور
pod installاجرا کنید، سپس فایل.xcworkspaceایجاد شده را باز کنید.- ماژول
FirebaseCoreرا درUIApplicationDelegateخود وارد کنید، و همچنین هر ماژول Firebase دیگری که app delegate شما از آن استفاده میکند. به عنوان مثال، برای استفاده از Cloud Firestore و Authentication :سویفتیوآی
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 استفاده میکنید، باید یک نماینده برنامه ایجاد کنید و آن را از طریق
UIApplicationDelegateAdaptorیاNSApplicationDelegateAdaptorبه ساختارAppخود پیوست کنید. همچنین باید 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 است.
یکی از معیارهای کلیدی برای برنامه شما، درآمد بر اساس کاربر است که میتواند به ARPU و ARPPU تقسیم شود. این دو معیار در کارت معیارهای کاربر حساب AdMob شما و در داشبورد Analytics کنسول Firebase نمایش داده میشوند. با این حال، درآمد به طور مستقیم اندازهگیری نمیشود؛ در عوض، مجموع درآمد تخمینی AdMob شما و دو مقدار رویداد تحلیلی زیر است:
-
in_app_purchase: زمانی که کاربر یک خرید درونبرنامهای را که توسط اپ استور در iTunes پردازش میشود، مانند اشتراک اولیه، باز کردن قفل سرویسهای پریمیوم یا خرید اقلام درون بازی، تکمیل میکند.
-
ecommerce_purchase: زمانی که کاربر خریدی را انجام میدهد، مانند خرید آنلاین، خرید کوپن یا اقلام تخفیفدار یا خرید بلیط سینما
بدون هیچ کد اضافی در برنامه شما، SDK Mobile Ads به طور خودکار دادههای تحلیلی را برای رویدادهای in_app_purchase جمعآوری میکند. با این حال، اگر میخواهید دادههای رویداد ecommerce_purchase را نیز در محاسبه درآمد لحاظ کنید، باید از طریق Firebase SDK برای Google Analytics گزارشگیری سفارشی را پیادهسازی کنید.
در اینجا نحوه پیادهسازی ثبت وقایع سفارشی در برنامه شما آورده شده است:
مطمئن شوید که بخش « شروع به کار با Google Analytics این صفحه را تکمیل کردهاید، که شامل پیکربندی برنامه شما برای استفاده از فایربیس، افزودن کیت توسعه نرمافزار فایربیس برای Google Analytics و مقداردهی اولیه کیت توسعه نرمافزار است.
یک رویداد
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 Testing به شما این قدرت را میدهد که تغییرات در رابط کاربری، ویژگیها یا کمپینهای تعامل برنامه خود را آزمایش کنید تا ببینید آیا آنها قبل از اعمال تغییرات به طور گسترده، بر معیارهای کلیدی شما (مانند درآمد و حفظ مشتری) تأثیر میگذارند یا خیر.
بهینهسازی کسب درآمد از تبلیغات برای اپلیکیشن شما
قالبها یا پیکربندیهای مختلف تبلیغات را با زیرمجموعه کوچکی از کاربران امتحان کنید و سپس تصمیمات مبتنی بر داده در مورد اجرای تبلیغ برای همه کاربران خود بگیرید. برای کسب اطلاعات بیشتر، آموزشهای زیر را بررسی کنید:
پذیرش قالب تبلیغاتی جدید را آزمایش کنید ( مرور کلی | پیادهسازی ).
پس از تکمیل تنظیمات اولیه AdMob ، میتوانید Firebase SDK را برای Google Analytics نیز اضافه کنید تا از سایر ویژگیهای Google Analytics و Firebase بهرهمند شوید. در ادامه در همین صفحه نحوه شروع به کار با Google Analytics را بیاموزید.
این سطوح فزاینده پیکربندی، از ویژگیهایی پشتیبانی میکنند که میتوانند به شما در بهینهسازی تجربه کاربری برنامه و درآمد تبلیغاتیتان کمک کنند. برای کسب اطلاعات بیشتر، جدول ویژگیها و پیوندهای آن را در ادامه بررسی کنید!
| ویژگی | اضافه کردن SDK + Mobile Ads معیارهای کاربر را فعال کنید | اضافه کردن SDK + Mobile Ads معیارهای کاربر را فعال کنید و اتصال AdMob به فایربیس | اضافه کردن SDK + Mobile Ads معیارهای کاربر را فعال کنید و AdMob به Firebase لینک کنید و اضافه کردن Firebase SDK برای Analytics |
| مشاهده معیارهای کاربر در حساب AdMob شما | |||
| رویدادهای تحلیلی و ویژگیهای کاربر را بهطور خودکار از برنامه خود جمعآوری کنید | |||
| مشاهده معیارهای کاربر انتخابشده در AdMob | |||
| کاوش و کار با دادههای تحلیلی خود از طریق Firebase | |||
| مشاهده معیارهای کلیدی در کنسول Firebase | |||
| تبدیلها را برای کمپینهای تبلیغاتی علامتگذاری کنید | |||
| مخاطبان سفارشی بسازید | |||
| استخراج و تجزیه و تحلیل دادهها در BigQuery | |||
| به ویژگیهای سفارشیسازی بیشتری برای دادههای تحلیلی خود دسترسی پیدا کنید | |||
| ثبت رویدادهای سفارشی برای تجزیه و تحلیل و مدلها (مانند ثبت رویدادهای ecommerce_purchase برای معیارهای ARPU و ARPPU ) | |||
| پیکربندی تبدیلهای سفارشی برای کمپینهای تبلیغاتی | |||
| استفاده از سایر محصولات فایربیس (مانند Remote Config و A/B Testing ) | |||
شروع کار با Google Analytics
Google Analytics موتور تحلیلی فایربیس است که به شما امکان دسترسی به بینشهای قدرتمندی از دادههایتان را میدهد. با اضافه کردن کیت توسعه نرمافزار فایربیس برای Google Analytics ، استفاده از Google Analytics را در برنامه خود شروع کنید.
با تنظیمات اولیه AdMob ، میتوانید آمار جمعآوریشده از رویدادها و ویژگیهای کاربر که بهطور خودکار جمعآوری شدهاند را در داشبورد Analytics کنسول Firebase بدون اضافه کردن هیچ کد اضافی به برنامه خود مشاهده کنید.
با این حال، اگر میخواهید دادههای رویدادهای سفارشی اضافی یا ویژگیهای کاربر را جمعآوری کنید، باید از Firebase SDK برای Google Analytics استفاده کنید. با استفاده از این SDK، میتوانید تا ۵۰۰ نوع رویداد تحلیلی مختلف را ثبت کنید و هیچ محدودیتی در حجم کل رویدادهایی که برنامه شما ثبت میکند، وجود ندارد. یک مثال از کاربرد ثبت رویدادهای سفارشی، گنجاندن دادهها در محاسبه درآمد شما از یک رویداد سفارشی به نام ecommerce_purchase است تا به شما در نمایش بهتر معیارهای ARPU و ARPPU کمک کند.
با افزودن Firebase SDK برای Google Analytics ، میتوانید تبدیلهای سفارشی را برای کمپینهای تبلیغاتی اضافه کنید و استفاده از سایر محصولات Firebase را فعال کنید.
مراحل زیر نحوه شروع استفاده از Firebase SDK برای Google Analytics در برنامه شما را شرح میدهد. پس از مقداردهی اولیه SDK، برای یادگیری نحوه شروع ثبت وقایع در برنامه خود، به مستندات Analytics مراجعه کنید.
مرحله ۱: یک فایل پیکربندی به برنامه خود اضافه کنید
اگر قبل از ایجاد لینک AdMob ، برنامه خود را در Firebase ثبت کرده باشید، در واقع یک فایل پیکربندی Firebase به برنامه خود اضافه کردهاید.فایل GoogleService-Info.plist را در ریشه پروژه Xcode خود بررسی کنید. همچنین مطمئن شوید که فایل پیکربندی به همه targetها اضافه شده است.
در کارت برنامههای شما در > تنظیمات پروژه ، شناسه بسته برنامهای را که برای آن به فایل پیکربندی نیاز دارید، انتخاب کنید.
برای دریافت فایل پیکربندی Firebase iOS خود (
GoogleService-Info.plist) روی دانلود GoogleService-Info.plist کلیک کنید.شما میتوانید فایل پیکربندی Firebase iOS خود را در هر زمانی از > تنظیمات پروژه دوباره دانلود کنید.
مطمئن شوید که نام فایل پیکربندی با کاراکترهای اضافی مانند
(2)ضمیمه نشده باشد.
فایل پیکربندی خود را به ریشه پروژه Xcode خود منتقل کنید. در صورت درخواست، گزینه افزودن فایل پیکربندی به همه اهداف را انتخاب کنید.
اگر چندین شناسه بسته در پروژه خود دارید، باید هر شناسه بسته را با یک برنامه ثبت شده در کنسول Firebase مرتبط کنید تا هر برنامه بتواند فایل GoogleService-Info.plist مخصوص به خود را داشته باشد.
مرحله ۲: کیت توسعه نرمافزار Firebase برای Analytics را به برنامه خود اضافه کنید
وابستگی مربوط به Firebase SDK برای Google Analytics را به Podfile خود اضافه کنید:
pod 'FirebaseAnalytics'دستور
pod installاجرا کنید، سپس فایل.xcworkspaceایجاد شده را باز کنید.- ماژول
FirebaseCoreرا درUIApplicationDelegateخود وارد کنید، و همچنین هر ماژول Firebase دیگری که app delegate شما از آن استفاده میکند. به عنوان مثال، برای استفاده از Cloud Firestore و Authentication :سویفتیوآی
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 استفاده میکنید، باید یک نماینده برنامه ایجاد کنید و آن را از طریق
UIApplicationDelegateAdaptorیاNSApplicationDelegateAdaptorبه ساختارAppخود پیوست کنید. همچنین باید 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 است.
یکی از معیارهای کلیدی برای برنامه شما، درآمد بر اساس کاربر است که میتواند به ARPU و ARPPU تقسیم شود. این دو معیار در کارت معیارهای کاربر حساب AdMob شما و در داشبورد Analytics کنسول Firebase نمایش داده میشوند. با این حال، درآمد به طور مستقیم اندازهگیری نمیشود؛ در عوض، مجموع درآمد تخمینی AdMob شما و دو مقدار رویداد تحلیلی زیر است:
-
in_app_purchase: زمانی که کاربر یک خرید درونبرنامهای را که توسط اپ استور در iTunes پردازش میشود، مانند اشتراک اولیه، باز کردن قفل سرویسهای پریمیوم یا خرید اقلام درون بازی، تکمیل میکند.
-
ecommerce_purchase: زمانی که کاربر خریدی را انجام میدهد، مانند خرید آنلاین، خرید کوپن یا اقلام تخفیفدار یا خرید بلیط سینما
بدون هیچ کد اضافی در برنامه شما، SDK Mobile Ads به طور خودکار دادههای تحلیلی را برای رویدادهای in_app_purchase جمعآوری میکند. با این حال، اگر میخواهید دادههای رویداد ecommerce_purchase را نیز در محاسبه درآمد لحاظ کنید، باید از طریق Firebase SDK برای Google Analytics گزارشگیری سفارشی را پیادهسازی کنید.
در اینجا نحوه پیادهسازی ثبت وقایع سفارشی در برنامه شما آورده شده است:
مطمئن شوید که بخش « شروع به کار با Google Analytics این صفحه را تکمیل کردهاید، که شامل پیکربندی برنامه شما برای استفاده از فایربیس، افزودن کیت توسعه نرمافزار فایربیس برای Google Analytics و مقداردهی اولیه کیت توسعه نرمافزار است.
یک رویداد
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 Testing gives you the power to test changes to your app's UI, features, or engagement campaigns to learn if they make an impact on your key metrics (like revenue and retention) before rolling the changes out widely.
Optimize ad monetization for your app
Try out different ad formats or configurations with a small subset of users, and then make data driven decisions about implementing the ad for all your users. To learn more, check out the following tutorials:
Test new ad format adoption ( overview | implementation ).
Optimize ad frequency ( overview | implementation ).
After completing the basic AdMob setup, you can also add the Firebase SDK for Google Analytics to take advantage of other features from Google Analytics and Firebase. Learn how to get started with Google Analytics later on this page.
These increasing levels of configuration support features that can help you optimize your app's user experience and your ad revenue. Check out the following table of features and its links to learn more!
| ویژگی | Add Mobile Ads SDK + enable user metrics | Add Mobile Ads SDK + enable user metrics and Link AdMob to Firebase | Add Mobile Ads SDK + enable user metrics and Link AdMob to Firebase and Add Firebase SDK for Analytics |
| View user metrics in your AdMob account | |||
| Automatically collect analytics events and user properties from your app | |||
| View curated user metrics in AdMob | |||
| Explore and work with your analytics data via Firebase | |||
| View key metrics in the Firebase console | |||
| Mark conversions for ad campaigns | |||
| Build custom audiences | |||
| Export and analyze data in BigQuery | |||
| Access more customization features for your analytics data | |||
| Log custom events for analytics and models (like logging ecommerce_purchase events for ARPU and ARPPU metrics) | |||
| Configure custom conversions for ad campaigns | |||
| Use other Firebase products (like Remote Config and A/B Testing ) | |||
Get started with Google Analytics
Google Analytics is Firebase's analytics engine that gives you access to powerful insights into your data. Start using Google Analytics in your app by adding the Firebase SDK for Google Analytics .
With the basic AdMob setup , you can view aggregated statistics from automatically collected events and user properties in the Analytics dashboard of the Firebase console without adding any additional code to your app.
However, if you want to collect additional custom event data or user properties, you'll need to use the Firebase SDK for Google Analytics . With this SDK, you can log up to 500 different analytics event types, and there's no limit on the total volume of events your app logs. An example use case for logging custom events is to include data in your revenue calculation from a custom event called ecommerce_purchase to help you better represent ARPU and ARPPU metrics .
By adding the Firebase SDK for Google Analytics , you can also add custom conversions for ad campaigns and enable the use of other Firebase products .
The following steps describe how to start using the Firebase SDK for Google Analytics in your app. After initializing the SDK, visit the Analytics documentation to learn how to start logging events in your app.
Step 1: Add a configuration file to your app
If you registered your app with Firebase before creating an AdMob link, then you already added a Firebase configuration file to your app.Check for a GoogleService-Info.plist file in the root of your Xcode project. Also make sure that the config file is added to all targets.
In the Your apps card of your > Project settings , select the bundle ID of the app for which you need a config file.
Click Download GoogleService-Info.plist to obtain your Firebase iOS config file (
GoogleService-Info.plist).You can download your Firebase iOS config file again at any time from your > Project settings .
Make sure the config file name isn't appended with additional characters, like
(2).
Move your config file into the root of your Xcode project. If prompted, select to add the config file to all targets.
If you have multiple bundle IDs in your project, you must associate each bundle ID with a registered app in the Firebase console so that each app can have its own GoogleService-Info.plist file.
Step 2: Add the Firebase SDK for Analytics to your app
Add the dependency for the Firebase SDK for Google Analytics to your Podfile:
pod 'FirebaseAnalytics'Run
pod install, then open the created.xcworkspacefile.- Import the
FirebaseCoremodule in yourUIApplicationDelegate, as well as any other Firebase modules your app delegate uses. For example, to use Cloud Firestore and Authentication :سویفتیوآی
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
سویفت
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
هدف-سی
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- Configure a
FirebaseAppshared instance in your app delegate'sapplication(_:didFinishLaunchingWithOptions:)method:سویفتیوآی
// Use Firebase library to configure APIs FirebaseApp.configure()
سویفت
// Use Firebase library to configure APIs FirebaseApp.configure()
هدف-سی
// Use Firebase library to configure APIs [FIRApp configure];
- If you're using SwiftUI, you must create an application delegate and attach it to your
Appstruct viaUIApplicationDelegateAdaptororNSApplicationDelegateAdaptor. You must also disable app delegate swizzling. For more information, see the SwiftUI instructions .سویفتیوآی
@main struct YourApp: App { // register app delegate for Firebase setup @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate var body: some Scene { WindowGroup { NavigationView { ContentView() } } } }
Implement custom event logging
This section shows an example of how to implement custom event logging in your app. This specific example is for the custom event ecommerce_purchase which is a helpful event to log for AdMob -linked apps, especially for calculating ARPU and ARPPU .
A key metric for your app is revenue by user , which can be further segmented into ARPU and ARPPU . These two metrics display in the User metrics card of your AdMob account and in the Analytics dashboard of the Firebase console. Revenue, though, isn't directly measured; instead, it's the sum of your estimated AdMob earnings and the following two analytics event values:
-
in_app_purchase: when a user completes an in-app purchase that is processed by the App Store on iTunes, like an initial subscription, unlocking premium services, or buying in-game items
-
ecommerce_purchase: when a user completes a purchase, like online shopping, buying coupons or discount items, or buying movie tickets
Without any additional code in your app, the Mobile Ads SDK automatically collects analytics data for in_app_purchase events. However, if you want to also include ecommerce_purchase event data in the revenue calculation, you'll need to implement custom logging via the Firebase SDK for Google Analytics .
Here's how to implement custom event logging in your app:
Make sure that you've completed the Get started with Google Analytics section of this page, which includes configuring your app to use Firebase, adding the Firebase SDK for Google Analytics , and initializing the SDK.
Log an
ecommerce_purchaseevent ( Swift | Obj-C ). Here's an example:سویفت
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", }];
To learn more about logging custom events in your app, visit the Analytics documentation .
Use other Firebase products in your app
After you add the Firebase SDK for Google Analytics , you can also start using other Firebase products, like Firebase Remote Config and Firebase A/B Testing .
Remote Config enables you to change the behavior and appearance of your app without publishing an app update.
A/B Testing gives you the power to test changes to your app's UI, features, or engagement campaigns to learn if they make an impact on your key metrics (like revenue and retention) before rolling the changes out widely.
Optimize ad monetization for your app
Try out different ad formats or configurations with a small subset of users, and then make data driven decisions about implementing the ad for all your users. To learn more, check out the following tutorials:
Test new ad format adoption ( overview | implementation ).
Optimize ad frequency ( overview | implementation ).