Tagging lato server per le app mobile

Puoi configurare le tue app mobile utilizzando l'SDK Google Analytics for Firebase per utilizzarle con il tagging lato server in Google Tag Manager.

Il tagging lato server ti consente di eseguire il staging, oscurare e integrare i dati prima di inviarli ai prodotti di destinazione come Google Analytics. Scopri di più sul tagging lato server.

Per configurare il tagging lato server per le app mobile:

1. Preparare l'app per il tagging lato server
2. Configurare il contenitore del server per supportare il traffico mobile
3. Attivare il tagging lato server nella proprietà GA4

Prerequisiti

• Devi includere l'SDK Google Analytics for Firebase nella tua app e collegarlo alla tua proprietà Google Analytics 4. Scopri di più sull'SDK Google Analytics for Firebase.
• Devi avere un account Google Tag Manager e un contenitore del server. Se non ne hai uno, crea un nuovo account e un nuovo contenitore Tag Manager.
• Devi configurare un server di tagging.

Passaggio 1: prepara la tua app per il tagging lato server

iOS

1. Attiva la funzionalità di caricamento del tagging lato server e configura lo schema URL personalizzato per la modalità di debug del tagging lato server nel file Info.plist. Sostituisci BUNDLE_ID nel seguente codice con l'identificatore del bundle dell'app.

   <?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. Per attivare la modalità di debug o di anteprima, aggiungi una chiamata a Analytics.handleOpen(_:) in un metodo di ciclo di vita per passare l'URL di lancio.

   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)
       }
     }
   }
   

   Per le app che non utilizzano SwiftUI o UIScene, non è richiesta alcuna azione. L'SDK riceve l'URL di lancio daApplicationDidFinishLaunchingNotification.

Android

1. Installa la release più recente dell'SDK Google Analytics for Firebase.

2. Attiva sGTM aggiungendo quanto segue al file AndroidManifest.xml dell'applicazione.

   <!-- 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" />
   

Passaggio 2: configura il contenitore del server per supportare il traffico mobile

La sezione seguente presuppone che tu abbia già eseguito il deployment del tagging lato server e che tu abbia familiarità con i relativi concetti. Se non hai mai utilizzato il tagging lato server, puoi seguire il corso sui concetti fondamentali del tagging lato server.

Configurare il client Google Analytics: GA4 (app)

Un client è un tipo di risorsa di Tag Manager che intercetta determinati tipi di richieste in entrata e genera eventi che possono essere trasmessi a una destinazione, come Google Analytics 4. In questo caso, la richiesta HTTP è un evento Google Analytics 4, quindi devi configurare il client Google Analytics: GA4 (app) integrato. È necessario un solo client GA4 per origine dati, ad esempio SDK GA e sito web. Scopri di più su come funzionano i client.

1. Nel contenitore del server, vai a Client e fai clic su Nuovo.

2. Fai clic su Configurazione client e poi seleziona Google Analytics: GA4 (app).

   

3. Inserisci un nome per il cliente e fai clic su Salva.

Configura il tag Google Analytics: GA4

Per inviare i dati a Google Analytics, devi creare un tag Google Analytics: GA4 nel contenitore del server. Il client analizza la richiesta HTTP in arrivo in un oggetto di dati sugli eventi. Il tag acquisirà questo oggetto di dati sugli eventi, lo mapperà al formato corretto e lo invierà a Google Analytics 4.

1. Nel contenitore del server, vai a Tag e fai clic su Nuovo.

2. Fai clic su Configurazione tag e scegli Google Analytics: GA4.

   

Per impostazione predefinita, il tag eredita tutti i campi e i parametri pertinenti dall'oggetto dati sugli eventi creato dal client:

• Se la richiesta in arrivo di Google Analytics 4 passa per il client Google Analytics: GA4 (app), il tag eredita l'ID app e i parametri dell'evento.
• Se le richieste in arrivo di Google Analytics 4 passano per il client Google Analytics: GA4 (web), il tag eredita l'ID misurazione e i parametri evento.

Suggerimento: se vuoi, puoi utilizzare le trasformazioni per includere, escludere o modificare i parametri evento generati dal client prima che vengano esposti ai tag. Con le trasformazioni puoi salvaguardare le informazioni sensibili e avere un controllo granulare sui parametri evento disponibili per un'ulteriore elaborazione.

Configurare gli attivatori per il traffico mobile

Devi quindi stabilire quando deve essere attivato il tag GA4. Il client Google Analytics: GA4 (app) analizza la richiesta in arrivo in un oggetto dati sugli eventi e il tag erediterà i relativi valori. Pertanto, in genere è consigliabile attivare il tag ogni volta che il client GA4 acquisisce la richiesta.

Per configurare gli attivatori:

1. Nelle impostazioni del tag, fai clic su Attivazione.
2. Per creare un nuovo attivatore, fai clic sull'icona + nell'angolo in alto a destra.
3. Fai clic su Configurazione attivatore per scegliere il tipo di attivatore.

4. Scegli Personalizzato o Evento personalizzato dall'elenco.

   • Per impostazione predefinita, il tipo di attivatore personalizzato attiva il tag quando qualsiasi evento viene generato da un client lato server.
   • Il tipo di attivatore Evento personalizzato può essere utilizzato per attivare il tag in base a un nome evento specifico o a un evento che corrisponde a un pattern di espressioni regolari.

