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

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

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

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

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

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

• צריך לכלול את Google Analytics for Firebase SDK באפליקציה ולקשר אותו לנכס Google Analytics 4. מידע נוסף על 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(_:) ב-method של מחזור החיים כדי להעביר את כתובת ה-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" />
   

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

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

הגדרת הלקוח Google Analytics: GA4 (אפליקציה)

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

1. בקונטיינר השרת, עוברים אל Clients ולוחצים על New.

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

   

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

הגדרת התג 'Google Analytics: תצורת GA4'

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

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

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

   

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

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

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

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

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

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

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

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

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

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

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

   3. משתמשים בשם הלקוח שהגדרתם קודם כדי להגדיר את התנאי בהתאם. הטריגר אמור להיראות כך:

      

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

6. שומרים את הטריגר ומזינים שם תיאורי. לדוגמה, אפשר להשתמש באפשרות 'כל אירועי האפליקציה ב-GA4'.

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

   

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

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

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

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

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

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

   

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

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

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

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

שלב 3: מפעילים תיוג בצד השרת בנכס GA4

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

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

   

4. לוחצים על Configure SDK settings (הגדרת הגדרות ה-SDK) ואז על Configure server-side Tag Manager (הגדרת Tag Manager בצד השרת).

   

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

   1. מפעילים או משביתים את האפשרות שליחת נתונים למאגר תגים בצד השרת של Tag Manager.
   2. מעתיקים את כתובת ה-URL של מאגר התגים בצד השרת. אפשר למצוא את הפרטים האלה ב-Google Tag Manager בקטע אדמין > הגדרות מאגר התגים > כתובות URL של מאגר התגים בשרתי.

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

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

   

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

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

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

  • כדי למנוע נקודות חולשה פוטנציאליות באבטחה שכוללות מאגרי שרתים ו-Google Play Services, האירועים יעברו דרך שרת proxy ללא מצב (stateless) בין ה-SDK לבין מאגר השרתים. שרת ה-proxy יאמת את המקור ואת נקודת הקצה של הבקשה, אבל לא יבדוק או יאחסן נתונים לגבי האירועים. בהתאם לאופן שבו מערכת GA4 אוספת נתונים ממכשירים שנמצאים באיחוד האירופי, שרת ה-proxy יהיה באיחוד האירופי עבור תנועה שנמצאת באיחוד האירופי.
  • רכישות מתוך האפליקציה שמתועדות באופן אוטומטי מסתמכות על השילוב עם הקצה העורפי של Google Play, ולא יישלחו לקונטיינר השרת.
  • האירוע app_remove לא ידווח ב-Android.

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

API

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

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