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

1. מבוא

העדכון האחרון: 19 בפברואר 2021

מה תפַתחו

ב-codelab הזה נסביר איך להטמיע אירועים מותאמים אישית באמצעות GA4F iOS בסביבת Unity ולהפעיל קמפיינים עם קריאה לפעולה דרך Google Ads.

במהלך ה-codelab הזה, תוכלו לחוות את התהליך המלא של עסקי האפליקציות שהלקוחות שלנו מתמודדים איתו. אם אתם רוצים לקבל מבוא פשוט יותר ל-Firebase ול-AdMob ב-iOS, כדאי להתחיל עם המאמר AdMob+Firebase 101 Unity: Setup & Analytics Basics (הגדרות ויסודות של Analytics).

מה תלמדו

  • איך מאתחלים את GA4F (Google Analytics for Firebase) ב-Unity + iOS.
  • איך יוצרים אירועים ופרמטרים מותאמים אישית
  • איך מייבאים אירועים מ-Firebase אל Google Ads.
  • הפעלת קמפיינים עם קריאה לפעולה עם אירועים מותאמים אישית.

מה תצטרכו

  • Xcode
  • Unity
  • חשבון Firebase
  • חשבון Google Ads

2. התחלת פרויקט חדש ב-Unity

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

הפעלת Unity

  1. אם אין לכם פרויקטים פתוחים, תצטרכו ליצור פרויקט חדש.
  2. בוחרים תבניות תלת-ממד מתיבת הדו-שיח.
  3. ממלאים את השדה Project Name (שם הפרויקט): למשל Unity Firebase Custom Event (אירוע מותאם אישית של Firebase ב-Unity).
  4. בוחרים מיקום לשמירת הפרויקט ולוחצים על CREATE (יצירה).
  5. פרויקט חדש ייפתח ב-Unity בחלון סביבת העבודה.

3. יצירה והגדרה של פרויקט 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.

d9519856fc3b4bd0.png

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

e58151a081f0628.png

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

4. הגדרות Unity

  1. ב-Unity > קובץ > הגדרות ה-Build. הערך החשוב הוא מזהה החבילה של iOS, שאותו תקבלו בשלב הבא.

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

7dbfc36bef1d035c.png

  1. בפרויקט Unity של אפליקציה ל-iOS, פותחים את תיבת הדו-שיח Build Settings (הגדרות ה-Build),‏ File > Build Settings (קובץ > הגדרות ה-Build). אם הפלטפורמה לא מוגדרת ל-iOS, אפשר לבחור באפשרות iOS Platform (פלטפורמת iOS) וללחוץ על הלחצן Switch Platform (החלפת פלטפורמה).

8be5416883a70def.png

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

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

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

  1. עוברים אל מסוף Firebase.
  2. במרכז הדף של סקירה כללית של הפרויקט, לוחצים על סמל Unity ( 8c8fc0e0e05dc749.png) כדי להפעיל את תהליך ההגדרה. אם כבר הוספתם אפליקציה לפרויקט Firebase, לוחצים על הוספת אפליקציה כדי להציג את אפשרויות הפלטפורמה.
  3. בוחרים את יעד הבנייה של פרויקט Unity שרוצים לרשום, או שאפשר לרשום את שני היעדים בו-זמנית.
  1. מזינים את המזהים הספציפיים לפלטפורמה של הפרויקט ב-Unity.
  • ל-iOS – מזינים את מזהה ה-iOS של פרויקט Unity בשדה מזהה חבילה ב-iOS.
  • ב-Android – מזינים את מזהה Android של פרויקט Unity בשדה שם חבילת Android. המונחים שם חבילה ומזהה אפליקציה משמשים לעיתים קרובות לסירוגין.
  1. איפה אפשר למצוא את מזהה פרויקט Unity?
  1. (אופציונלי) מזינים את הכינויים הספציפיים לפלטפורמה של פרויקט Unity. הכינויים האלה הם מזהים פנימיים שנועדו לנוחותכם, ורק אתם יכולים לראות אותם במסוף Firebase.
  2. לוחצים על Register app (רישום האפליקציה).

הוספת Firebase Analytics Unity SDKs

  1. במסוף Firebase, לוחצים על Download Firebase Unity SDK (הורדת Firebase Unity SDK) ומחלצים את ה-SDK במיקום נוח.
  • תמיד אפשר להוריד שוב את Firebase Unity SDK.
  • ‫Firebase Unity SDK לא ספציפי לפלטפורמה.
  1. בפרויקט הפתוח ב-Unity, עוברים אל Assets (נכסים) > Import Package (ייבוא חבילה) > Custom Package (חבילה מותאמת אישית).
  2. מתוך ה-SDK שחולץ, בוחרים את מוצרי Firebase הנתמכים שרוצים להשתמש בהם באפליקציה.
  • מוסיפים את חבילת Firebase ל-Google Analytics: ‏ FirebaseAnalytics.unitypackage
  • מוסיפים את החבילות של כל מוצר אחר של Firebase שרוצים להשתמש בו באפליקציה. לדוגמה, כדי להשתמש ב-אימות ב-Firebase וב-מסד נתונים בזמן אמת ב-Firebase: ‏ FirebaseAuth.unitypackage ו-FirebaseDatabase.unitypackage
  1. בחלון ייבוא חבילת Unity, לוחצים על ייבוא.
  2. במסוף Firebase, בתהליך ההגדרה, לוחצים על הבא.

6. תיעוד אירועים מותאמים אישית באמצעות Firebase Analytics

בשלב הזה נסביר איך לרשום אירועים מותאמים אישית באמצעות Firebase Analytics באפליקציית Unity ל-iOS.

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

רישום אירועים

אחרי שמגדירים את המופע FirebaseApp, אפשר להתחיל לתעד אירועים באמצעות השיטה logEvent().

Firebase.Analytics.FirebaseAnalytics.LogEvent("text_search", name, text);

צפייה באירועים במסוף ניפוי הבאגים של Xcode

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

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

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

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

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

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

286b640ed4646163.png

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

a933a338990cba3a.png

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

b711bf2e94fa0895.png

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

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

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

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

73cec8d2e80eab03.png

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

4b1d8f6a712b2ac6.png

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

ba1bbe6b2924fac8.png

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

ab35e341dff32e48.png

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

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

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

af98c44d1476558.png

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

a1f145794f949109.png

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

9. מזל טוב

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

מה למדתם

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

מאמרי עזרה