תיוג בצד השרת לאפליקציות לנייד

אתם יכולים להגדיר את האפליקציות לנייד באמצעות Google Analytics for Firebase SDK כדי לעבוד עם תיוג בצד השרת ב-Google Tag Manager.

תיוג בצד השרת מאפשר לכם להכין את הנתונים, לצנזר אותם ולהוסיף להם מידע לפני שאתם שולחים אותם למוצרי יעד כמו Google Analytics. מידע נוסף על תיוג בצד השרת

כדי להגדיר תיוג בצד השרת באפליקציות לנייד:

1. הכנת האפליקציה לתיוג בצד השרת
2. הגדרת מאגר התגים בצד השרת לתמיכה בתנועה שמגיעה ממובייל
3. הפעלת תיוג בצד השרת בנכס ב-Google Analytics

דרישות מוקדמות

• צריך לכלול את Google Analytics for Firebase SDK באפליקציה ולקשר אותה לנכס ב-Google Analytics. מידע נוסף על Google Analytics for Firebase SDK
• אתם צריכים חשבון Google Tag Manager ומאגר תגים בצד השרת. אם אין לכם חשבון, יוצרים חשבון חדש ומאגר תגים חדש של Tag Manager.
• צריך להגדיר שרת תיוג.

שלב 1: הכנת האפליקציה לתיוג בצד השרת

iOS

1. מפעילים את תכונת ההעלאה של תיוג בצד השרת ומגדירים את סכימת כתובות ה-URL המותאמת אישית למצב ניפוי הבאגים של תיוג בצד השרת בקובץ Info.plist. מחליפים את BUNDLE_ID במזהה החבילה של האפליקציה.

   <?xml version="1.0" encoding="UTF-8"?>
   <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
   <plist version="1.0">
   <dict>
   ...
           <key>CFBundleURLTypes</key>
           <array>
                   <dict>
                           <key>CFBundleTypeRole</key>
                           <string>None</string>
                           <key>CFBundleURLName</key>
                           <string>BUNDLE_ID</string>
                           <key>CFBundleURLSchemes</key>
                           <array>
                                   <string>tagmanager.sgtm.c.BUNDLE_ID</string>
                           </array>
                   </dict>
           </array>
           <key>GOOGLE_ANALYTICS_SGTM_UPLOAD_ENABLED</key>
           <true/>
   </dict>
   </plist>
   

2. כדי להפעיל את מצב ניפוי הבאגים או מצב התצוגה המקדימה, מוסיפים קריאה ל-Analytics.handleOpen(_:) בשיטת מחזור חיים כדי להעביר את כתובת ה-URL להפעלה.

   SwiftUI

   @main
   struct MyApplication: App {
     var body: some Scene {
       WindowGroup {
         ContentView()
           .onOpenURL { url in
             Analytics.handleOpen(url)
           }
       }
     }
   }
   

   UIScene

   class SceneDelegate: UIResponder, UIWindowSceneDelegate {
   func scene(_ scene: UIScene, willConnectTo session: UISceneSession,
           options connectionOptions: UIScene.ConnectionOptions) {
   ...
       if let urlContext = connectionOptions.urlContexts.first {
           let url = urlContext.url
           Analytics.handleOpen(url)
       }
     }
   }
   

   אם האפליקציות לא משתמשות ב-SwiftUI או ב-UIScene, לא נדרשת שום פעולה. ‫SDK מקבל את כתובת ה-URL להפעלה מApplicationDidFinishLaunchingNotification.

Android

1. מתקינים את הגרסה האחרונה של Google Analytics for Firebase SDK.

2. כדי להפעיל את sGTM, מוסיפים את הקוד הבא לקובץ AndroidManifest.xml של האפליקציה.

   <!-- Preview Activity to enable preview mode -->
   <activity
       android:name="com.google.firebase.analytics.GoogleAnalyticsServerPreviewActivity"
       android:exported="true"
       android:noHistory="true" >
     <intent-filter>
       <action android:name="android.intent.action.VIEW" />
       <category android:name="android.intent.category.DEFAULT" />
       <category android:name="android.intent.category.BROWSABLE" />
       <data android:scheme="tagmanager.sgtm.c.<APP_PACKAGE_ID>" />
     </intent-filter>
   </activity>
   
   <!-- Meta-data that enables uploads to sGTM -->
   <meta-data android:name="google_analytics_sgtm_upload_enabled" android:value="true" />
   

   הערה: <APP_PACKAGE_ID> צריך להיות באותיות קטנות בלבד. התאמת הסכימה ב-Android framework היא תלוית-רישיות, בניגוד ל-RFC.

שלב 2: הגדרת מאגר התגים בשרת כך שיכלול תמיכה בתנועה ממכשירים ניידים

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

