1. مقدمه
آخرین به روز رسانی: 2020-12-14
چیزی که خواهی ساخت
در این کد لبه، نحوه پیاده‌سازی رویدادهای سفارشی با GA4F iOS SDK و راه‌اندازی کمپین‌های اکشن از طریق Google Ads را خواهید آموخت.
از طریق این کد لبه، می توانید کل فرآیند کسب و کار App را که مشتریان ما با آن روبرو هستند، تجربه کنید. اگر می‌خواهید مقدمه‌ای آرام‌تر با Firebase iOS یاد بگیرید، با Firebase iOS Codelab Swift شروع کنید.
چیزی که یاد خواهید گرفت
- نحوه اولیه سازی GA4F (Google Analytics برای Firebase) در iOS Swift
- نحوه ایجاد رویدادها و پارامترهای سفارشی
- نحوه وارد کردن رویدادها از Firebase به Google Ads
- کمپین های اکشن را با رویدادهای سفارشی راه اندازی کنید.
آنچه شما نیاز دارید
- Xcode
- حساب Firebase
- حساب Google Ads
2. یک پروژه جدید iOS Swift را شروع کنید
یک برنامه iOS Swift با قالب ساده ایجاد کنید. شما این برنامه شروع را تغییر دهید تا برنامه تمام شده ایجاد شود.
ابتدا Xcode را راه اندازی کنید.
- اگر پروژه‌های باز ندارید، از صفحه خوش‌آمدگویی Create a new Xcode project را انتخاب کنید.
- iOS را در بالای دیالوگ انتخاب کنید.
- در قسمت Application گزینه App را انتخاب کرده و سپس روی Next کلیک کنید.
- در گفتگوی ظاهر شده، از مقادیر زیر برای نامگذاری برنامه و انتخاب گزینه های اضافی برای پروژه خود استفاده کنید و روی Next کلیک کنید:
- نام محصول: به عنوان مثال ios-app
Xcode از نام محصولی که وارد کرده اید برای نامگذاری پروژه و برنامه خود استفاده می کند.
- تیم: اگر به صورت خودکار پر نشد، تیم را روی None قرار دهید.
- نام سازمان: نام سازمان یا نام خودتان.
- Bundle Identifier: این مقدار به طور خودکار بر اساس نام محصول و شناسه سازمان شما ایجاد می شود.
- زبان: سویفت
- مکانی را برای ذخیره پروژه خود انتخاب کنید و روی ایجاد کلیک کنید.
- Xcode پروژه جدید شما را در پنجره فضای کاری باز می کند.
3. یک پروژه Firebase ایجاد و راه اندازی کنید
برای شروع کار با Firebase، باید یک پروژه Firebase ایجاد و راه اندازی کنید.
یک پروژه Firebase ایجاد کنید
اگر پروژه Firebase موجودی دارید که Google Analytics را فعال نکرده است، می‌توانید Google Analytics را از برگه ادغام تنظیمات > تنظیمات پروژه فعال کنید. به مرحله پیکربندی Firebase بروید.
- وارد Firebase شوید.
در کنسول Firebase، روی افزودن پروژه (یا ایجاد پروژه) کلیک کنید و نام پروژه Firebase خود را Firebase-iOS-Ads بگذارید.
- روی گزینه های ایجاد پروژه کلیک کنید. در صورت درخواست، شرایط Firebase را بپذیرید. شما باید Google Analytics را برای این پروژه فعال کنید، زیرا به رویدادهای Google Analytics برای ردیابی رویدادها و تبدیل‌ها نیاز دارید.
برای کسب اطلاعات بیشتر درباره پروژه‌های Firebase، به درک پروژه‌های Firebase مراجعه کنید.
4. پیکربندی Firebase
- در Firebase Console، Project Overview > Project Settings را در ناوبری سمت چپ انتخاب کنید، سپس روی دکمه iOS در زیر General > Your Apps کلیک کنید.
دیالوگ نشان داده شده در صفحه زیر را خواهید دید.
- مقدار مهمی که باید ارائه کنید ID بسته نرم افزاری iOS است که با استفاده از مرحله زیر به دست خواهید آورد.
- در پروژه Xcode خود برای برنامه iOS، برنامه سطح بالا را در ناوبری پروژه انتخاب کنید، سپس برگه General را انتخاب کنید.
- مقدار فیلد Bundle Identifier ID بسته نرم افزاری iOS است (چیزی مانند
com.yourcompany.yourproject). این مقدار را کپی کنید. - در گفتگوی Firebase، شناسه بسته کپی شده را در قسمت
iOS bundle IDجایگذاری کنید. - روی ثبت برنامه کلیک کنید.
- در ادامه در Firebase، دستورالعمل‌ها را برای دانلود فایل پیکربندی
GoogleService-Info.plistدنبال کنید.
- به پروژه Xcode خود بروید، سپس فایل
GoogleService-Info.plist(که به تازگی دانلود کرده اید) را به ریشه پروژه Xcode خود منتقل کنید. - مراحل باقی مانده را رد کنید و به صفحه اصلی کنسول Firebase برگردید.
5. Firebase Analytics را در Xcode پیکربندی کنید
در این مرحله، شروع به اضافه کردن Firebase SDK به پروژه Xcode خود می‌کنید.
- یک پنجره ترمینال باز کنید و به محل پروژه Xcode برای برنامه خود بروید.
- اگر پادفایل ندارید ایجاد کنید:
$ pod init
- پادفایل خود را باز کنید و اضافه کنید:
$ vi Podfile
$ pod 'Firebase/Analytics' 
- فایل را ذخیره کرده و اجرا کنید:
$ pod install
- کد اولیه را اضافه کنید:
برای اتصال Firebase هنگام راه‌اندازی برنامه، کد اولیه‌سازی زیر را به کلاس اصلی AppDelegate خود اضافه کنید.
import UIKit
import Firebase
@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {
var window: UIWindow?
func application(_ application: UIApplication,
didFinishLaunchingWithOptions launchOptions:
[UIApplicationLaunchOptionsKey: Any]?) -> Bool {
FirebaseApp.configure()
return true
}
}
- شما آماده اید! به کنسول ادامه دهید.
اکنون برای شلیک برخی از گزارش‌های رویداد سفارشی آماده هستید!
6. ثبت رویدادهای سفارشی با Firebase Analytics
در این مرحله یاد خواهید گرفت که چگونه رویدادهای سفارشی را با Firebase Analytics در اپلیکیشن iOS ثبت کنید.
Firebase Analytics به طور خودکار برخی از رویدادها را برای شما ثبت می کند. برای دریافت آنها نیازی به افزودن کد ندارید. اگر برنامه شما نیاز به جمع‌آوری داده‌های اضافی دارد، می‌توانید تا 500 نوع رویداد سفارشی Analytics مختلف را در برنامه خود ثبت کنید.
ثبت رویدادها
پس از پیکربندی نمونه FirebaseApp، می‌توانید با متد logEvent() ثبت رویدادها را شروع کنید.
Analytics.logEvent("text_search", parameters: [
"name": name as NSObject,
"full_text": text as NSObject
])
پارامترهای رویداد پیش فرض را تنظیم کنید
با استفاده از setDefaultEventParameters می توانید پارامترها را در رویدادها ثبت کنید. پارامترهای پیش‌فرض با تمام رویدادهای آینده که ثبت می‌شوند مرتبط هستند.
Analytics.setDefaultEventParameters([
"level_name": "Caverns01",
"level_difficulty": 4
])
رویدادها را در کنسول رفع اشکال Xcode مشاهده کنید
می‌توانید گزارش‌دهی دقیق را برای نظارت بر ثبت رویدادها توسط SDK فعال کنید تا به تأیید اینکه رویدادها به درستی ثبت می‌شوند کمک کند. این شامل رویدادهای ثبت شده به صورت خودکار و دستی می شود.
به صورت زیر می‌توانید گزارش کامل را فعال کنید:
- در Xcode، Product > Scheme > Edit scheme را انتخاب کنید...
- از منوی سمت چپ Run را انتخاب کنید.
- تب Arguments را انتخاب کنید.
- در بخش Arguments Passed On Launch ، -FIRAnalyticsDebugEnabled را اضافه کنید.
دفعه بعد که برنامه خود را اجرا می کنید، رویدادهای شما در کنسول اشکال زدایی Xcode نمایش داده می شود و به شما کمک می کند فوراً تأیید کنید که رویدادها ارسال می شوند.
رویدادها را در داشبورد مشاهده کنید
بعد از چند ساعت رویداد ثبت شده خود را در کنسول Firebase خواهید دید. در Analytics → Events قرار دارد. همچنین می توانید مقادیر پارامترها را با کلیک کردن روی رویداد بیابید.
با کشیدن سوئیچ علامت گذاری به عنوان تبدیل به سمت راست، 'text_search' را به عنوان تبدیل علامت گذاری خواهید کرد.
می‌توانید از طریق تب Firebase Analytics Conversions دوباره بررسی کنید که آیا رویداد با موفقیت به عنوان تبدیل علامت‌گذاری شده است. با علامت گذاری رویداد به عنوان تبدیل، Google Ads می تواند رویداد را به عنوان تبدیل وارد کند.
7. وارد کردن رویدادهای تجزیه و تحلیل در گوگل ادز
راه اندازی Firebase-iOS شما به پایان رسیده است، و شما آماده راه اندازی کمپین برنامه با رویدادهای اقدام ثبت شده هستید. شما با پیوند Firebase به Google Ads شروع می کنید. با پیوند Firebase به Google Ads، کمپین‌های برنامه می‌توانند اطلاعات بیشتری درباره مخاطبان کسب کنند و یادگیری کمپین برنامه را تقویت کنند، که معمولاً منجر به عملکرد و تبدیل بهتر می‌شود.
- با کلیک کردن روی دکمه درست در کنار نمای کلی پروژه، به تنظیمات Firebase بروید.
- در تب ادغام، تبلیغات گوگل و دکمه پیوند را مشاهده خواهید کرد. روی پیوند و ادامه کلیک کنید.
- حساب Google Ads را انتخاب کنید.
اکنون قسمت Firebase انجام شده است.
اکنون به Google Ads بروید و وارد شوید.
- به Google Ads بروید و وارد شوید و به Tools & Settings → Measurement → Conversions برای وارد کردن رویدادهای سفارشی به عنوان تبدیل بروید.
- برای افزودن عمل تبدیل جدید روی دکمه + کلیک کنید.
- ویژگی های Google Analytics 4 (Firebase) را انتخاب کنید و روی ادامه کلیک کنید.
- می‌توانید همه رویدادهای تحلیلی را که به‌عنوان تبدیل علامت‌گذاری شده‌اند، ببینید. رویداد
clicked_counterرا که قبلا اجرا کرده بودیم پیدا کنید.
- تیک بزنید و روی دکمه Import and Continue کلیک کنید.
پس از تنظیم text_search به عنوان یک اقدام تبدیل، اکنون زمان راه‌اندازی کمپینی است که کاربرانی را هدف قرار می‌دهد که احتمالا رویدادهای text_search را فعال می‌کنند.
8. راه اندازی کمپین های اکشن اپلیکیشن با رویدادهای وارداتی
- به تب کمپین حساب فعلی خود بروید و با کلیک روی دکمه + کمپین جدیدی را شروع کنید. روی کمپین جدید کلیک کنید و ادامه دهید.
- برای این زمان، ما یک کمپین تبلیغاتی برنامه با گزینه نصب برنامه راه اندازی خواهیم کرد.
- با ارائه نام برنامه، نام بسته یا ناشر، برنامه خود را پیدا کنید.
- در بخش مناقصه، کنش‌های درون برنامه‌ای را در dropbox برای تبلیغات انتخاب کنید تا روی کنش‌ها تمرکز کنند.
- می توانید رویدادهای سفارشی خود را در لیست ارائه شده بیابید. هزینه هدف برای هر اقدام را تنظیم کنید و گزینه های دیگر را نیز پر کنید.
- تنظیمات کمپین را پیکربندی کنید این فراتر از محدوده Codelab خواهد بود، بنابراین به این اسناد مراجعه کنید یا از طریق هر کانال دیگری برای بهینه سازی تنظیمات تماس بگیرید.
9. تبریک می گویم
تبریک می‌گوییم، شما با موفقیت Firebase و Google Ads خود را ادغام کردید! این به شما کمک می کند تا عملکرد کمپین خود را افزایش دهید.
شما اسکریپت را نصب کردید، یک لیست تغییرات Codelab جدید ایجاد و مرحله بندی کردید، لیست تغییرات Codelab معلق را به روز کردید و مرحله بندی کردید، لیست تغییرات Codelab را بررسی و تایید کردید، و لیست تغییرات Codelab را ارسال و منتشر کردید.
تو یاد گرفتی
- نحوه پیکربندی Firebase برای iOS
- نحوه ثبت رویدادهای سفارشی با iOS و Firebase Analytics
- نحوه وارد کردن رویدادها و استفاده از آن برای کمپین های اکشن