1. مقدمه
آخرین به روز رسانی: 2020-12-14
چیزی که خواهی ساخت
در این کد، نحوه پیاده‌سازی رویدادها با Google Analytics for Firebase (GA4F) و راه‌اندازی کمپین‌های اکشن از طریق Google Ads را خواهید آموخت.
این آزمایشگاه کد روی پیاده‌سازی رویدادها با GA4F و وارد کردن رویدادها در Google Ads تمرکز دارد. اگر می خواهید یاد بگیرید که چگونه یک برنامه اندرویدی با Firebase بسازید، لطفاً به Firebase Android Codelab-Build Friendly Chat مراجعه کنید.
چیزی که یاد خواهید گرفت
- نحوه ایجاد پروژه Firebase
- نحوه پیاده سازی Firebase SDK در برنامه اندروید
- نحوه ایجاد رویدادها و پارامترها
- نحوه وارد کردن رویدادها از Firebase به Google Ads
- کمپین های اقدام Google Ads را با رویدادهای سفارشی راه اندازی کنید.
آنچه شما نیاز دارید
- اندروید استودیو 3.6 یا بالاتر
- حساب Firebase
- حساب Google Ads
2. یک پروژه Firebase ایجاد و راه اندازی کنید
برای شروع کار با Firebase، باید یک پروژه Firebase ایجاد و راه اندازی کنید.
یک پروژه Firebase ایجاد کنید
- وارد Firebase شوید.
در کنسول Firebase، روی Add Project (یا Create a project) کلیک کنید و نام پروژه Firebase خود را همانطور که می خواهید نام گذاری کنید.
- روی گزینه های ایجاد پروژه کلیک کنید. در صورت درخواست، شرایط Firebase را بپذیرید. شما باید Google Analytics را برای این پروژه فعال کنید، زیرا به رویدادهای Google Analytics برای ردیابی رویدادها و تبدیل‌ها نیاز دارید.
برای کسب اطلاعات بیشتر درباره پروژه‌های Firebase، به درک پروژه‌های Firebase مراجعه کنید.
- حساب Google Analytics را انتخاب کنید. اگر یکی دارید آن یکی را انتخاب کنید یا یک مورد جدید ایجاد کنید. روی دکمه Create project کلیک کنید.
- اکنون ساخت پروژه Firebase به پایان رسیده است!
در مرحله بعد، یاد می گیرید که چگونه Firebase را به برنامه اندروید خود اضافه کنید.
3. Firebase را به برنامه اندروید خود اضافه کنید
ثبت برنامه
- در کنسول Firebase، Project Overview را در ناوبری سمت چپ انتخاب کنید، سپس روی دکمه Android در زیر «شروع با افزودن Firebase به برنامه خود» کلیک کنید.
- اطلاعات لازم را پر کنید
برای نام بسته Android، در استودیو Android به فهرست برنامه بروید، نام فایل build.gradle باز کنید. در فایل، applicationId را جستجو کنید. این مقدار نام بسته اندروید است. این مقدار را کپی و پیست کنید.
ما در اینجا به کلید SHA-1 نیاز نداریم، مگر اینکه قصد استفاده از پیوندهای دینامیک ورود به سیستم Google یا Firebase را داشته باشید (توجه داشته باشید که اینها بخشی از این کد لبه نیستند، برای اطلاعات بیشتر در مورد کلید SHA-1، لطفاً به این سند مراجعه کنید.) .
- روی دکمه ثبت برنامه کلیک کنید.
دانلود فایل کانفیگ
- برای دانلود فایل پیکربندی google
google-services.jsonکلیک کنید.
- در استودیو اندروید، به فهرست
appبروید و فایلgoogle-services.json(که در بالا دانلود کردید) را به فهرستappمنتقل کنید. به کنسول Firebase برگردید، روی دکمه Next کلیک کنید.
Firebase را در برنامه خود فعال کنید
- برای خواندن فایل
google-services.jsonکه توسط Firebase ایجاد شده است، به افزونه Google Services Gradle نیاز دارید. - در Android Studio،
<project>/build.gradleرا باز کنید، سپس خطوط زیر را در فایل اضافه کنید:
buildscript {
repositories {
// Check that you have the following line (if not, add it):
google() //Google's Maven repository
}
dependencies {
...
// Add this line
classpath 'com.google.gms:google-services:4.3.4'
}
}
allprojects {
...
repositories {
// Check that you have the following line (if not, add it):
google() //Google's Maven repository
...
}
}
}
-
<project>/<app-module>/build.gradleرا باز کنید، سپس خطوط زیر را در فایل اضافه کنید:
apply plugin: 'com.android.application'
// Add this line
apply plugin: 'com.google.gms.google-services'
اکنون، افزودن Firebase به برنامه Android خود را تکمیل کرده اید!
در مرحله بعد، یاد خواهید گرفت که چگونه Firebase SDK را به برنامه خود اضافه کنید.
4. Firebase SDK را به برنامه خود اضافه کنید
در این مرحله، Firebase SDK، به طور خاص Firebase SDK برای Google Analytics را اضافه خواهید کرد.
ما از Firebase Android BoM استفاده می کنیم که به شما امکان می دهد نسخه های کتابخانه Firebase را که در برنامه خود استفاده می کنید با تعیین نسخه BoM مدیریت کنید. برای اینکه بدانید کدام نسخه‌های کتابخانه Firebase به یک نسخه BoM خاص نگاشت شده‌اند، یادداشت‌های انتشار آن نسخه BoM را بررسی کنید.
-
<project>/<app-module>/build.gradleرا باز کنید، سپس خطوط زیر را در فایل اضافه کنید:
dependencies {
// ...
//Import the Firebase BoM
implementation platform('com.google.firebase:firebase-bom:26.1.1')
//Declare the dependency for the Firebase SDK for Google Analytics
implementation 'com.google.firebase:firebase-analytics-ktx'
همانطور که می بینید، با مشخص کردن نسخه BoM، نیازی به تعیین نسخه کتابخانه تجزیه و تحلیل firebase نیست. اما اگر می خواهید از نسخه مورد نظر برای کتابخانه Firebase خود استفاده کنید بدون توجه به اینکه کدام نسخه در BoM تعیین شده است، فقط باید نسخه مورد نظر را به صورت زیر مشخص کنید:
dependencies {
// ...
//Import the Firebase BoM
implementation platform('com.google.firebase:firebase-bom:26.1.1')
//Declare the dependency for the Firebase SDK for Google Analytics
implementation 'com.google.firebase:firebase-analytics-ktx:17.0.0'
- اکنون برنامه خود را با کلیک بر روی دکمه
Sync Nowهمگام کنید.
اکنون، افزودن Firebase SDK برای Google Analytics را به برنامه Android خود تکمیل کرده‌اید!
در مرحله بعد، یاد خواهید گرفت که چگونه رویدادهای Firebase را در برنامه اندروید خود ثبت کنید.
5. ثبت رویدادها با Firebase Analytics
در این مرحله یاد خواهید گرفت که چگونه رویدادها را با Firebase Analytics در برنامه اندروید ثبت کنید.
2 راه برای ثبت رویدادها وجود دارد: استفاده از رویدادهای پیشنهادی یا رویدادهای سفارشی.
استفاده از رویدادهای پیشنهادی
Firebase Analytics SDK تعدادی رویداد پیشنهادی را تعریف می کند که می توانند در انواع مختلف برنامه ها مانند بازی، خرده فروشی، مسافرت و تجارت الکترونیک استفاده شوند. همچنین برخی رویدادهای پیشنهادی وجود دارد که به پارامترهای تعیین شده آن نیاز دارند و با آن پارامترها می توانید جزئیات موجود را در گزارش های Firebase خود به حداکثر برسانید. ( مرجع رویدادهای پیشنهادی )
- شی FirebaseAnalytics را در بالای فعالیت اعلام کنید:
private lateinit var firebaseAnalytics: FirebaseAnalytics
- شی را در متد
onCreate()راه اندازی کنید:
firebaseAnalytics = Firebase.analytics
- ثبت رویدادها را با متد
logEvent()شروع کنید. کد زیر یک رویداد PURCHASE را هنگام خرید یک مورد(های) در برنامه توسط کاربر ثبت می کند:
firebaseAnalytics.logEvent(FirebaseAnalytics.Event.PURCHASE) {
param(FirebaseAnalytics.Param.VALUE, 10)
param(FirebaseAnalytics.Param.CURRENCY, "USE")
}
استفاده از رویدادهای سفارشی
اگر به رویدادهایی نیاز دارید که توسط رویدادهای پیشنهادی پوشش داده نمی شوند، می توانید رویدادهای سفارشی خود را با پارامترهای سفارشی ثبت کنید:
firebaseAnalytics.logEvent("delete_item"){
param("item name", name)
param("reason", text)
}
رویدادهای اشکال زدایی
می‌توانید داده‌ها و گزارش‌های جمع‌آوری شده درباره رویدادهای خود را در کنسول Firebase مشاهده کنید. اما به‌روزرسانی‌ها به‌طور دوره‌ای در طول روز انجام می‌شوند، شما نمی‌توانید آن رویدادها را بلافاصله پس از ورود به برنامه خود مشاهده کنید.
برای اهداف آزمایش و اشکال زدایی فوری، می توانید از Firebase Debugview استفاده کنید. DebugView شما را قادر می سازد تا داده های رویداد ثبت شده توسط برنامه خود را در دستگاه های توسعه تقریباً در زمان واقعی مشاهده کنید. برای DebugView، لطفاً به بخش Debugging event مراجعه کنید.
اکنون ثبت رویدادها را در برنامه Android خود تکمیل کرده اید!
در مرحله بعد، نحوه وارد کردن آن رویدادها را در Google Ads خواهید آموخت.
6. رویدادهای Firebase را به Google Ads وارد کنید
راه‌اندازی Firebase-Android شما به پایان رسیده است و شما آماده راه‌اندازی کمپین برنامه با رویدادهای اقدام ثبت‌شده هستید. شما با پیوند Firebase به Google Ads شروع می کنید. با پیوند Firebase به Google Ads، کمپین‌های برنامه می‌توانند اطلاعات بیشتری درباره مخاطبان کسب کنند و یادگیری کمپین برنامه را تقویت کنند، که معمولاً منجر به عملکرد و تبدیل بهتر می‌شود.
Firebase و Google Ads را پیوند دهید
- با کلیک کردن روی دکمه درست در کنار نمای کلی پروژه، به تنظیمات Firebase بروید.
- در تب ادغام، تبلیغات گوگل و دکمه پیوند را مشاهده خواهید کرد. روی پیوند و ادامه کلیک کنید.
- حساب Google Ads را که می‌خواهید پیوند دهید، انتخاب کنید.
اکنون پیوند Firebase و Google Ads را کامل کرده اید. بیایید رویدادهای Firebase را به Google Ads وارد کنیم.
وارد کردن رویدادهای Firebase
- در کنسول Firebase، به منوی رویدادها بروید و رویدادی را که می‌خواهید به عنوان تبدیل وارد کنید علامت بزنید.
- اکنون به Google Ads بروید و به حسابی که با Firebase پیوند داده اید وارد شوید.
- در Google Ads، به Tools → Measurement → Conversions بروید
- روی دکمه + کلیک کنید
- App → Google Analytics 4 properties (Firebase) را انتخاب کنید و روی ادامه کلیک کنید.
- می‌توانید همه رویدادهای تحلیلی را که به‌عنوان تبدیل علامت‌گذاری شده‌اند، ببینید. رویدادی را که می‌خواهید وارد کنید پیدا کنید. در این مورد، رویداد
delete_itemرا که قبلاً پیاده‌سازی کرده‌ایم، انتخاب کنید. روی دکمه Import and Continue کلیک کنید.
- شما با موفقیت یک رویداد تبدیل را از Firebase وارد کردید.
اکنون وارد کردن رویدادهای Firebase در Google Ads را تکمیل کرده‌اید.
در مرحله بعد، یاد خواهید گرفت که چگونه با رویدادی که به تازگی وارد کرده اید، یک کمپین اکشن راه اندازی کنید.
7. راه اندازی کمپین های اکشن برنامه با رویدادهای وارداتی
- به تب کمپین‌های برنامه در حساب Google Ads فعلی خود بروید و با کلیک روی دکمه + کمپین جدیدی را شروع کنید.
- ما یک کمپین تبلیغاتی برنامه را با گزینه نصب برنامه راه اندازی خواهیم کرد. در پایین، برنامه‌ای را که می‌خواهید تبلیغ کنید انتخاب کنید و روی ادامه کلیک کنید.
- در بخش Bidding، اگر در منوی کشویی گزینه In-app Actions را انتخاب کنید، می توانید رویدادها را مشاهده کنید. رویداد(هایی) را انتخاب کنید که می خواهید روی آن تمرکز کنید.
- بقیه تنظیمات کمپین را تنظیم کنید و تمام شد.
8. تبریک می گویم
تبریک می‌گوییم، شما با موفقیت Firebase و Google Ads خود را ادغام کردید! این به شما کمک می کند تا عملکرد کمپین خود را افزایش دهید.
تو یاد گرفتی
- نحوه پیکربندی Firebase Analytics برای اندروید
- نحوه ثبت رویدادها با Firebase Analytics در یک برنامه اندروید.
- نحوه وارد کردن رویدادها و استفاده از آنها برای کمپین های اکشن