הגדרת הלקוח Google Analytics: GA4 (App)‎

לקוח הוא סוג משאב ב-Tag Manager שמיירט סוגים מסוימים של בקשות נכנסות ומפיק אירועים שאפשר להעביר ליעד, כמו Google Analytics. במקרה הזה, בקשת ה-HTTP היא אירוע של Google Analytics, ולכן צריך להגדיר את הלקוח המובנה Google Analytics: GA4 (App). צריך רק לקוח Google Analytics אחד לכל מקור נתונים, כמו GA SDK ואתר. מידע נוסף על אופן הפעולה של לקוחות

1. במאגר תגים בצד השרת, עוברים אל Clients (לקוחות) ולוחצים על New (חדש).

2. לוחצים על הגדרת לקוח ואז בוחרים באפשרות Google Analytics: GA4 (אפליקציה).

   

3. מזינים שם ללקוח ולוחצים על שמירה.

הגדרת התג Google Analytics: הגדרה אישית של GA4

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

1. במאגר תגים בצד השרת, עוברים אל Tags (תגים) ולוחצים על New (חדש).

2. לוחצים על Tag Configuration (הגדרת תג) ואז בוחרים באפשרות Google Analytics: GA4 (Google Analytics:‏ GA4).

   

כברירת מחדל, התג יקבל בירושה את כל השדות והפרמטרים הרלוונטיים מאובייקט נתוני האירוע שנוצר על ידי הלקוח:

• אם הבקשה הנכנסת של Google Analytics עוברת דרך הלקוח Google Analytics: GA4 (App), התג מקבל בירושה את מזהה האפליקציה ואת פרמטרי האירוע.
• אם הבקשות הנכנסות של Google Analytics עוברות דרך הלקוח Google Analytics: GA4 (Web), התג מקבל בירושה את מזהה המדידה ואת פרמטרים האירוע.

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

הגדרת טריגרים לתנועה שמגיעה ממובייל

לאחר מכן צריך לקבוע מתי תג GA4 יופעל. הלקוח Google Analytics: GA4 (App) מנתח את הבקשה הנכנסת לאובייקט של נתוני אירועים, והתג יקבל את הערכים שלו בירושה. לכן, בדרך כלל תרצו שהתג יופעל בכל פעם שלקוח GA4 יטען את הבקשה.

כדי להגדיר את הטריגרים:

1. בהגדרות התג, לוחצים על טריגרים.
2. כדי ליצור טריגר חדש, לוחצים על הסמל + בפינה השמאלית העליונה.
3. לוחצים על Trigger Configuration (הגדרת הטריגר) כדי לבחור את סוג הטריגר.

4. בוחרים באפשרות בהתאמה אישית או אירוע מותאם אישית מהרשימה.

   • סוג הטריגר Custom trigger (טריגר בהתאמה אישית) מפעיל את התג כברירת מחדל כשאירוע כלשהו נוצר על ידי לקוח בצד השרת.
   • אפשר להשתמש בסוג הטריגר אירוע בהתאמה אישית כדי להפעיל את התג בשם אירוע ספציפי או באירוע שתואם לדפוס של ביטוי רגולרי.

5. כדי להפעיל את רשימת תנאי ההפעלה של הטריגר הזה, למשל כדי שהטריגר יופעל רק על נתוני אירועים בנייד או באינטרנט, בוחרים באפשרות Some Events (חלק מהאירועים).

   1. האפשרות שם האירוע תהיה מסומנת מראש. לוחצים על בורר המשתנים ובוחרים באפשרות Choose Built-In Variable (בחירת משתנה מובנה) מהרשימה.
   2. כדי להחזיר באופן אוטומטי את השם של הלקוח שיצר את האירוע, בוחרים באפשרות שם הלקוח.
   3. משתמשים בשם של הלקוח שהגדרתם קודם כדי להגדיר את התנאי בהתאם. הטריגר אמור להיראות כך:

   

   הערה: שם הלקוח הוא השם שציינתם בשלב הקודם. סוג הלקוח הוא Google Analytics: GA4 (אפליקציה). המשתנה Client Name מחזיר את השם ולא את הסוג של הלקוח.

6. שומרים את הטריגר ומזינים שם תיאורי. לדוגמה, אפשר להשתמש בערך 'All GA4 App Events'.

7. עכשיו אמורים לחזור להגדרות התג עם הטריגר החדש במקומו. שומרים את התג ומזינים שם תיאורי, לדוגמה GA4. התג אמור להיראות כך:

   

הערה: כדי למנוע שליחה של אירועים מסוימים, אפשר להשתמש בטריגרים בהתאמה אישית עם לוגיקה מותנית שמבוססת על שם האירוע (או על משתנה אחר) או להוסיף חריגים לטריגרים. מידע נוסף על הפעלת טריגרים ועל חריגים של טריגרים

