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