1. מבוא
עדכון אחרון: 19.02.2021
מה תפַתחו
ב-Codelab הזה תלמדו איך להטמיע אירועים מותאמים אישית עם GA4F ל-iOS בסביבת Unity ולהשיק קמפיינים עם קריאה לפעולה דרך Google Ads.
באמצעות ה-Codelab הזה, אתם יכולים לחוות את התהליך המלא של עסקי האפליקציות בפני הלקוחות שלנו. לקבלת מידע בסיסי יותר על Firebase ו-AdMob ב-iOS, מומלץ להתחיל עם AdMob+Firebase 101 Unity: הגדרה ו Analytics Basics (עקרונות בסיסיים של Analytics).
מה תלמדו
- איך מפעילים את GA4F (Google Analytics for Firebase) ב-Unity + iOS.
- איך יוצרים אירועים ופרמטרים מותאמים אישית
- איך מייבאים אירועים מ-Firebase ל-Google Ads.
- משיקים קמפיינים עם קריאה לפעולה עם אירועים מותאמים אישית.
מה צריך להכין
- Xcode
- Unity
- חשבון Firebase
- חשבון Google Ads
2. יצירת פרויקט חדש ב-Unity
יצירת אפליקציית Unity בתבנית פשוטה. תשנו את האפליקציה הפשוטה הזאת כדי ליצור את האפליקציה הסופית.
הפעלת Unity
- אם אין לכם פרויקטים פתוחים, בוחרים באפשרות 'יצירת פרויקט חדש'.
- בוחרים תבניות תלת-ממד בתיבת הדו-שיח.
- ממלאים את שם הפרויקט: למשל, אירוע בהתאמה אישית של Firebase ב-Unity.
- בוחרים מיקום כדי לשמור את הפרויקט ולוחצים על CREATE (יצירה).
- המערכת של Unity פותחת את הפרויקט החדש בחלון של סביבת העבודה.
3. יצירה והגדרה של פרויקט Firebase
כדי להתחיל בעבודה עם Firebase, עליך ליצור ולהגדיר פרויקט Firebase.
אם יש לכם פרויקט Firebase ש-Google Analytics לא מופעל בו, אתם יכולים להפעיל את Google Analytics דרך הכרטיסייה 'שילובים' בהגדרות > הגדרות הפרויקט. עוברים לשלב ההגדרה של Firebase.
- נכנסים אל Firebase.
במסוף Firebase, לוחצים על 'הוספת פרויקט' (או 'יצירת פרויקט') ונותנים שם לפרויקט Firebase-iOS-Ads.
- לוחצים על האפשרויות ליצירת פרויקט. מאשרים את התנאים של Firebase, אם מופיעה בקשה. צריך להפעיל את Google Analytics בפרויקט הזה, כי נדרשים אירועים ב-Google Analytics כדי לעקוב אחרי המרות ואירועי פעולה.
מידע נוסף על פרויקטים ב-Firebase זמין במאמר הסבר על פרויקטים ב-Firebase.
4. הגדרת Unity
- ב-Unity > קובץ > הגדרות Build. הערך החשוב הוא הגדרת מזהה החבילה של iOS, שאותו אפשר לקבל בשלב הבא.
תיבת הדו-שיח תופיע במסך הבא.
- בפרויקט Unity של האפליקציה ל-iOS, פותחים את תיבת הדו-שיח Build Settings (הגדרות Build), File > (קובץ >) יצירת הגדרות (אם הפלטפורמה לא מוגדרת ל-iOS, אפשר לבחור באפשרות 'פלטפורמת iOS' וללחוץ על הלחצן החלפת פלטפורמה)
- לאחר שינוי הפלטפורמה, לוחצים על הלחצן 'הגדרות נגן' כדי להגדיר מזהה חבילה. אפשר לראות את שדה הטקסט מסביב לאזור הזיהוי.
- הערך בשדה 'מזהה חבילה' הוא מזהה החבילה של iOS (בדומה ל-
com.yourcompany.yourproject). צריך להעתיק את הערך הזה או להגדיר את הערך ולהעתיק אותו. - בתיבת הדו-שיח של Firebase, מדביקים את מזהה החבילה שהועתק בשדה
iOS bundle ID. - לוחצים על רישום האפליקציה.
- אם ממשיכים ב-Firebase, פועלים לפי ההוראות להורדת קובץ התצורה
GoogleService-Info.plist. - פותחים את החלון Project (פרויקט) בפרויקט Unity ומעבירים את קובצי התצורה לתיקייה Assets (נכסים).
- מדלגים על השלבים הנותרים וחוזרים לדף הראשי של מסוף Firebase.
5. הגדרת Firebase Analytics ב-Unity
בשלב הזה מתחילים להוסיף את Firebase SDK לפרויקט Unity.
- נכנסים אל מסוף Firebase.
- במרכז דף הסקירה הכללית של הפרויקט, לוחצים על סמל Unity (
) כדי להפעיל את תהליך ההגדרה. אם כבר הוספתם אפליקציה לפרויקט Firebase, לוחצים על הוספת אפליקציה כדי להציג את אפשרויות הפלטפורמה. - בוחרים את יעד ה-build של פרויקט Unity שרוצים לרשום. לחלופין, אפשר אפילו לרשום את שני היעדים עכשיו בו-זמנית.
- מזינים את המזהים הספציפיים לפלטפורמה של פרויקט Unity.
- ב-iOS – מזינים את מזהה ה-iOS של פרויקט Unity בשדה iOS Bundle ID.
- ב-Android – מזינים את מזהה Android של פרויקט Unity בשדה שם חבילה ל-Android. אנחנו משתמשים במונחים שם חבילה ומזהה אפליקציה לעיתים קרובות לסירוגין.
- איפה מופיע מזהה הפרויקט ב-Unity?
- (אופציונלי) מזינים את הכינויים הספציפיים לפלטפורמה של פרויקט Unity. הכינויים האלה הם מזהים פנימיים ובעלי נוחות, והם גלויים רק לכם במסוף Firebase.
- לוחצים על רישום האפליקציה.
הוספת ערכות SDK של Firebase Analytics Unity
- במסוף Firebase, לוחצים על הורדת Firebase Unity SDK, ואז מחלצים את קובץ ה-SDK במקום נוח.
- תמיד אפשר להוריד את Firebase Unity SDK שוב.
- ה-SDK של Firebase Unity לא ספציפי לפלטפורמה.
- בפרויקט Unity הפתוח, עוברים אל נכסים > ייבוא חבילה > חבילה מותאמת אישית.
- מתוך ה-SDK המכווץ, בוחרים את מוצרי Firebase הנתמכים שבהם רוצים להשתמש באפליקציה.
- מוסיפים את חבילת Firebase ל-Google Analytics: FirebaseAnalytics.unitypackage
- מוסיפים את החבילות של כל מוצרי Firebase האחרים שבהם רוצים להשתמש באפליקציה. למשל, כדי להשתמש באימות ב-Firebase ובמסד נתונים בזמן אמת ב-Firebase: FirebaseAuth.unitypackage ו-FirebaseDatabase.unitypackage
- בחלון ייבוא של חבילת Unity לוחצים על ייבוא.
- נחזור למסוף Firebase, בתהליך העבודה של ההגדרה, לוחצים על הבא.
6. רישום אירועים מותאמים אישית באמצעות Firebase Analytics
בשלב הזה נסביר איך לתעד אירועים מותאמים אישית באמצעות Firebase Analytics באפליקציית Unity ל-iOS.
מערכת Firebase Analytics רושמת ביומן כמה אירועים באופן אוטומטי. אין צורך להוסיף קוד כדי לקבל אותן. אם האפליקציה שלכם צריכה לאסוף נתונים נוספים, תוכלו לרשום באפליקציה עד 500 סוגים שונים של אירועים מותאמים אישית של Analytics.
רישום אירועים
אחרי שמגדירים את מופע FirebaseApp, אפשר להתחיל לתעד אירועים באמצעות שיטת LogEvent() .
Firebase.Analytics.FirebaseAnalytics.LogEvent("text_search", name, text);
הצגת אירועים במסוף ניפוי הבאגים של 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 עם Unity ו-Google Ads! כך תוכלו לשפר את ביצועי הקמפיין.
למדתם
- איך מגדירים את Firebase ל-Unity בפלטפורמת iOS
- איך מתעדים אירועים בהתאמה אישית באמצעות Unity ו-Firebase Analytics
- איך לייבא אירועים ולהשתמש בהם בקמפיינים עם קריאה לפעולה.