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

1. מבוא

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

מה תפַתחו

בקודלאב הזה תלמדו איך להטמיע אירועים באמצעות 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, בוחרים באפשרות Project Overview (סקירה כללית של הפרויקט) בסרגל הניווט הימני, ואז לוחצים על הלחצן Android בקטע 'תחילת העבודה: הוספת Firebase לאפליקציה'.

6cbb33ad3e7c9132.png

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

3b7d3b33d81fe8ea.png

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

לא נצטרך את המפתח SHA-1 כאן, אלא אם אתם מתכננים להשתמש ב-Google Sign In או ב-Firebase Dynamic Links (שימו לב: הנושאים האלה לא כלולים ב-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 ולוחצים על הלחצן Next (הבא).

הפעלת 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.

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

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

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