תצוגה מקדימה של מאגר התגים

אתם יכולים להשתמש ב-Google Tag Manager כדי לצפות בתצוגה מקדימה של מאגר התגים בצד השרת ולנפות בו באגים לפני פרסום השינויים. שימו לב: התצוגה המקדימה לא תפעל עד שתפעילו תיוג בצד השרת בנכס ב-Google Analytics.

כדי שהבקשות מהאפליקציה יפעילו את הגדרת התצוגה המקדימה, צריך:

1. במאגר התגים בצד השרת ב-Google Tag Manager, לוחצים על תצוגה מקדימה.
2. לוחצים על סמל הפעולות הנוספות ⋮ בפינה השמאלית העליונה ובוחרים באפשרות שליחת בקשות מאפליקציה.

3. מזינים את מזהה האפליקציה ולוחצים על יצירת קוד QR.

   הערה: מזהה האפליקציה חייב להתחיל באות. לחלופין, אפשר להשתמש בכל מזהה ייחודי שמתחיל באות, כל עוד הוא זהה למזהה שמופיע בקובץ Info.plist או AndroidManifest.xml.

   

4. סורקים את קוד ה-QR באמצעות אפליקציית המצלמה בטלפון. ממשיכים לקיים אינטראקציה עם האפליקציה כרגיל כדי ליצור אירועי תצוגה מקדימה.

5. לוחצים על OK כדי לסגור את תיבת הדו-שיח.

פרסום מאגר התגים

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

שלב 3: הפעלת תיוג בצד השרת בנכס ב-Google Analytics

1. בנכס ב-Google Analytics, עוברים אל ניהול.
2. פותחים את מקורות נתונים.

3. בוחרים את הגדרות מקור הנתונים של האפליקציה בכרטיסייה iOS או Android.

   

4. לוחצים על קביעת הגדרות SDK ואז על הגדרת Tag Manager בצד השרת.

   

5. כדי לאפשר ל-SDK לשלוח נתוני מדידה לכתובת ה-URL של מאגר התגים בצד השרת:

   1. מעבירים את המתג שליחת נתונים למאגר התגים בצד השרת של Tag Manager למצב מופעל.
   2. מעתיקים את כתובת ה-URL של מאגר התגים בצד השרת. אפשר למצוא את ההגדרה הזו ב-Google Tag Manager דרך Admin (אדמין) > Container Settings (הגדרות מאגר תגים) > Server container URLs (כתובות URL של מאגר תגים בצד השרת).

   3. בוחרים את אחוז התנועה שרוצים להפנות למאגר התגים של השרת. אתם יכולים לבחור באפשרות מתחת ל-100% כדי לאמת את ההגדרה וההגדרה האישית של השרת לפני שתשתמשו בתיוג בצד השרת לכל התנועה.

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

   

6. לוחצים על שמירה. ערכת ה-SDK תאחזר את כתובת ה-URL המעודכנת של מאגר התגים בצד השרת ותפנה אליה את נתוני המדידה.

מגבלות ידועות

• באפליקציות ל-Android:

  • רכישות באפליקציה שנרשמות באופן אוטומטי מסתמכות על שילוב עם ה-בק-אנד של Google Play, ולא יישלחו למאגר תגים בצד השרת.
  • אירוע app_remove לא ידווח ב-Android.

• עדיין צריך לקשר את המקורות לנתוני האפליקציה ב-Google Analytics לחשבון Google Ads כדי לוודא שהנתונים וההמרות מ-SDK מיובאים אל Google Ads. תיוג בצד השרת לא מציע שילוב מובנה בין ה-SDK לבין Google Ads.

הערה: ‏ Google Analytics for Firebase SDK מתוכנן ומותאם לשליחת נתונים אל Google Analytics. אחר כך אפשר לקשר את Google Analytics ל-Google Ads כדי לדווח על המרות, ליצור קהלים, לבצע אופטימיזציה של קמפיינים ולבנות מודלים. הוא כולל תיוג בצד השרת לאפליקציות, ואנחנו ממליצים ללקוחות להשתמש בשילוב בין Google Analytics לתיוג בצד השרת ב-Google Tag Manager.

API

אפשר להשתמש ב-API בארכיטקטורת REST של Tag Manager כדי לגשת לנתוני ההגדרה של Tag Manager. מידע נוסף על ה-API:

• במדריך למפתחים מוסבר איך עובדים עם ה-API.
• כדאי לעיין בהפניה ל-Tag Manager API כדי להכיר את המשאבים של Tag Manager ואת הפעולות הזמינות.