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

1. מבוא

תאריך עדכון אחרון: 14 בדצמבר 2020

מה תפַתחו

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

בקודלאב הזה נסביר איך מטמיעים אירועים באמצעות GA4F ומייבאים את האירועים ל-Google Ads. רוצים לדעת איך מפתחים אפליקציה ל-Android באמצעות Firebase? אפשר לעיין במדריך Firebase Android Codelab-Build Friendly Chat.

מה תלמדו

  • איך יוצרים פרויקט ב-Firebase
  • איך מטמיעים את Firebase SDK באפליקציה ל-Android
  • איך יוצרים אירועים ופרמטרים.
  • איך מייבאים אירועים מ-Firebase ל-Google Ads
  • מפעילים קמפיינים של Google Ads עם קריאה לפעולה עם אירועים מותאמים אישית.

מה צריך להכין

  • Android Studio 3.6 ואילך
  • חשבון Firebase
  • חשבון Google Ads

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

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

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

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

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

8525e77df3536fbb.png

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

e58151a081f0628.png

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

  1. בוחרים חשבון Google Analytics. אם יש לכם חשבון, בוחרים אותו או יוצרים חשבון חדש. לוחצים על הלחצן Create project.

ac928e5947ba7cbf.png

  1. זהו! סיימת את ה-build של פרויקט Firebase.

בשלב הבא נסביר איך מוסיפים את Firebase לאפליקציה ל-Android.

3. הוספת Firebase לאפליקציה ל-Android

רישום האפליקציה

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

6cbb33ad3e7c9132.png

  1. ממלאים את הפרטים הנדרשים.

3b7d3b33d81fe8ea.png

כדי למצוא את שם החבילה של Android, עוברים לספריית האפליקציות ב-Android Studio ופותחים קובץ בשם build.gradle. בקובץ, מחפשים את applicationId. הערך הזה הוא שם החבילה ב-Android. מעתיקים את הערך הזה ומדביקים אותו.

לא נצטרך את מפתח ה-SHA-1 כאן, אלא אם אתם מתכננים להשתמש ב-כניסה באמצעות חשבון Google או ב-קישורים דינמיים של Firebase (שימו לב שהם לא חלק מ-Codelab הזה. מידע נוסף על מפתח SHA-1 זמין במסמך הזה).

  1. לוחצים על הלחצן Register App (רישום האפליקציה).

הורדת קובץ התצורה

  1. לוחצים על הלחצן Download google-services.json כדי להוריד את קובץ התצורה google-services.json.

52f08aa18c8d59d0.png

  1. ב-Android Studio, עוברים לספרייה app ומעבירים את הקובץ google-services.json (שהורדתם למעלה) לספרייה app. חוזרים למסוף Firebase ולוחצים על הלחצן 'הבא'.

הפעלת Firebase באפליקציה

  1. כדי לקרוא את הקובץ google-services.json שנוצר על ידי Firebase, צריך את הפלאגין של Google Services Gradle.
  2. ב-Android Studio, פותחים את <project>/build.gradle ומוסיפים את השורות הבאות לקובץ:
buildscript { 
   repositories {
      // Check that you have the following line (if not, add it):
      google() //Google's Maven repository
   }
   dependencies {
      ...
      // Add this line
      classpath 'com.google.gms:google-services:4.3.4'
   }
}

allprojects {
   ...
   repositories {
      // Check that you have the following line (if not, add it):
      google() //Google's Maven repository
      ...
      }
   }
}
  1. פותחים את הקובץ <project>/<app-module>/build.gradle ומוסיפים את השורות הבאות לקובץ:
apply plugin: 'com.android.application'
// Add this line
apply plugin: 'com.google.gms.google-services'

סיימתם להוסיף את Firebase לאפליקציה ל-Android.

בשלב הבא נסביר איך להוסיף את Firebase SDK לאפליקציה.

4. הוספת Firebase SDK לאפליקציה

בשלב הזה מוסיפים את Firebase SDK, ובמיוחד את Firebase SDK for Google Analytics.

נשתמש ב-BoM של Firebase ל-Android, שמאפשר לכם לנהל את הגרסאות של ספריות Firebase שבהן אתם משתמשים באפליקציה על ידי ציון הגרסה של ה-BoM. כדי לבדוק אילו גרסאות של ספריות Firebase מותאמות לגרסה ספציפית של BoM, אפשר לעיין בהערות המוצר לגרסה הזו של BoM.

  1. פותחים את הקובץ <project>/<app-module>/build.gradle ומוסיפים את השורות הבאות לקובץ:
