Google Ads עם אירועים מותאמים אישית של Google Analytics for Firebase – iOS

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. התחלת פרויקט חדש ב-iOS Swift

יוצרים אפליקציית iOS Swift פשוטה שמבוססת על תבנית. משנים את אפליקציית המתחילים הזו כדי ליצור את האפליקציה הסופית.

קודם מפעילים את Xcode.

1. אם אין לכם פרויקטים פתוחים, בוחרים באפשרות Create a new Xcode project (יצירת פרויקט חדש של Xcode) מדף הפתיחה.
2. בחלק העליון של תיבת הדו-שיח, בוחרים באפשרות iOS.
3. בקטע 'אפליקציה', בוחרים באפשרות 'אפליקציה' ולוחצים על 'הבא'.
4. בתיבת הדו-שיח שמופיעה, משתמשים בערכים הבאים כדי לתת שם לאפליקציה ולבחור אפשרויות נוספות לפרויקט, ואז לוחצים על Next (הבא):
5. שם המוצר: למשל ios-app

‫Xcode משתמש בשם המוצר שהזנתם כדי לתת שם לפרויקט ולאפליקציה.

2. צוות: אם השדה הזה לא מתמלא באופן אוטומטי, מגדירים את הצוות ל'ללא'.
3. שם הארגון: השם של הארגון או השם שלכם.
4. מזהה החבילה: הערך הזה נוצר אוטומטית על סמך שם המוצר ומזהה הארגון.
5. שפה: Swift
6. בוחרים מיקום לשמירת הפרויקט ולוחצים על 'יצירה'.
7. פרויקט חדש ייפתח ב-Xcode בחלון סביבת העבודה.

3. יצירה והגדרה של פרויקט Firebase

כדי להתחיל להשתמש ב-Firebase, צריך ליצור ולהגדיר פרויקט Firebase.

יצירת פרויקט Firebase

אם יש לכם פרויקט Firebase קיים שלא הפעלתם בו את Google Analytics, תוכלו להפעיל את Google Analytics דרך הכרטיסייה Integrations (שילובים) בקטע settings (הגדרות) > Project settings (הגדרות הפרויקט). עוברים לשלב ההגדרה של Firebase.

1. נכנסים ל-Firebase.

במסוף Firebase, לוחצים על Add Project (הוספת פרויקט) או על Create a project (יצירת פרויקט) ונותנים לפרויקט Firebase את השם Firebase-iOS-Ads.

2. לוחצים על האפשרויות ליצירת פרויקט. אם מוצגת בקשה, מאשרים את התנאים של Firebase. כדאי להפעיל את Google Analytics בפרויקט הזה, כי צריך אירועים ב-Google Analytics כדי לעקוב אחרי אירועים של פעולות והמרות.

מידע נוסף על פרויקטים ב-Firebase זמין במאמר הסבר על פרויקטים ב-Firebase.

4. הגדרת Firebase

1. במסוף Firebase, בוחרים באפשרות Project Overview (סקירה כללית של הפרויקט) > Project Settings (הגדרות הפרויקט) בסרגל הניווט הימני, ואז לוחצים על הלחצן iOS בקטע General (כללי) > Your apps (האפליקציות שלך).

תוצג תיבת הדו-שיח שמופיעה במסך הבא.

2. הערך החשוב שצריך לספק הוא מזהה החבילה של iOS, שאותו תקבלו באמצעות השלב הבא.
3. בפרויקט Xcode של אפליקציית iOS, בוחרים את האפליקציה ברמה העליונה בחלונית הניווט בפרויקט, ואז בוחרים בכרטיסייה General (כללי).
4. הערך של השדה Bundle Identifier (מזהה החבילה) הוא מזהה החבילה ב-iOS (למשל com.yourcompany.yourproject). מעתיקים את הערך הזה.
5. בתיבת הדו-שיח של Firebase, מדביקים את מזהה החבילה שהועתק בשדה iOS bundle ID.
6. לוחצים על Register App (רישום האפליקציה).
7. ממשיכים ב-Firebase ופועלים לפי ההוראות להורדת קובץ התצורה GoogleService-Info.plist

8. עוברים לפרויקט Xcode ומעבירים את קובץ GoogleService-Info.plist (שהורדתם עכשיו) לתיקיית השורש של פרויקט Xcode.
9. מדלגים על השלבים שנותרו וחוזרים לדף הראשי של מסוף Firebase.

5. הגדרת Firebase Analytics ב-Xcode

בשלב הזה מתחילים להוסיף את Firebase SDK לפרויקט Xcode.

הערה: שירותי Google משתמשים ב-CocoaPods כדי להתקין ולנהל קשרי תלות. אם אתם משתמשים ב-CocoaPods בפעם הראשונה, אתם צריכים להתקין אותו קודם על ידי הפעלת הפקודה הזו בטרמינל:

$ sudo gem install cocoapods

1. פותחים חלון טרמינל ומנווטים למיקום של פרויקט Xcode של האפליקציה.
2. צריך ליצור Podfile אם אין עדיין:

$ pod init

3. פותחים את ה-Podfile ומוסיפים :

$ vi Podfile

$ pod 'Firebase/Analytics'

4. שומרים את הקובץ ומריצים אותו :

$ pod install

5. הוספת קוד אתחול :

כדי לחבר את 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. סיימת! המשך למסוף.

עכשיו אפשר להתחיל לתעד יומני אירועים מותאמים אישית.

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, וכך לוודא שהאירועים נרשמים ביומן בצורה תקינה. הנתונים כוללים אירועים שתועדו באופן אוטומטי ואירועים שתועדו באופן ידני.

כדי להפעיל את הרישום המפורט (verbose) ביומן:

