۱. مقدمه
آخرین بهروزرسانی: ۲۰۲۰-۱۲-۱۴
آنچه خواهید ساخت
در این آزمایشگاه کد، شما یاد خواهید گرفت که چگونه رویدادهای سفارشی را با GA4F iOS SDK پیادهسازی کنید و از طریق Google Ads کمپینهای اکشن راهاندازی کنید.
از طریق این codelab، میتوانید کل فرآیند کسب و کار اپلیکیشن را که مشتریان ما با آن مواجه هستند، تجربه کنید. اگر میخواهید مقدمهای ملایمتر برای Firebase iOS بیاموزید، با Firebase iOS Codelab Swift شروع کنید.
آنچه یاد خواهید گرفت
- نحوه مقداردهی اولیه GA4F (گوگل آنالیتیکس برای فایربیس) در iOS Swift
- نحوه ایجاد رویدادها و پارامترهای سفارشی.
- نحوه وارد کردن رویدادها از Firebase به Google Ads
- کمپینهای اکشن را با رویدادهای سفارشی راهاندازی کنید.
آنچه نیاز دارید
- ایکسکد
- حساب فایربیس
- حساب کاربری گوگل ادز
۲. یک پروژه جدید iOS Swift را شروع کنید
یک برنامه iOS Swift با قالب ساده ایجاد کنید. شما این برنامه اولیه را برای ایجاد برنامه نهایی تغییر میدهید.
ابتدا، Xcode را اجرا کنید.
- اگر پروژههای باز ندارید، از صفحه خوشامدگویی، گزینه «ایجاد یک پروژه Xcode جدید» را انتخاب کنید.
- در بالای پنجره، iOS را انتخاب کنید.
- در بخش Application، گزینه App را انتخاب کرده و سپس روی Next کلیک کنید.
- در پنجرهای که ظاهر میشود، از مقادیر زیر برای نامگذاری برنامه خود و انتخاب گزینههای اضافی برای پروژه خود استفاده کنید و روی Next کلیک کنید:
- نام محصول: eg ios-app
Xcode از نام محصولی که وارد کردهاید برای نامگذاری پروژه و برنامه شما استفاده میکند.
- تیم: اگر این قسمت به طور خودکار پر نشده است، تیم را روی «هیچکدام» تنظیم کنید.
- نام سازمان: نام سازمان شما یا نام خودتان.
- شناسه بسته: این مقدار به طور خودکار بر اساس نام محصول و شناسه سازمان شما تولید میشود.
- زبان: سویفت
- مکانی را برای ذخیره پروژه خود انتخاب کنید و روی ایجاد کلیک کنید.
- Xcode پروژه جدید شما را در پنجره فضای کاری باز میکند.
۳. ایجاد و راهاندازی یک پروژه Firebase
برای شروع کار با Firebase، باید یک پروژه Firebase ایجاد و راهاندازی کنید.
ایجاد یک پروژه فایربیس
اگر یک پروژه Firebase دارید که Google Analytics در آن فعال نیست، میتوانید Google Analytics را از تب Integrations در تنظیمات > تنظیمات پروژه فعال کنید. به مرحله پیکربندی Firebase بروید.
- وارد فایربیس شوید.
در کنسول فایربیس، روی افزودن پروژه (یا ایجاد پروژه) کلیک کنید و نام پروژه فایربیس خود را Firebase-iOS-Ads بگذارید.
- روی گزینههای ایجاد پروژه کلیک کنید. در صورت درخواست، شرایط Firebase را بپذیرید. شما باید Google Analytics را برای این پروژه فعال کنید، زیرا برای ردیابی رویدادهای عملی و تبدیلها به رویدادهای Google Analytics نیاز دارید.
برای کسب اطلاعات بیشتر در مورد پروژههای فایربیس، به بخش «درک پروژههای فایربیس» مراجعه کنید.
۴. پیکربندی فایربیس
- در کنسول فایربیس، در منوی سمت چپ، Project Overview > Project Settings را انتخاب کنید، سپس در قسمت General > Your apps روی دکمه iOS کلیک کنید.
کادر محاورهای نشان داده شده در صفحه زیر را مشاهده خواهید کرد.
- مقدار مهمی که باید ارائه دهید، شناسه بسته iOS است که با استفاده از مرحله زیر به دست خواهید آورد.
- در پروژه Xcode خود برای اپلیکیشن iOS، اپلیکیشن سطح بالا را در پیمایشگر پروژه انتخاب کنید، سپس تب General را انتخاب کنید.
- مقدار فیلد Bundle Identifier، شناسه بسته iOS است (چیزی شبیه
com.yourcompany.yourproject). این مقدار را کپی کنید. - در پنجرهی فایربیس، شناسهی بستهی کپیشده را در فیلد
iOS bundle IDقرار دهید. - روی ثبت برنامه کلیک کنید.
- در ادامه در Firebase، دستورالعملها را برای دانلود فایل پیکربندی
GoogleService-Info.plistدنبال کنید.
- به پروژه Xcode خود بروید، سپس فایل
GoogleService-Info.plist(که به تازگی دانلود کردهاید) را به ریشه پروژه Xcode خود منتقل کنید. - مراحل باقی مانده را رد کنید و به صفحه اصلی کنسول Firebase برگردید.
۵. پیکربندی Firebase Analytics در Xcode
در این مرحله، شروع به اضافه کردن Firebase SDK به پروژه Xcode خود خواهید کرد.
- یک پنجره ترمینال باز کنید و به محل پروژه Xcode مربوط به برنامه خود بروید.
- اگر Podfile ندارید، آن را ایجاد کنید:
$ pod init
- Podfile خود را باز کنید و موارد زیر را اضافه کنید:
$ 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
}
}
- همه چیز آماده است! به دلداری دادن ادامه بده.
حالا شما آمادهی ایجاد چند گزارش رویداد سفارشی هستید!
۶. ثبت رویدادهای سفارشی با Firebase Analytics
در این مرحله، نحوه ثبت رویدادهای سفارشی با Firebase Analytics در برنامه iOS را خواهید آموخت.
فایربیس آنالیتیکس به طور خودکار برخی رویدادها را برای شما ثبت میکند؛ برای دریافت آنها نیازی به اضافه کردن هیچ کدی ندارید. اگر برنامه شما نیاز به جمعآوری دادههای اضافی دارد، میتوانید تا ۵۰۰ نوع رویداد سفارشی آنالیتیکس مختلف را در برنامه خود ثبت کنید.
ثبت رویدادها
پس از پیکربندی نمونه 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
شما میتوانید ثبت وقایع به صورت کامل (verbose logging) را فعال کنید تا ثبت وقایع توسط SDK را رصد کنید و از صحت ثبت وقایع اطمینان حاصل کنید. این شامل وقایع ثبت شده به صورت خودکار و دستی میشود.
شما میتوانید ثبت وقایع شفاهی (verbose logging) را به صورت زیر فعال کنید:
- در Xcode، مسیر Product > Scheme > Edit scheme... را انتخاب کنید.
- از منوی سمت چپ، گزینه اجرا (Run) را انتخاب کنید.
- برگه آرگومانها را انتخاب کنید.
- در بخش Arguments Passed On Launch ، عبارت -FIRAnalyticsDebugEnabled را اضافه کنید.
دفعهی بعدی که برنامهی خود را اجرا میکنید، رویدادهای شما در کنسول اشکالزدایی Xcode نمایش داده میشوند و به شما کمک میکنند تا فوراً تأیید کنید که رویدادها ارسال میشوند.
مشاهده رویدادها در داشبورد
رویداد ثبتشدهی خود را چند ساعت دیگر در کنسول Firebase مشاهده خواهید کرد. این رویداد در مسیر Analytics → Events قرار دارد. همچنین میتوانید با کلیک روی رویداد، مقادیر پارامترها را پیدا کنید.
شما میتوانید با کشیدن دکمهی «mark as conversion» به سمت راست، «text_search» را به عنوان تبدیل علامتگذاری کنید.
میتوانید از طریق تب تبدیلات فایربیس آنالیتیکس، بررسی کنید که آیا رویداد با موفقیت به عنوان تبدیل علامتگذاری شده است یا خیر. با علامتگذاری رویداد به عنوان تبدیل، گوگل ادز نیز میتواند آن رویداد را به عنوان یک تبدیل وارد کند.
۷. وارد کردن رویدادهای تحلیلی در گوگل ادز
راهاندازی Firebase-iOS شما به پایان رسیده است و آمادهاید تا کمپین اپلیکیشن را با رویدادهای ثبتشده راهاندازی کنید. کار را با پیوند دادن Firebase به Google Ads شروع خواهید کرد. با پیوند دادن Firebase به Google Ads، کمپینهای اپلیکیشن قادر خواهند بود اطلاعات بیشتری در مورد مخاطبان کسب کنند و یادگیریهای کمپین اپلیکیشن را افزایش دهند که معمولاً منجر به عملکرد و تبدیلهای بهتر میشود.
- با کلیک روی دکمهای که درست کنار نمای کلی پروژه قرار دارد، به تنظیمات فایربیس بروید.
- در تب Integrations، تبلیغات گوگل و دکمهی Link را مشاهده خواهید کرد. روی Link کلیک کنید و ادامه دهید.
- حساب کاربری گوگل ادز را انتخاب کنید.
حالا بخش Firebase تمام شده است.
حالا، به گوگل ادز بروید و وارد شوید.
- به گوگل ادز بروید و وارد شوید، و برای وارد کردن رویدادهای سفارشی به عنوان تبدیل، به ابزارها و تنظیمات → اندازهگیری → تبدیلها بروید.
- برای افزودن اقدام تبدیل جدید، روی دکمه + کلیک کنید.
- ویژگیهای Google Analytics 4 (Firebase) را انتخاب کنید و روی ادامه کلیک کنید.
- میتوانید تمام رویدادهای تحلیلی که به عنوان تبدیل علامتگذاری شدهاند را مشاهده کنید. رویداد
clicked_counterرا که قبلاً پیادهسازی کردیم، پیدا کنید.
- تیک بزنید و روی دکمهی «وارد کردن و ادامه» کلیک کنید.
پس از تنظیم text_search به عنوان یک اقدام تبدیل، اکنون زمان راهاندازی کمپینی است که کاربرانی را هدف قرار میدهد که احتمالاً رویدادهای text_search فعال میکنند.
۸. راهاندازی کمپینهای اکشن اپلیکیشن با رویدادهای وارد شده
- به برگه کمپین حساب فعلی خود بروید و با کلیک روی دکمه +، یک کمپین جدید شروع کنید. روی کمپین جدید کلیک کنید و ادامه دهید.
- برای این زمان، ما یک کمپین تبلیغاتی اپلیکیشن با گزینه نصب اپلیکیشن راهاندازی خواهیم کرد.
- با ارائه نام برنامه، نام بسته یا ناشر، برنامه خود را پیدا کنید.
- در بخش پیشنهاد قیمت، در کادر دراپ باکس، گزینه «اقدامات درون برنامهای» را انتخاب کنید تا تبلیغات روی اقدامات متمرکز شوند.
- میتوانید رویدادهای سفارشی خود را در لیست ارائه شده پیدا کنید. هزینه هدف برای هر اقدام را تعیین کنید و گزینههای دیگر را نیز پر کنید.
- تنظیمات کمپین را پیکربندی کنید. این کار فراتر از محدوده codelab خواهد بود، بنابراین برای بهینهسازی تنظیمات به این اسناد مراجعه کنید یا از طریق هر کانال دیگری با ما تماس بگیرید.
۹. تبریک
تبریک میگویم، شما با موفقیت فایربیس و گوگل ادز خود را ادغام کردید! این به شما کمک میکند تا عملکرد کمپین خود را افزایش دهید.
شما اسکریپت را نصب کردید، یک لیست تغییرات جدید codelab ایجاد و استیج کردید، لیست تغییرات codelab در حال بررسی را بهروزرسانی و استیج کردید، لیست تغییرات codelab را بررسی و تأیید کردید، و لیست تغییرات codelab را ارسال و منتشر کردید.
یاد گرفتی.
- نحوه پیکربندی فایربیس برای iOS
- نحوه ثبت رویدادهای سفارشی با iOS و Firebase Analytics
- نحوه وارد کردن رویدادها و استفاده از آن برای کمپینهای اکشن.