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 preparare, oscurare e arricchire 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 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 collegarla 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 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 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 anteprima, aggiungi una chiamata a Analytics.handleOpen(_:) in un metodo del ciclo di vita per passare l'URL di avvio.

   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 avvio da ApplicationDidFinishLaunchingNotification.

Android

1. Installa l'ultima release 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" />
   

   Nota: <APP_PACKAGE_ID> deve essere composto da lettere minuscole. La corrispondenza dello schema nel framework Android è sensibile alle maiuscole e minuscole, a differenza dell'RFC.

Passaggio 2: configura il contenitore del server in modo che supporti il traffico mobile

La seguente sezione presuppone che tu disponga di un deployment di tagging lato server esistente e che 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 Tag Manager che intercetta determinati tipi di richieste in entrata e genera eventi che possono essere passati 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. Hai bisogno di un solo client GA4 per origine dati, ad esempio SDK GA e sito web. Scopri di più su come funzionano i clienti.

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

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

   

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

Configurare 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 entrata in un oggetto dati evento. Il tag prenderà questo oggetto di dati evento, lo mapperà nel 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, quindi scegli Google Analytics: GA4.

   

Per impostazione predefinita, il tag erediterà tutti i campi e i parametri pertinenti dall'oggetto dati evento creato dal client:

• Se la richiesta Google Analytics 4 in entrata passa attraverso il client Google Analytics: GA4 (app), il tag eredita l'ID app e i parametri evento.
• Se le richieste Google Analytics 4 in entrata passano attraverso 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 i trigger per il traffico mobile

Dopodiché, devi stabilire quando deve attivarsi il tag GA4. Il client Google Analytics: GA4 (app) analizza la richiesta in entrata in un oggetto dati evento e il tag ne eredita i valori. Pertanto, in genere vuoi che il tag venga attivato ogni volta che il client GA4 acquisisce la richiesta.

Per configurare i trigger:

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.

   • Il tipo Attivatore personalizzato, per impostazione predefinita, attiva il tag quando un 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 espressione regolare.

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

   1. Vedrai l'opzione Nome evento preselezionata. 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 che hai configurato in precedenza per impostare la condizione di conseguenza. Il trigger dovrebbe essere simile al seguente:

      

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

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

7. Ora dovresti essere tornato alle impostazioni del tag con il nuovo trigger al suo posto. Salva il tag e inserisci un nome descrittivo, ad esempio "GA4". Il tag dovrebbe essere simile a questo:

   

Suggerimento: per omettere l'invio di determinati eventi, puoi scegliere di utilizzare trigger personalizzati con logica condizionale basata sul nome dell'evento (o su un'altra variabile) o di aggiungere eccezioni ai trigger. Scopri di più su attivatori e relative eccezioni.

Visualizzare l'anteprima del contenitore

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

Per fare in modo che le richieste dell'app attivino la configurazione dell'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.

   Nota :l'ID app deve iniziare con una lettera. In alternativa, puoi utilizzare qualsiasi ID univoco che inizi con una lettera, purché corrisponda all'ID utilizzato nel file Info.plist o AndroidManifest.xml.

   

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.

Pubblicare 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 della tua 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 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 trovare questa impostazione in Google Tag Manager andando su Amministrazione > Impostazioni contenitore > URL contenitore server.

   3. Seleziona la percentuale di traffico che vuoi indirizzare al contenitore server. Puoi scegliere un'opzione inferiore al 100% per convalidare 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 container server aggiornato e indirizzerà i dati di misurazione diretta.

Limitazioni note

• Per le app per Android:

  • Gli acquisti in-app registrati automaticamente si basano sull'integrazione con il backend di Google Play e non vengono inviati al contenitore del server.
  • L'evento app_remove non verrà segnalato su Android.

• Il collegamento degli stream di dati dell'app in Google Analytics al tuo account Google Ads è ancora necessario per garantire 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.

Nota: l'SDK Google Analytics per Firebase è progettato e ottimizzato per inviare dati a Google Analytics 4. Google Analytics 4 può quindi essere collegato a Google Ads per i report sulle conversioni, la creazione di segmenti di pubblico, l'ottimizzazione delle campagne e la modellazione. Ciò include il tagging lato server per le app e invitiamo i clienti a sfruttare l'integrazione tra Google Analytics e il tagging lato server in Google Tag Manager.

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 API Tag Manager per acquisire familiarità con le risorse di Tag Manager e le operazioni disponibili.