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

1. מבוא

עדכון אחרון: 19.02.2021

מה תפַתחו

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

באמצעות ה-Codelab הזה, אתם יכולים לחוות את התהליך המלא של עסקי האפליקציות בפני הלקוחות שלנו. אם אתם רוצים לקבל מבוא קל יותר ל-Firebase ול-AdMob ב-iOS, כדאי להתחיל בשיעור בסיסי ב-Unity בנושא AdMob ו-Firebase: הגדרה ויסודות של ניתוח נתונים.

מה תלמדו

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

מה צריך להכין

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

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

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

הפעלת Unity

  1. אם אין לכם פרויקטים פתוחים, בוחרים באפשרות 'יצירת פרויקט חדש'.
  2. בוחרים תבניות תלת-ממד בתיבת הדו-שיח.
  3. ממלאים את שם הפרויקט, למשל אירוע מותאם אישית של Firebase ב-Unity.
  4. בוחרים מיקום לשמירת הפרויקט ולוחצים על 'יצירה'.
  5. הפרויקט החדש ייפתח בחלון של סביבת העבודה ב-Unity.

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

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

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

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

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

d9519856fc3b4bd0.png

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

e58151a081f0628.png

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

4. הגדרת Unity

  1. נכנסים ל-Unity > File > Build Settings. הערך החשוב הוא הגדרת מזהה החבילה של iOS, שאותו אפשר לקבל בשלב הבא.

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

7dbfc36bef1d035c.png

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

8be5416883a70def.png

  1. אחרי שינוי הפלטפורמה, לוחצים על הלחצן 'הגדרות נגן' כדי להגדיר את מזהה החבילה. אפשר לראות את שדה הטקסט מסביב לאזור הזיהוי.
  2. הערך בשדה 'מזהה חבילה' הוא מזהה החבילה של 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. בוחרים את יעד ה-build של פרויקט Unity שרוצים לרשום. לחלופין, אפשר אפילו לרשום את שני היעדים עכשיו בו-זמנית.
  1. מזינים את המזהים הספציפיים לפלטפורמה של פרויקט Unity.
  • ב-iOS – מזינים את מזהה ה-iOS של פרויקט Unity בשדה iOS Bundle ID.
  • ב-Android – מזינים את מזהה Android של פרויקט Unity בשדה שם חבילה ל-Android. אנחנו משתמשים במונחים שם חבילה ומזהה אפליקציה לעיתים קרובות לסירוגין.
  1. איפה נמצא המזהה של פרויקט Unity?
  1. (אופציונלי) מזינים את הכינויים הספציפיים לפלטפורמה של פרויקט Unity. הכינויים האלה הם מזהים פנימיים ובעלי נוחות, והם גלויים רק לכם במסוף Firebase.
  2. לוחצים על רישום האפליקציה.

הוספת ערכות Firebase Analytics Unity SDK

  1. במסוף Firebase, לוחצים על Download Firebase Unity SDK (הורדת Firebase Unity SDK) ומחלצים את ה-SDK למקום נוח.
  • תמיד אפשר להוריד את Firebase Unity SDK שוב.
  • ה-SDK של Firebase Unity לא ספציפי לפלטפורמה.
  1. בפרויקט Unity הפתוח, עוברים אל נכסים > ייבוא חבילה > חבילה מותאמת אישית.
  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. בתפריט הימני, בוחרים באפשרות הפעלה.
  3. בוחרים את הכרטיסייה ארגומנטים.
  4. בקטע Arguments Pass 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, לוחצים על הלחצן שליד 'סקירה כללית של הפרויקט'.
  2. בכרטיסייה Integrations (שילובים) תראו את Google Ads ואת הלחצן 'קישור'. לוחצים על 'קישור והמשך'.

b711bf2e94fa0895.png

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

עכשיו סיימתם את החלק של Firebase.

עכשיו, צריך להיכנס ל-Google Ads ולהתחבר.

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

73cec8d2e80eab03.png

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

4b1d8f6a712b2ac6.png

  1. תוכלו לראות את כל האירועים של ניתוח נתונים שמסומנים כהמרות. למצוא את האירוע clicked_counter שהטמענו בעבר.

ba1bbe6b2924fac8.png

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

ab35e341dff32e48.png

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

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

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

af98c44d1476558.png

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

a1f145794f949109.png

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

9. מזל טוב

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

למדתם

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

מסמכי עזר