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

1. מבוא

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

מה תפַתחו

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

ה-Codelab הזה מתמקד בהטמעת אירועים עם GA4F וייבוא האירועים ל-Google Ads. אם אתם רוצים ללמוד איך לפתח אפליקציה ל-Android באמצעות Firebase, תוכלו לקרוא את המאמר צ'אט ידידותי ל-Android Codelab-Build ב-Firebase.

מה תלמדו

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

מה צריך להכין

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

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

כדי להתחיל בעבודה עם Firebase, עליך ליצור ולהגדיר פרויקט Firebase.

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

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

במסוף Firebase, לוחצים על Add Project(או Create a project) ונותנים לפרויקט ב-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. לוחצים על הלחצן 'רישום האפליקציה'.

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

  1. לוחצים על הלחצן 'הורדת 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.

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

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.
  • איך מייבאים אירועים ומשתמשים בהם בקמפיינים עם קריאה לפעולה.