1. מבוא
עדכון אחרון: 14.12.2020
מה תפַתחו
ב-Codelab הזה תלמדו איך להטמיע אירועים מותאמים אישית באמצעות GA4F iOS SDK ולהשיק קמפיינים עם קריאה לפעולה דרך Google Ads.
בקודלאב הזה תוכלו להתנסות בתהליך המלא של ניהול אפליקציות עסקיות שבו הלקוחות שלנו נתקלים. אם אתם רוצים לקבל מבוא קל יותר ל-Firebase ל-iOS, כדאי להתחיל בCodelab של Firebase ל-iOS ב-Swift.
מה תלמדו
- איך להפעיל את GA4F (Google Analytics for Firebase) ב-iOS SWIFT
- איך יוצרים אירועים ופרמטרים מותאמים אישית.
- איך מייבאים אירועים מ-Firebase ל-Google Ads
- מפעילים קמפיינים עם קריאה לפעולה עם אירועים מותאמים אישית.
מה צריך להכין
- Xcode
- חשבון Firebase
- חשבון Google Ads
2. התחלת פרויקט חדש ב-Swift ל-iOS
יוצרים אפליקציית Swift פשוטה בתבנית. כדי ליצור את האפליקציה הסופית, משנים את האפליקציה לתחילת הפעולה.
קודם כול, פותחים את Xcode.
- אם אין לכם פרויקטים פתוחים, בוחרים באפשרות 'יצירת פרויקט Xcode חדש' בדף הפתיחה.
- בחלק העליון של תיבת הדו-שיח, בוחרים באפשרות iOS.
- בקטע 'אפליקציה', בוחרים באפשרות 'אפליקציה' ולוחצים על 'הבא'.
- בתיבת הדו-שיח שמופיעה, נותנים שם לאפליקציה ומגדירים אפשרויות נוספות לפרויקט באמצעות הערכים הבאים, ואז לוחצים על Next (הבא):
- שם המוצר: למשל ios-app
מערכת Xcode משתמשת בשם המוצר שהזנתם כדי לתת שם לפרויקט ולאפליקציה.
- צוות: אם השדה לא מתמלא באופן אוטומטי, מגדירים את הצוות כ'ללא'.
- שם הארגון: השם של הארגון שלכם או השם שלכם.
- מזהה החבילה: הערך הזה נוצר באופן אוטומטי על סמך שם המוצר ומזהה הארגון.
- שפה: Swift
- בוחרים מיקום כדי לשמור את הפרויקט ולוחצים על 'יצירה'.
- הפרויקט החדש ייפתח ב-Xcode בחלון סביבת העבודה.
3. יצירה והגדרה של פרויקט Firebase
כדי להתחיל בעבודה עם Firebase, עליך ליצור ולהגדיר פרויקט Firebase.
יצירת פרויקט Firebase
אם יש לכם פרויקט Firebase ש-Google Analytics לא מופעל בו, אתם יכולים להפעיל את Google Analytics דרך הכרטיסייה 'שילובים' בקטע 'הגדרות' > 'הגדרות הפרויקט'. עוברים לשלב ההגדרה של Firebase.
- נכנסים ל-Firebase.
במסוף Firebase, לוחצים על 'הוספת פרויקט' (או 'יצירת פרויקט') ונותנים שם לפרויקט Firebase-iOS-Ads.
- לוחצים על האפשרויות ליצירת פרויקט. מאשרים את התנאים של Firebase אם מופיעה בקשה לעשות זאת. צריך להפעיל את Google Analytics בפרויקט הזה, כי נדרשים אירועים ב-Google Analytics כדי לעקוב אחרי המרות ואירועי פעולה.
מידע נוסף על פרויקטים ב-Firebase זמין במאמר הסבר על פרויקטים ב-Firebase.
4. הגדרת Firebase
- במסוף Firebase, בוחרים באפשרות 'סקירה כללית של הפרויקט' > 'הגדרות הפרויקט' בתפריט הניווט הימני, ואז לוחצים על הלחצן iOS בקטע 'כללי' > 'האפליקציות שלך'.
תיבת הדו-שיח תופיע במסך הבא.
- הערך החשוב שצריך לספק הוא מזהה החבילה של iOS, שתקבלו באמצעות השלב הבא.
- בפרויקט Xcode של אפליקציית iOS, בוחרים את האפליקציה ברמה העליונה בחלונית הניווט של הפרויקט ואז בוחרים בכרטיסייה 'כללי'.
- הערך בשדה 'מזהה חבילה' הוא מזהה החבילה של iOS (משהו כמו
com.yourcompany.yourproject
). יש להעתיק את הערך הזה. - בתיבת הדו-שיח של Firebase, מדביקים את מזהה החבילה שהועתק בשדה
iOS bundle ID
. - לוחצים על Register App.
- אם ממשיכים ב-Firebase, פועלים לפי ההוראות להורדת קובץ התצורה
GoogleService-Info.plist
.
- עוברים לפרויקט Xcode ומעבירים את קובץ
GoogleService-Info.plist
(שהורדתם עכשיו) לתיקיית השורש של פרויקט Xcode. - מדלגים על השלבים הנותרים וחוזרים לדף הראשי של מסוף Firebase.
5. הגדרת 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
}
}
- סיימת! אפשר להמשיך אל המסוף.
עכשיו הכול מוכן להפעלה של יומני אירועים בהתאמה אישית.
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… (עריכת התוכנית).
- בתפריט הימני, בוחרים באפשרות הפעלה.
- בוחרים את הכרטיסייה ארגומנטים.
- בקטע Arguments Pass on Launch (ארגומנטים שהועברו בהשקה), מוסיפים -FIRAnalyticsDebugEnabled.
בפעם הבאה שתפעילו את האפליקציה, האירועים שלכם יוצגו במסוף ניפוי הבאגים של Xcode, וכך תוכלו לאמת מיד שהאירועים נשלחים.
הצגת האירועים במרכז הבקרה
האירוע שתתעד יופיע במסוף Firebase בעוד כמה שעות. הוא נמצא ב-Analytics ← 'אירועים'. אפשר גם למצוא את ערכי הפרמטרים בלחיצה על האירוע.
כדי לסמן את 'text_search' כהמרה, מעבירים את המתג 'סימון כהמרה' שמאלה.
כדי לבדוק שוב אם האירוע סומן בהצלחה כהמרה, אפשר לעבור לכרטיסייה 'המרות' ב-Firebase Analytics. סימון האירוע כהמרה יאפשר למערכת Google Ads לייבא את האירוע גם כהמרה.
7. ייבוא אירועים מ-Analytics ב-Google Ads
ההגדרה של Firebase ל-iOS הסתיימה, ואתם מוכנים להשיק את הקמפיין לקידום האפליקציה עם אירועי פעולה שתועדו ביומן. בשלב הראשון, מקשרים את Firebase ל-Google Ads. קישור Firebase ל-Google Ads מאפשר לקמפיינים לקידום אפליקציות ללמוד יותר על קהלים ולשפר את הלמידה מהקמפיינים לקידום אפליקציות, וכך בדרך כלל להניב ביצועים והמרות טובים יותר.
- כדי לעבור להגדרות Firebase, לוחצים על הלחצן שליד 'סקירה כללית של הפרויקט'.
- בכרטיסייה Integrations (שילובים) תראו את Google Ads ואת הלחצן 'קישור'. לוחצים על 'קישור והמשך'.
- בוחרים חשבון Google Ads.
עכשיו סיימתם את החלק של Firebase.
עכשיו עוברים אל Google Ads ומתחברים.
- עוברים אל Google Ads, מתחברים, עוברים לקטע 'כלים והגדרות' ← 'מדידה' ← 'המרות' כדי לייבא אירועים מותאמים אישית כהמרה.
- יש ללחוץ על הלחצן + להוספת פעולת ההמרה החדשה.
- בוחרים באפשרות 'נכסי Google Analytics 4 (Firebase)' ולוחצים על 'המשך'.
- תוכלו לראות את כל האירועים של ניתוח נתונים שמסומנים כהמרות. מחפשים את האירוע
clicked_counter
שהטמענו מקודם.
- מסמנים את הלחצן 'ייבוא והמשך' ולוחצים עליו.
אחרי שמגדירים את text_search
כפעולת המרה, זה הזמן להשיק קמפיין שמטרגט משתמשים שצפויים להפעיל אירועי text_search
.
8. השקת קמפיינים לפעולות באפליקציה עם אירועים מיובאים
- עוברים לכרטיסיית הקמפיין בחשבון הנוכחי ויוצרים קמפיין חדש על ידי לחיצה על הלחצן +. לוחצים על הקמפיין החדש וממשיכים.
- במסגרת התקופה הזו, נשיק קמפיין לקידום אפליקציה עם אפשרות להתקנת אפליקציה.
- כדי למצוא את האפליקציה, מציינים את שם האפליקציה, שם החבילה או בעל האפליקציה.
- בקטע 'בידינג', בוחרים באפשרות 'פעולות בתוך האפליקציה' בתפריט הנפתח של Google Ads כדי להתמקד בפעולות.
- האירועים המותאמים אישית מופיעים ברשימה המוצגת. מגדירים יעד עלות להמרה (CPA) וממלאים גם אפשרויות אחרות.
- קובעים את הגדרות הקמפיין. כלים אלה אינם נכללים בהיקף של Codelab, לכן יש לעיין במסמכים האלה או ליצור קשר עם כל ערוץ אחר לצורך אופטימיזציה של ההגדרות.
9. מזל טוב
כל הכבוד, שילבתם בהצלחה את Firebase עם Google Ads. כך תוכלו לשפר את ביצועי הקמפיין.
התקנתם את הסקריפט, יצרתם רשימת שינויים חדשה ב-Codelab והעברתם אותה ל-staging, עדכנתם את רשימת השינויים ב-Codelab בהמתנה והעברתם אותה ל-staging, בדקתם ואישרתם את רשימת השינויים ב-Codelab ושלחתם אותה ופרסמתם אותה.
למדתם
- איך מגדירים את Firebase ל-iOS
- איך רושמים ביומן אירועים מותאמים אישית ב-iOS וב-Firebase Analytics
- איך מייבאים אירועים ומשתמשים בהם בקמפיינים ליצירת מודעות לפעולה.