Google Ads עם אירועים מותאמים אישית של Google Analytics for Firebase – iOS
מידע על Codelab זה
1. מבוא
עדכון אחרון: 14 בדצמבר 2020
מה תפַתחו
ב-Codelab הזה תלמדו איך להטמיע אירועים מותאמים אישית באמצעות GA4F iOS SDK ולהשיק קמפיינים עם קריאה לפעולה דרך Google Ads.
באמצעות ה-Codelab הזה, אתם יכולים לחוות את התהליך המלא של עסקי האפליקציות בפני הלקוחות שלנו. אם אתם רוצים לקרוא מבוא עדין יותר ל-Firebase iOS, תוכלו להתחיל עם Firebase iOS Codelab Swift
מה תלמדו
- איך להפעיל את GA4F (Google Analytics for Firebase) ב-iOS SWIFT
- איך יוצרים אירועים ופרמטרים מותאמים אישית
- איך מייבאים אירועים מ-Firebase ל-Google Ads
- מפעילים קמפיינים עם קריאה לפעולה עם אירועים בהתאמה אישית.
מה צריך להכין
- Xcode
- חשבון Firebase
- חשבון Google Ads
2. יצירת פרויקט חדש של Swift ב-iOS
יצירת אפליקציה פשוטה בתבנית פשוטה ל-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. - לוחצים על רישום האפליקציה.
- אם ממשיכים ב-Firebase, פועלים לפי ההוראות להורדת קובץ התצורה
GoogleService-Info.plist.
- עוברים לפרויקט Xcode ומעבירים את הקובץ
GoogleService-Info.plist(שהורדתם עכשיו) לרמה הבסיסית (root) של פרויקט Xcode. - מדלגים על השלבים הנותרים וחוזרים לדף הראשי של מסוף Firebase.
5. הגדרת Firebase Analytics ב-Xcode
בשלב הזה תתחילו להוסיף את Firebase SDK לפרויקט Xcode שלכם.
- פותחים חלון טרמינל ומנווטים למיקום של פרויקט Xcode של האפליקציה.
- צריך ליצור Podfile אם אין עדיין:
$ pod init
- פותחים את ה-Podfile ומוסיפים :
$ vi Podfile
$ pod 'Firebase/Analytics' 
- שומרים את הקובץ ומפעילים אותו :
$ pod install
- הוספת קוד אתחול :
כדי לחבר את Firebase כשהאפליקציה מופעלת, צריך להוסיף את קוד האתחול שבהמשך למחלקה הראשית של Appהענקת גישה.
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 > סכימה > עריכת הסכמה...
- בתפריט הימני, בוחרים באפשרות הפעלה.
- בוחרים את הכרטיסייה ארגומנטים.
- בקטע 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. השקת קמפיינים עם קריאה לפעולה באפליקציה עם אירועים שיובאו
- עוברים לכרטיסיית הקמפיין בחשבון הנוכחי ויוצרים קמפיין חדש על ידי לחיצה על הלחצן +. לוחצים על הקמפיין החדש וממשיכים.
- במסגרת התקופה הזו, נשיק קמפיין לקידום אפליקציה עם אפשרות להתקנת אפליקציה.
- כדי למצוא את האפליקציה, מציינים את שם האפליקציה, שם החבילה או בעל האפליקציה.
- בקטע 'בידינג', בוחרים באפשרות 'פעולות בתוך האפליקציה' בתיבה בענן כדי שהמודעות יתמקדו בפעולות.
- האירועים המותאמים אישית מופיעים ברשימה המוצגת. מגדירים יעד עלות להמרה (CPA) וממלאים גם אפשרויות אחרות.
- קובעים את הגדרות הקמפיין. כלים אלה אינם נכללים בהיקף של Codelab, לכן יש לעיין במסמכים האלה או ליצור קשר עם כל ערוץ אחר לצורך אופטימיזציה של ההגדרות.
9. מזל טוב
כל הכבוד, שילבתם בהצלחה את Firebase עם Google Ads. כך תוכלו לשפר את ביצועי הקמפיין.
התקנתם את הסקריפט, יצרתם ויצרתם רשימת שינויים חדשה ב-Codelab, עדכנתם והכנתם את רשימת השינויים בהמתנה ב-Codelab, בדקתם ואישרתם את רשימת השינויים ב-Codelab, ושלחתם ופרסמתם את רשימת השינויים ב-Codelab.
למדתם
- איך מגדירים את Firebase ל-iOS
- איך מתעדים אירועים מותאמים אישית באמצעות iOS ו-Firebase Analytics
- איך לייבא אירועים ולהשתמש בהם בקמפיינים עם קריאה לפעולה.