השקת קמפיינים ב-Google Ads עם אירועים מותאמים אישית ו-Flutter של Google Analytics

1. מבוא

עדכון אחרון: 25 בינואר 2021

מה תפַתחו

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

נשתמש באפליקציית ברירת המחדל של Flutter עם ווידג'ט מונה פשוט. אנחנו נפרסם את האפליקציה שלנו למשתמשים פוטנציאליים שככל הנראה ילחצו על הווידג'ט המונה.

מה תלמדו

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

מה צריך להכין

• Android Studio 3.6 ואילך
• Xcode (לתמיכה ב-iOS)
• חשבון Firebase
• חשבון Google Ads

2. התחלת פרויקט חדש של Flutter

יצירת אפליקציית Flutter פשוטה בתבנית. עליך לבצע שינויים באפליקציה הזו לתחילת פעולה ב-Codelab הזה.

מפעילים את Android Studio.

הערה: אם האפשרות New Flutter Project לא מופיעה בסביבת הפיתוח המשולבת, כדאי לוודא שיישומי הפלאגין מותקנים עבור Flutter ו-Dart.

1. אם אין לכם פרויקטים פתוחים, בוחרים באפשרות Start a new Flutter ap בדף הפתיחה. אחרת, בחרו באפשרות קובץ > חדש > פרויקט חדש של Flutter.
2. בוחרים את סוג הפרויקט Flutter Application. לוחצים על Next.
3. יש לוודא שהנתיב של Flutter SDK מציין את מיקום ה-SDK. (אם שדה הטקסט ריק, בוחרים באפשרות התקנת SDK).
4. מזינים את שם הפרויקט ולוחצים על Next.
5. משתמשים בשם החבילה שמוגדר כברירת מחדל, שהוצע על ידי Android Studio, ולוחצים על הבא.
6. לוחצים על סיום.
7. ממתינים עד ש-Android Studio יתקין את ה-SDK ותיצור את הפרויקט.

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

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

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

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

במסוף Firebase, לוחצים על Add Project (או Create a project) ונותנים לפרויקט Firebase-Flutter-Ads או כל שם אחר שתרצו.

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

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

4. הגדרת Firebase ספציפית לפלטפורמה (Android)

הגדרת Android

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

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

2. הערך שחשוב לציין הוא שם החבילה ב-Android, שאותו אפשר לקבל באמצעות השלב הבא.

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

3. בספריית האפליקציה Flutter, פותחים את הקובץ android/app/src/main/AndroidManifest.xml.
4. ברכיב manifest, מוצאים את ערך המחרוזת של המאפיין package. הערך הזה הוא שם החבילה של Android (בדומה ל-com.yourcompany.yourproject). מעתיקים את הערך הזה.
5. בתיבת הדו-שיח של Firebase, מדביקים את שם החבילה שהועתק בשדה Android package name.
6. אנחנו לא צריכים את מפתח SHA-1 כאן, אלא אם אתם מתכננים להשתמש בכניסה באמצעות חשבון Google או בקישורים דינמיים ב-Firebase (שימו לב: הם לא חלק מ-Codelab הזה). אם בכוונתך לייבא נתונים של in_app_purchase מ-Google Play, צריך להגדיר את המפתח בשלב מאוחר יותר.
7. לוחצים על רישום האפליקציה.
8. אם ממשיכים ב-Firebase, פועלים לפי ההוראות להורדת קובץ התצורה google-services.json.

9. עוברים לספריית האפליקציות של Flutter ומעבירים את הקובץ google-services.json (שהורדתם עכשיו) לספרייה android/app.
10. חוזרים למסוף Firebase, מדלגים על השלבים הנותרים וחוזרים לדף הראשי של מסוף Firebase.
11. לבסוף, צריך את הפלאגין של Google Services Gradle כדי לקרוא את הקובץ google-services.json שנוצר על ידי Firebase.
12. בסביבת הפיתוח המשולבת או בכלי העריכה, פותחים את android/app/build.gradle ומוסיפים את השורה הבאה כשורה האחרונה בקובץ:

apply plugin: 'com.google.gms.google-services'

13. פותחים את android/build.gradle, ולאחר מכן מוסיפים תלות חדשה בתוך התג buildscript:

buildscript { 
   repositories {
      // ...
   }
   dependencies {
      // ...
      Classpath 'com.google.gms:google-services:4.3.3'
   }
}

14. אם האפליקציה עדיין פועלת, סוגרים את האפליקציה ויוצרים אותה מחדש כדי לאפשר לה להתקין יחסי תלות.

סיימת להגדיר את אפליקציית Flutter ל-Android! לגבי iOS, כדאי לעיין ב-Codelab הזה ( היכרות עם Firebase for Flutter)

5. הגדרת Firebase Analytics ב-Flutter

בשלב הזה תתחילו להשתמש בחבילה של Firebase Analytics בשם firebase_analytics, שמכילה תכונות של Firebase Analytics.

קובץ ה-pubspec מנהל את הנכסים של אפליקציית Flutter. ב-pubspec.yaml, צריך להוסיף את firebase_analytics: ^6.2.0 (firebase_analytics 6.2.0 ואילך) לרשימת יחסי התלות :

dependencies: 
   flutter: 
      sdk: flutter 
   cupertino_icons: ^0.1.2 
   firebase_analytics: ^6.2.0   # add this line

