Google Ads עם Google Analytics for Firebase אירועים מותאמים אישית - אנדרואיד

1. הקדמה

עדכון אחרון: 14-12-2020

מה שתבנה

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

מעבדת קוד זה מתמקדת ביישום אירועים עם GA4F ובייבוא ​​האירועים ב-Google Ads. אם אתה רוצה ללמוד כיצד לבנות אפליקציית אנדרואיד עם Firebase, עיין ב- Firebase Android Codelab-Build Chat 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. אם יש לך אחד בחר את זה או צור אחד חדש. לחץ על כפתור צור פרויקט.

ac928e5947ba7cbf.png

  1. כעת בניית פרויקט Firebase הסתיימה!

בשלב הבא, תלמד כיצד להוסיף Firebase לאפליקציית Android שלך.

3. הוסף את Firebase לאפליקציית Android שלך

הרשמה אפליקציה

  1. ב-Firebase Console, בחר סקירת פרויקט בניווט השמאלי ולאחר מכן לחץ על כפתור Android תחת "התחל על ידי הוספת Firebase לאפליקציה שלך"

6cbb33ad3e7c9132.png

  1. מלא את המידע הדרוש.

3b7d3b33d81fe8ea.png

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

איננו זקוקים למפתח SHA-1 כאן, אלא אם כן אתה מתכנן להשתמש ב-Google Sign In או Firebase Dynamic Links (שים לב שהם אינם חלק ממעבדת קוד זה, למידע נוסף על מפתח SHA-1, עיין במסמך זה). .

  1. לחץ על כפתור הרשמה אפליקציה.

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

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

52f08aa18c8d59d0.png

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

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

  1. אתה צריך את הפלאגין של Google Services Gradle כדי לקרוא את הקובץ google-services.json שנוצר על ידי Firebase.
  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 עבור 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. אבל אם אתה רוצה להשתמש בגרסה הרצויה עבור ספריית 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 עבור Google Analytics לאפליקציית Android שלך!

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

5. רישום אירועים עם Firebase Analytics

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

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

שימוש באירועים מוצעים

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