dependencies { 
   // ... 
   
   //Import the Firebase BoM
   implementation platform('com.google.firebase:firebase-bom:26.1.1')
   
   //Declare the dependency for the Firebase SDK for Google Analytics
   implementation 'com.google.firebase:firebase-analytics-ktx'

כפי שאפשר לראות, כשמציינים רק את גרסת BoM, אין צורך לציין את הגרסה של ספריית Firebase Analytics. אבל אם אתם רוצים להשתמש בגרסה הרצויה של ספריית Firebase ללא קשר לגרסה שצוינה ב-BoM, פשוט צריך לציין את הגרסה הרצויה באופן הבא:

dependencies { 
   // ... 
   
   //Import the Firebase BoM
   implementation platform('com.google.firebase:firebase-bom:26.1.1')
   
   //Declare the dependency for the Firebase SDK for Google Analytics
   implementation 'com.google.firebase:firebase-analytics-ktx:17.0.0'
  1. עכשיו מסנכרנים את האפליקציה בלחיצה על הלחצן Sync Now. 937206076c88ae5c.png

סיימתם להוסיף את Firebase SDK for Google Analytics לאפליקציה ל-Android.

בשלב הבא נסביר איך לתעד אירועים של Firebase באפליקציה ל-Android.

5. רישום אירועים ביומן באמצעות Firebase Analytics

בשלב הזה תלמדו איך לתעד אירועים באמצעות Firebase Analytics באפליקציה ל-Android.

יש 2 דרכים לרשום אירועים ביומן: שימוש באירועים מוצעים או באירועים מותאמים אישית.

שימוש בהצעות לאירועים

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

  1. מצהירים על אובייקט FirebaseAnalytics בחלק העליון של הפעילות:
private lateinit var firebaseAnalytics: FirebaseAnalytics
  1. מאתחלים את האובייקט בשיטה onCreate():
firebaseAnalytics = Firebase.analytics
  1. התחלת הרישום של אירועים ביומן באמצעות השיטה logEvent(). הקוד הבא מתעד אירוע PURCHASE כאשר משתמש רוכש פריטים באפליקציה:
firebaseAnalytics.logEvent(FirebaseAnalytics.Event.PURCHASE) {
   param(FirebaseAnalytics.Param.VALUE, 10)
   param(FirebaseAnalytics.Param.CURRENCY, "USE")
}

שימוש באירועים בהתאמה אישית

אם אתם צריכים אירועים שלא כלולים בהצעות, אתם יכולים לתעד אירועים מותאמים אישית משלכם עם פרמטרים מותאמים אישית:

firebaseAnalytics.logEvent("delete_item"){
   param("item name", name)
   param("reason", text)
}

אירועים של ניפוי באגים

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

כדי לבצע בדיקה וניפוי באגים באופן מיידי, אפשר להשתמש ב-Firebase Debugview. בעזרת DebugView אפשר לראות נתוני אירועים שתועדו על ידי האפליקציה במכשירי הפיתוח כמעט בזמן אמת. מידע על DebugView זמין בקטע ניפוי באגים באירוע.

סיימתם לרשום את האירועים באפליקציה ל-Android.

בשלב הבא נסביר איך לייבא את האירועים האלה ל-Google Ads.

6. ייבוא אירועים מ-Firebase אל Google Ads

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

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

412830708c61fdc0.png

  1. בכרטיסייה Integrations (שילובים), יופיעו Google Ads ולחצן Link (קישור). לוחצים על 'קישור והמשך'.

796c921fb2b873ae.png

  1. בוחרים את חשבון Google Ads שרוצים לקשר.

סיימתם לקשר את Firebase ל-Google Ads. עכשיו נייבא את אירועי Firebase אל Google Ads.

ייבוא אירועי Firebase

  1. במסוף Firebase, עוברים לתפריט 'אירועים' ומסמנים את האירוע שרוצים לייבא כהמרה.

a5f302ba01a1863c.png

  1. עכשיו, נכנסים ל-Google Ads ומתחברים לחשבון שמקשרים ל-Firebase.
  2. ב-Google Ads, עוברים אל 'כלים' ← 'מדידה' ← 'המרות' 7acf268d7e799a7e.png
  3. לחיצה על לחצן + d0eed72946d038d8.png
  4. בוחרים באפשרות 'אפליקציה' ← 'נכסי Google Analytics 4' (Firebase) ולוחצים על 'המשך'. 983f06edb15724de.png
  5. תוכלו לראות את כל האירועים של ניתוח נתונים שמסומנים כהמרות. מוצאים את האירוע שרוצים לייבא. במקרה כזה, צריך לבחור אירוע delete_item שכבר הטמעתם בעבר. לוחצים על הלחצן 'ייבוא והמשך'. f9bdee80c0d40999.png
  6. השלמת בהצלחה ייבוא של אירוע המרה מ-Firebase. be75f6a11913236.png

עכשיו סיימתם לייבא את אירועי Firebase ל-Google Ads.

בשלב הבא נסביר איך משיקים קמפיין לפעולה עם האירוע שיובאתם.

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

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

19856a65ab999ad7.png

  1. אנחנו נשיק קמפיין לקידום אפליקציה עם האפשרות 'התקנות אפליקציה'. למטה, בוחרים את האפליקציה שרוצים לקדם ולוחצים על 'המשך'. 8146b5a7a4f961bd.png
  2. בקטע 'בידינג', אם בוחרים באפשרות 'פעולות בתוך האפליקציה' בתפריט הנפתח, אפשר לראות אירועים. בוחרים את האירועים שבהם רוצים להתמקד.

b75e410c7dbdfec8.png

  1. קובעים את שאר הגדרות הקמפיין ומסיימים.

8. מזל טוב

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

מה למדתם

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