1. مقدمه
آخرین به روز رسانی: 2021-02-19
چیزی که خواهی ساخت
در این کد لبه، نحوه پیاده‌سازی رویدادهای سفارشی با GA4F iOS در محیط Unity و راه‌اندازی کمپین‌های اکشن از طریق Google Ads را خواهید آموخت.
در سراسر این نرم افزار کد، می توانید کل فرآیند کسب و کار App را که مشتریان ما با آن روبرو هستند، تجربه کنید. اگر می‌خواهید مقدمه‌ای آرام‌تر با Firebase و Admob در iOS بیاموزید، با AdMob+Firebase 101 Unity: Setup & Analytics Basics شروع کنید.
چیزی که یاد خواهید گرفت
- نحوه اولیه سازی GA4F (Google Analytics برای Firebase) در Unity + iOS.
- نحوه ایجاد رویدادها و پارامترهای سفارشی
- نحوه وارد کردن رویدادها از Firebase به Google Ads.
- کمپین های اکشن را با رویدادهای سفارشی راه اندازی کنید.
آنچه شما نیاز دارید
- Xcode
- وحدت
- حساب Firebase
- حساب Google Ads
2. یک پروژه یونیتی جدید را شروع کنید
یک برنامه Unity با قالب ساده ایجاد کنید. شما این برنامه ساده را برای ایجاد برنامه تمام شده تغییر دهید.
Unity را راه اندازی کنید
- اگر پروژه های باز ندارید، ایجاد پروژه جدید را انتخاب کنید.
- الگوهای سه بعدی را از کادر گفتگو انتخاب کنید.
- نام پروژه را پر کنید: به عنوان مثال رویداد سفارشی Unity Firebase.
- یک مکان برای ذخیره پروژه خود انتخاب کنید و روی CREATE کلیک کنید.
- یونیتی پروژه جدید شما را در پنجره فضای کاری باز می کند.
3. یک پروژه Firebase ایجاد و راه اندازی کنید
برای شروع کار با Firebase، باید یک پروژه Firebase ایجاد و راه اندازی کنید.
اگر پروژه Firebase موجودی دارید که Google Analytics را فعال نکرده است، می‌توانید Google Analytics را از برگه ادغام تنظیمات > تنظیمات پروژه فعال کنید. به مرحله پیکربندی Firebase بروید.
- وارد Firebase شوید.
در کنسول Firebase، روی افزودن پروژه (یا ایجاد پروژه) کلیک کنید و نام پروژه Firebase خود را Firebase-iOS-Ads بگذارید.
- روی گزینه های ایجاد پروژه کلیک کنید. در صورت درخواست، شرایط Firebase را بپذیرید. شما باید Google Analytics را برای این پروژه فعال کنید، زیرا به رویدادهای Google Analytics برای ردیابی رویدادها و تبدیل‌ها نیاز دارید.
برای کسب اطلاعات بیشتر درباره پروژه‌های Firebase، به درک پروژه‌های Firebase مراجعه کنید.
4. پیکربندی یونیتی
- در Unity > File > Build Settings. مقدار مهم تنظیم ID بسته نرم افزاری iOS است که با استفاده از مرحله زیر به دست می آورید.
دیالوگ نشان داده شده در صفحه زیر را خواهید دید.
- در پروژه یونیتی خود برای برنامه iOS، گفتگوی Build Settings را باز کنید، File > Build Settings (اگر پلتفرم روی iOS تنظیم نشده باشد، می توانید iOS Platform را انتخاب کنید و روی دکمه Switch Platform کلیک کنید)
- پس از تغییر پلتفرم روی دکمه تنظیمات پخش کننده کلیک کنید تا شناسه بسته تنظیم شود. می توانید فیلد متنی را در اطراف ناحیه شناسایی مشاهده کنید.
- مقدار فیلد Bundle Identifier ID بسته نرم افزاری iOS است (چیزی مانند
com.yourcompany.yourproject). این مقدار را کپی کنید یا مقدار خود را تنظیم کنید و آن را کپی کنید. - در گفتگوی Firebase، شناسه بسته کپی شده را در قسمت
iOS bundle IDجایگذاری کنید. - روی ثبت برنامه کلیک کنید.
- در ادامه در Firebase، دستورالعمل‌ها را برای دانلود فایل پیکربندی
GoogleService-Info.plistدنبال کنید. - پنجره Project پروژه Unity خود را باز کنید، سپس فایل(های) پیکربندی خود را به پوشه Assets منتقل کنید.
- مراحل باقی مانده را رد کنید و به صفحه اصلی کنسول Firebase برگردید.
5. Firebase Analytics را در Unity پیکربندی کنید
در این مرحله شروع به اضافه کردن Firebase SDK به پروژه Unity خود می کنید.
- به کنسول Firebase بروید.
- در مرکز صفحه نمای کلی پروژه، روی نماد Unity کلیک کنید (
) برای راه اندازی گردش کار راه اندازی. اگر قبلاً برنامه‌ای را به پروژه Firebase خود اضافه کرده‌اید، روی افزودن برنامه کلیک کنید تا گزینه‌های پلتفرم نمایش داده شوند. - هدف ساخت پروژه یونیتی خود را که می‌خواهید ثبت کنید انتخاب کنید، یا حتی می‌توانید هر دو هدف را هم‌اکنون ثبت کنید.
- شناسه(های) پلتفرم خاص پروژه Unity خود را وارد کنید.
- برای iOS — شناسه iOS پروژه Unity خود را در قسمت ID بسته نرم افزاری iOS وارد کنید.
- برای اندروید — شناسه اندروید پروژه Unity خود را در قسمت نام بسته اندروید وارد کنید. اصطلاحات نام بسته و شناسه برنامه اغلب به جای یکدیگر استفاده می شوند.
- شناسه پروژه یونیتی خود را از کجا پیدا می کنید؟
- (اختیاری) نام مستعار پلتفرم خاص پروژه Unity خود را وارد کنید. این نام‌های مستعار، شناسه‌های راحتی هستند و فقط در کنسول Firebase برای شما قابل مشاهده هستند.
- روی ثبت برنامه کلیک کنید.
افزودن Firebase Analytics Unity SDK
- در کنسول Firebase، روی Download Firebase Unity SDK کلیک کنید، سپس SDK را در جایی مناسب از حالت فشرده خارج کنید.
- می‌توانید Firebase Unity SDK را دوباره در هر زمانی دانلود کنید.
- Firebase Unity SDK مخصوص پلتفرم نیست.
- در پروژه Unity باز خود، به Assets > Import Package > Custom Package بروید.
- از SDK خارج‌شده، محصولات Firebase پشتیبانی‌شده را که می‌خواهید در برنامه خود استفاده کنید، انتخاب کنید.
- بسته Firebase را برای Google Analytics اضافه کنید: FirebaseAnalytics.unitypackage
- بسته‌ها را برای سایر محصولات Firebase که می‌خواهید در برنامه خود استفاده کنید، اضافه کنید. به عنوان مثال، برای استفاده از Firebase Authentication و Firebase Realtime Database: FirebaseAuth.unitypackage و FirebaseDatabase.unitypackage
- در پنجره Import Unity Package ، روی Import کلیک کنید.
- در کنسول Firebase، در گردش کار راه اندازی، روی Next کلیک کنید.
6. ثبت رویدادهای سفارشی با Firebase Analytics
در این مرحله، نحوه ثبت رویدادهای سفارشی با Firebase Analytics در اپلیکیشن Unity iOS را خواهید آموخت.
Firebase Analytics به طور خودکار برخی از رویدادها را برای شما ثبت می کند. برای دریافت آنها نیازی به افزودن کد ندارید. اگر برنامه شما نیاز به جمع‌آوری داده‌های اضافی دارد، می‌توانید تا 500 نوع رویداد سفارشی Analytics مختلف را در برنامه خود ثبت کنید.
ثبت رویدادها
پس از پیکربندی نمونه FirebaseApp، می‌توانید با متد logEvent() ثبت رویدادها را شروع کنید.
Firebase.Analytics.FirebaseAnalytics.LogEvent("text_search", name, text);
رویدادها را در کنسول رفع اشکال 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 خود را با Unity و Google Ads ادغام کردید! این به شما کمک می کند تا عملکرد کمپین خود را افزایش دهید.
تو یاد گرفتی
- نحوه پیکربندی Firebase برای پلتفرم Unity iOS
- نحوه ثبت رویدادهای سفارشی با Unity و Firebase Analytics
- نحوه وارد کردن رویدادها و استفاده از آن برای کمپین های اکشن