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

1. מבוא

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

מה תפַתחו

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

נשתמש באפליקציית 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.

הערה: אם האפשרות 'פרויקט Flutter חדש' לא מופיעה בסביבת הפיתוח המשולבת, צריך לוודא שהתוספים של Flutter ו-Dart מותקנים.

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

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

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

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

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

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

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

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

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

הגדרת Android

1. במסוף Firebase, בוחרים באפשרות Project Overview (סקירת הפרויקט) בסרגל הניווט הימני, ואז לוחצים על הלחצן 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 הזה). אם אתם מתכננים לייבא נתונים מ-Google Play, תצטרכו להגדיר את המפתח מאוחר יותר.in_app_purchase
7. לוחצים על Register App (רישום האפליקציה).
8. ממשיכים ב-Firebase ופועלים לפי ההוראות להורדת קובץ התצורה google-services.json.

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

סיימתם להגדיר את אפליקציית Flutter ל-Android. לגבי iOS, כדאי לעיין ב-codelab הזה ( Get to know Firebase for Flutter)

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

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

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

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

כשצופים בקובץ pubspec בתצוגת העריכה של Android Studio, לוחצים על Packages 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 על ידי קריאה לפונקציית הבנאי.

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

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

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

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

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

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

בנוסף, תוסיפו פרמטר של ניתוח נתונים כשמפעילים את ה-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 value כפרמטר.

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

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

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

אחרי כמה שעות, תוכלו לראות את האירועים שנרשמו במסוף Firebase. פשוט לוחצים על הכרטיסייה Events (אירועים) בקטע 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 Settings (הגדרות Firebase) בלחיצה על הלחצן לצד Project Overview (סקירת הפרויקט).
2. בכרטיסייה Integrations (שילובים) יופיע Google Ads ולחצן Link (קישור). לוחצים על קישור ואז על המשך.

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

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

החלק שקשור ל-Firebase הסתיים.

נכנסים אל Google Ads.

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

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

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