1. ב-Xcode, בוחרים באפשרות Product (מוצר) > Scheme (סכימה) > Edit scheme…‎ (עריכת הסכימה…).
2. בתפריט השמאלי, בוחרים באפשרות Run (הפעלה).
3. בוחרים בכרטיסייה Arguments (ארגומנטים).
4. בקטע Arguments Passed On Launch (ארגומנטים שהערך שלהם נקבע בהפעלה), מוסיפים את הערך ‎-FIRAnalyticsDebugEnabled.

בפעם הבאה שתפעילו את האפליקציה, האירועים יוצגו במסוף ניפוי הבאגים של Xcode, וכך תוכלו לוודא באופן מיידי שהאירועים נשלחים.

צפייה באירועים בלוח הבקרה

האירוע שתועד יופיע במסוף Firebase תוך כמה שעות. הוא נמצא ב-Analytics → אירועים. אפשר גם ללחוץ על האירוע כדי לראות את ערכי הפרמטרים.

כדי לסמן את 'text_search' כהמרה, מעבירים את המתג 'סימון כהמרה' שמאלה.

אפשר לבדוק שוב אם האירוע סומן כהמרה בכרטיסייה 'המרות' ב-Firebase Analytics. אם תסמנו את האירוע כהמרה, מערכת Google Ads תוכל גם לייבא את האירוע כהמרה.

7. ייבוא אירועים מ-Analytics אל Google Ads

ההגדרה של Firebase-iOS הסתיימה, ואתם מוכנים להשיק את הקמפיין לקידום האפליקציה עם אירועי פעולה שנרשמו ביומן. השלב הראשון הוא לקשר את Firebase ל-Google Ads. קישור של Firebase ל-Google Ads מאפשר לקמפיינים לקידום אפליקציות ללמוד יותר על קהלים ולשפר את תהליך הלמידה של הקמפיינים לקידום אפליקציות, מה שבדרך כלל מוביל לשיפור בביצועים ובהמרות.

1. עוברים אל Firebase Settings (הגדרות Firebase) בלחיצה על הלחצן שמימין ל-Project Overview (סקירת הפרויקט).
2. בכרטיסייה Integrations (שילובים), יופיעו Google Ads ולחצן Link (קישור). לוחצים על 'קישור והמשך'.

3. בוחרים חשבון Google Ads.

שימו לב: אם אירוע היעד לא מסומן כהמרה, מערכת Google Ads לא תוכל לייבא אותו. מוודאים שהאירוע מסומן בצורה נכונה כהמרה.

החלק שקשור ל-Firebase הסתיים.

עכשיו, עוברים אל Google Ads ומתחברים.

1. עוברים אל Google Ads, מתחברים ועוברים אל 'כלים והגדרות' > 'מדידה' > 'המרות' כדי לייבא אירועים מותאמים אישית כהמרות.
2. לוחצים על לחצן הפלוס כדי להוסיף פעולת המרה חדשה.

3. בוחרים באפשרות 'נכסי Google Analytics 4 (Firebase)' ולוחצים על 'המשך'.

4. תוכלו לראות את כל האירועים ב-Analytics שמסומנים כהמרות. מחפשים את האירוע clicked_counter שהטמענו קודם.

5. מסמנים את התיבה ולוחצים על הלחצן 'ייבוא והמשך'.

אחרי שמגדירים את text_search כפעולת המרה, הגיע הזמן להשיק קמפיין שמטרגט משתמשים שסביר שיפעילו אירועי text_search.

8. השקת קמפיינים לעידוד פעולות באפליקציה עם אירועים מיובאים

חשוב: כדי להשיק קמפיין לקידום אפליקציה, צריך אפליקציה ברמת מסלול לסביבת הייצור ב-Google Play. אם אתם לא מוכנים לפרסם את האפליקציה, אפשר לדלג על השלב הזה כרגע.

6. עוברים לכרטיסיית הקמפיינים בחשבון הנוכחי ומתחילים קמפיין חדש בלחיצה על כפתור הפלוס (+). לוחצים על הקמפיין החדש וממשיכים.
7. בשלב הזה, נשיק קמפיין לקידום אפליקציה עם האפשרות 'התקנות אפליקציה'.

8. מחפשים את האפליקציה לפי שם האפליקציה, שם החבילה או בעל האפליקציה.
9. בקטע 'בידינג', בוחרים באפשרות 'פעולות באפליקציה' בתיבת הבחירה כדי להתמקד בפעולות.
10. תוכלו למצוא את האירועים המותאמים אישית ברשימה שמוצגת. מגדירים יעד עלות להמרה וממלאים גם את שאר האפשרויות.

11. קובעים את הגדרות הקמפיין. הנושא הזה לא ייכלל ב-Codelab, לכן מומלץ לעיין במאמרי העזרה האלה או ליצור קשר דרך ערוצים אחרים כדי לקבל מידע על אופטימיזציה של ההגדרות.

9. מזל טוב

החשבון שלך קושר בהצלחה ל-Firebase ול-Google Ads! כך תוכלו לשפר את ביצועי הקמפיין.

התקנתם את הסקריפט, יצרתם רשימת שינויים חדשה של Codelab והעברתם אותה להמתנה, עדכנתם את רשימת השינויים של Codelab שהועברה להמתנה והעברתם אותה להמתנה, בדקתם את רשימת השינויים של Codelab ואישרתם אותה, ושלחתם ופרסמתם את רשימת השינויים של Codelab.

מה למדתם

• איך מגדירים את Firebase ל-iOS
• איך מתעדים אירועים מותאמים אישית באמצעות iOS ו-Firebase Analytics
• איך מייבאים אירועים ומשתמשים בהם בקמפיינים עם קריאה לפעולה.