בזמן הצפייה במפרט של המפרסם בתצוגת העריכה של Android Studio, לוחצים על Package get. הפעולה הזו מושכת את החבילה לפרויקט. אתם אמורים לראות את הנתונים הבאים במסוף:

flutter packages get 
Running "flutter packages get" in startup_namer... 
Process finished with exit code 0

אם מבצעים את הפעולה Pub get, גם הקובץ pubspec.lock נוצר באופן אוטומטי עם רשימה של כל החבילות שנשלפו אל הפרויקט ומספרי הגרסאות שלהן.

זהירות: בגרסאות ספציפיות של Firebase, הערך java.lang.IllegalArgumentException: Service not registered מוצג באתחול הראשון של המחלקה FirebaseAnalytics (אפשר לעיין בבעיה 1662 ב-github).

ב-lib/main.dart, מייבאים את החבילה החדשה:

import 'package:firebase_analytics/firebase_analytics.dart';

במחלקה MyApp, צריך ליזום את האובייקט FirebaseAnalytics על ידי קריאה ל-constructor.

class MyApp extends StatelessWidget {
 static FirebaseAnalytics analytics = FirebaseAnalytics();
   ...
}

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

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

אם תיצרו תבנית חדשה באפליקציית Flutter, תראו את המשתנה _counter, ואת ה-method _incrementCounter() בתוך המחלקה State שמוגדרת כברירת מחדל. עכשיו אתם רוצים לתעד אירועים מותאמים אישית כשאנשים נלהבים יותר מדי לחיצה על לחצן ההגדלה. בהמשך נשיק קמפיין לקידום אפליקציה כדי למשוך משתמשים פוטנציאליים נלהבים

קודם כול אנחנו רוצים להעביר את האובייקטים האנליטיים שאתחלנו לווידג'ט Stateful. מתחילים בהוספת פרמטר של Analytics ל-constructor של MyHomePage.

MyHomePage({Key key, this.title, this.analytics}) : super(key: key);

צריך גם להוסיף פרמטר של Analytics כשמפעילים את ה-constructor.

home: MyHomePage(
   title: 'Flutter Demo Home Page',
   analytics: analytics,
),

עכשיו אפשר לתעד אירועים בקלות בעזרת השיטה logEvent(). מוסיפים את השיטה ומגדילים את המשתנה _counter.

void _incrementCounter() {
 setState(() {
   _counter++;

   //add this
   if(_counter > 5) { 
     widget.analytics.logEvent(name: "clicked_counter"); 
   }

 });
}

האפליקציה שלך מוכנה להפעיל את יומן האירועים בהתאמה אישית!

אתם יכולים גם להשתמש בשיטות מוכנות מראש להפעלת אירועים.

עכשיו הכול מוכן. ב-Android Studio, מריצים את הפקודהmain.dart.

(אופציונלי) שליחת מידע נוסף ל-Firebase Analytics באמצעות פרמטרים

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

כאן אנחנו מגדירים את הערך _counter כפרמטר.

void _incrementCounter() {
 setState(() {
   _counter++;

   if(_counter > 5) {
     widget.analytics.logEvent(name: "clicked_counter", parameters: {'count' : _counter});
   }
 });
}

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

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

כדי לסמן את clicked_counter כהמרה, מזיזים את המתג סימון כהמרה שמאלה.

אם האירוע נמצא בכרטיסייה 'המרה', סימן שסימנתם בהצלחה את האירוע כהמרה. עכשיו מערכת Google Ads תוכל לייבא את האירוע הזה מ-Firebase.

למטרות ניפוי באגים, אפשר להשתמש ב-Firebase DebugView. מידע נוסף מופיע במאמר בנושא ניפוי באגים באירוע.

7. ייבוא אירועים מ-Analytics ב-Google Ads

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

1. עוברים אל הגדרות Firebase על ידי לחיצה על הלחצן לצד סקירה כללית של הפרויקט.
2. בכרטיסייה Integrations (שילובים) יוצגו הלחצן Google Ads והלחצן Link (קישור). לוחצים על קישור ואז על המשך.

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

אזהרה: אם אירוע היעד לא מסומן כאירוע המרה, מערכת Google Ads לא תוכל לייבא אותו. צריך לוודא שהאירוע מסומן כראוי כהמרה.

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

נכנסים ל-Google Ads.

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

3. בוחרים באפשרות נכסי Google Analytics 4 (Firebase) ולוחצים על המשך.

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

5. בודקים את הפעולה, לוחצים על ייבוא ואז לוחצים על המשך.

אחרי שמגדירים את clicked_counter כפעולת המרה, אפשר להפעיל קמפיינים עם קריאה לפעולה שיכולים לטרגט משתמשים שצפויים להפעיל אירועי clicked_counter יותר מ-5 פעמים.

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

חשוב: כדי להשיק קמפיין לקידום אפליקציה, צריך להשיג אפליקציה ברמת הייצור ב-Google Play. עם זאת, אם עדיין לא מוכנים לפרסום, אפשר לדלג על השלב הזה בינתיים.

6. עוברים לכרטיסיית הקמפיין בחשבון הנוכחי ויוצרים קמפיין חדש על ידי לחיצה על הלחצן +. לוחצים על [קמפיין חדש] ואז על המשך.
7. משיקים קמפיין לקידום אפליקציה עם האפשרות התקנות אפליקציה.

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

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

9. מזל טוב

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

למדתם

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