5. Per attivare l'elenco delle condizioni di attivazione per questo attivatore, ad esempio per attivarlo solo sui dati degli eventi web o mobile, seleziona Alcuni eventi.

   1. Vedrai Nome evento preselezionato. Fai clic sul selettore e seleziona Scegli variabile integrata dall'elenco.
   2. Per restituire automaticamente il nome del client che ha generato l'evento, seleziona Nome client.

   3. Utilizza il nome del client configurato in precedenza per impostare la condizione di conseguenza. L'attivatore dovrebbe avere il seguente aspetto:

      

      Nota: il nome del client è quello specificato nel passaggio precedente. Il tipo di client è Google Analytics: GA4 (app). La variabile Nome cliente restituisce il nome e non il tipo di cliente.

6. Salva l'attivatore e inserisci un nome descrittivo. Ad esempio, puoi utilizzare "Tutti gli eventi app GA4".

7. Ora dovresti tornare alle impostazioni del tag con il nuovo attivatore al suo posto. Salva il tag e inserisci un nome descrittivo, ad esempio "GA4". Il tag dovrebbe avere il seguente aspetto:

   

Suggerimento: per omettere l'invio di determinati eventi, puoi scegliere di utilizzare attivatori personalizzati con logica condizionale in base al nome dell'evento (o a un'altra variabile) o di aggiungere eccezioni agli attivatori. Scopri di più sull'attivazione degli attivatori e delle eccezioni agli attivatori.

Visualizza l'anteprima del contenitore

Puoi utilizzare Google Tag Manager per eseguire l'anteprima e il debug del contenitore del server prima di pubblicare le modifiche. Tieni presente che l'anteprima non funzionerà finché non hai attivato il tagging lato server nella tua proprietà GA4.

Per fare in modo che le richieste dell'app attivino la configurazione di anteprima, devi:

1. Seleziona Anteprima nel contenitore del server di Google Tag Manager.
2. Fai clic sull'icona Altre azioni ⋮ in alto a destra e seleziona Invia richieste da un'app.

3. Inserisci l'ID app e fai clic su Genera codice QR.

   

4. Scansiona il codice QR con l'app della fotocamera dello smartphone. Procedi interagendo con l'app come faresti normalmente per generare eventi di anteprima.

5. Fai clic su OK per chiudere la finestra di dialogo.

Pubblica il contenitore

Dopo aver verificato le modifiche, pubblica il contenitore per renderle effettive per tutto il traffico. Scopri di più su pubblicazione, versioni e approvazioni.

Passaggio 3: attiva il tagging lato server nella proprietà GA4

1. Nella proprietà Google Analytics 4, vai ad Amministrazione.
2. Apri Stream di dati.

3. Seleziona la configurazione dello stream dell'applicazione dalla scheda iOS o Android.

   

4. Fai clic su Configura le impostazioni dell'SDK e poi su Configura Tag Manager lato server.

   

5. Per consentire all'SDK di inviare i dati di misurazione all'URL del contenitore del server:

   1. Attiva/disattiva l'opzione Invia dati a un contenitore di Tag Manager lato server.
   2. Copia l'URL del contenitore del server. Puoi trovarlo in Google Tag Manager andando a Amministrazione > Impostazioni contenitore > URL contenitore del server.

   3. Seleziona la percentuale di traffico da instradare al contenitore del server. Puoi scegliere un'opzione inferiore al 100% per convalidare la configurazione e la configurazione del server prima di utilizzare il tagging lato server per tutto il traffico.

      Nota: utilizza l'opzione Solo dispositivi di debug per consentire solo alle app aperte utilizzando la modalità di anteprima di inviare dati al tuo server.

   

6. Fai clic su Salva. L'SDK recupererà l'URL del contenitore del server aggiornato e lo indirizzerà ai dati di misurazione.

Limitazioni note

• Per le app per Android:

  • Per evitare potenziali vulnerabilità di sicurezza che coinvolgono i contenitori dei server e Google Play Services, gli eventi passeranno attraverso un server proxy senza stato tra l'SDK e il contenitore del server. Questo proxy convaliderà la fonte e l'endpoint della richiesta, ma non controllerà né memorizzerà alcun dato sugli eventi. In linea con come GA4 raccoglie i dati dai dispositivi con sede nell'UE, il proxy si troverà nell'UE per il traffico nell'UE.
  • Gli acquisti in-app registrati automaticamente si basano sull'integrazione con il backend di Google Play e non verranno inviati al contenitore del server.
  • L'evento app_remove non verrà registrato su Android.

• È comunque necessario collegare gli stream di dati dell'app in Google Analytics al tuo account Google Ads per assicurarti che i dati e le conversioni dell'SDK vengano importati in Google Ads. Il tagging lato server non offre alcuna integrazione intrinseca tra l'SDK e Google Ads.

API

Puoi utilizzare l'API REST di Tag Manager per accedere ai dati di configurazione di Tag Manager. Per ulteriori informazioni sull'API:

• Consulta la Guida per gli sviluppatori per scoprire come utilizzare l'API.
• Consulta il riferimento all'API Tag Manager per familiarizzare con le risorse di Tag Manager e le operazioni disponibili.