Google Tag Manager per iOS

In qualità di sviluppatore, puoi utilizzare Google Tag Manager per implementare e gestire tag e pixel di misurazione nelle tue applicazioni mobile, senza dover ricompilare e inviare di nuovo i file binari dell'applicazione ai marketplace di app. Gli sviluppatori che lavorano con l'SDK Google Analytics for Firebase possono aggiungere facilmente Tag Manager per gestire e apportare modifiche all'implementazione, anche dopo il rilascio dell'app.

Gli sviluppatori possono registrare eventi importanti e decidere in un secondo momento quali tag o pixel devono essere attivati.

Prerequisiti

Le sezioni seguenti ti illustrano i passaggi per configurare e utilizzare Google Tag Manager nella tua applicazione iOS.

1. Aggiungere Tag Manager al progetto

  1. Aggiungi il pacchetto Tag Manager:

    CocoaPods

    Per aggiungere Tag Manager tramite CocoaPods:

    1. In un terminale, esegui il seguente comando:

      $ sudo gem install cocoapods

    2. Passa alla directory del progetto.

    3. Esegui il seguente comando per creare un file denominato Podfile:

      $ pod init

    4. In Podfile, aggiungi quanto segue:

      pod 'GoogleTagManager', '~> 6.0'

    5. Esegui il seguente comando per scaricare e installare le dipendenze di Tag Manager nel progetto:

      $ pod install

    Swift Package Manager

    Per aggiungere Tag Manager tramite Swift Package Manager:

    1. Se esegui la migrazione da un progetto basato su CocoaPods, esegui pod deintegrate per rimuovere CocoaPods dal progetto Xcode. Il file .xcworkspace generato da CocoaPods può essere eliminato in sicurezza in un secondo momento. Se aggiungi Firebase a un progetto per la prima volta, puoi ignorare questo passaggio.
    2. In Xcode 12, installa la libreria Tag Manager andando a File > Tag Manager Packages > Add Package Dependency… (File > Pacchetti Tag Manager > Aggiungi dipendenza pacchetto…)

    3. Nel prompt visualizzato, inserisci il repository GitHub di Tag Manager:

      https://github.com/googleanalytics/google-tag-manager-ios-sdk.git

    4. Seleziona la versione di Tag Manager che vuoi utilizzare. Per i nuovi progetti, ti consigliamo di utilizzare la versione più recente di Tag Manager.

    5. Aggiungi -ObjC a Other Linker Flags (Altri flag del linker) in Build Settings (Impostazioni di build) del progetto.

  2. Crea un contenitore iOS se il tuo account Tag Manager non ne ha uno:

    1. Accedi al tuo account Tag Manager.
    2. Nella scheda Account, seleziona il contenitore iOS.
    3. Fai clic su Amministrazione nella barra di navigazione in alto.
    4. Nella colonna CONTENITORE, fai clic sull'icona "+" per creare un contenitore.
    5. Inserisci un nome del contenitore.
    6. Seleziona il contenitore iOS.
    7. Fai clic su Crea.

  3. Scarica il contenitore:

    1. Accedi al tuo account Tag Manager.
    2. Nella scheda Account, seleziona il contenitore iOS.
    3. Fai clic su Versioni nella barra di navigazione in alto.
    4. Seleziona la versione del contenitore che vuoi scaricare.

    5. Fai clic su Scarica.

  4. Aggiungi il contenitore scaricato al progetto:

    1. Copia il file scaricato in una cartella denominata container nella radice del progetto Xcode (in genere PROJECT_ROOT/container/GTM-XXXXXX.json).
    2. Apri Xcode.
    3. Dal menu File, scegli Add files to… (Aggiungi file a…)
    4. Seleziona la cartella container.
    5. Fai clic su Opzioni e assicurati che l'opzione Create folder references (Crea riferimenti alle cartelle) sia selezionata.
    6. Fai clic su Fine.

2. Registrare eventi e variabili

Tag Manager utilizza gli eventi, i parametri e le proprietà utente registrati dall'SDK Google Analytics for Firebase per attivare e creare i tag configurati in Google Tag Manager.

Per istruzioni su come registrare gli eventi e impostare le proprietà utente, consulta la documentazione per gli sviluppatori di Firebase.

Configurare le variabili in Tag Manager

Per acquisire il valore dei parametri evento e delle proprietà utente da utilizzare in Google Tag Manager, puoi configurare le variabili nell'interfaccia di Tag Manager.

Ad esempio, potresti registrare il seguente evento personalizzato nella tua app:

Analytics.logEvent("share_image", parameters: [
  "image_name": name,
  "full_text": text
])

Poi, potresti configurare le nuove variabili Parametro evento in Tag Manager come segue per acquisire i valori image_name e full_text parameter:

  • Nome variabile: Image Name (Nome immagine)
  • Tipo di variabile: Parametro evento
  • Nome chiave parametro evento: image_name

e:

  • Nome variabile: Full Text (Testo completo)
  • Tipo di variabile: Parametro evento
  • Nome chiave parametro evento: full_text

Allo stesso modo, potresti impostare la seguente proprietà utente nella tua app:

Analytics.setUserProperty(food, forName: "favorite_food")

Poi, potresti configurare una nuova variabile Proprietà utente Firebase in Google Tag Manager per acquisire il valore favorite_food:

  • Nome variabile: Favorite Food (Cibo preferito)
  • Tipo di variabile: Proprietà utente Firebase
  • Nome chiave parametro evento: favorite_food

Modificare e bloccare gli eventi

Tag Manager ti consente di modificare e bloccare gli eventi prima che vengano registrati dall'SDK Google Analytics for Firebase. La modifica degli eventi può aiutarti ad aggiungere, rimuovere o modificare i valori dei parametri evento o a modificare i nomi degli eventi senza aggiornamenti dell'app. Gli eventi non bloccati verranno registrati dall'SDK Google Analytics for Firebase.

L'SDK Google Analytics for Firebase registra automaticamente anche alcuni eventi e proprietà utente. Puoi utilizzare gli eventi e le proprietà raccolti automaticamente in Tag Manager senza dover aggiungere codice. Tuttavia, non puoi bloccarli.

3. Inviare eventi

Le variabili del nome evento Firebase, le variabili del parametro evento Firebase e altre variabili vengono utilizzate per configurare gli attivatori. Le condizioni di attivazione vengono valutate ogni volta che registri un evento Firebase. Per impostazione predefinita, gli eventi Google Analytics for Firebase vengono attivati automaticamente. È possibile aggiungere un tag Google Analytics for Firebase in Tag Manager per impedire l'invio di eventi a Google Analytics.

4. Visualizzare l'anteprima, eseguire il debug e pubblicare il contenitore

Prima di pubblicare una versione del contenitore, ti consigliamo di visualizzarne l'anteprima per assicurarti che funzioni come previsto. Tag Manager ti consente di visualizzare l'anteprima delle versioni del contenitore generando link e codici QR nell'interfaccia web di Tag Manager e utilizzandoli per aprire l'applicazione.

Visualizzare l'anteprima del contenitore

Per visualizzare l'anteprima di un contenitore, genera un URL di anteprima nell'interfaccia web di Tag Manager:

  1. Accedi al tuo account Tag Manager.
  2. Seleziona un contenitore mobile.
  3. Fai clic su Versioni nella barra di navigazione in alto.
  4. Fai clic su Azioni > Anteprima nella versione del contenitore di cui vuoi visualizzare l'anteprima.
  5. Inserisci il nome del pacchetto dell'applicazione.

  6. Fai clic su Genera link di inizio anteprima.

    Gli URL di anteprima sono disponibili nella finestra di anteprima dell'interfaccia web di Tag Manager

    Figura 1: ottenere un URL di anteprima dall' interfaccia web di Tag Manager.

    Salva questo URL di anteprima per i passaggi successivi.

Per attivare le anteprime dei contenitori, devi definire lo schema dell'URL di anteprima di Tag Manager nell'elenco delle proprietà del progetto. In Tipi di URL del file dell'elenco delle proprietà dell'applicazione, registra il seguente identificatore URL e schema URL:

URL identifier: _your.package.name_
URL scheme: tagmanager.c._your.package.name_
Registra lo schema dell'URL di anteprima di Tag Manager nel file di elenco delle proprietà della tua applicazione.
Figura 2: aggiungi lo schema dell'URL di anteprima di Tag Manager al file dell'elenco delle proprietà dell'applicazione.

Arresta l'applicazione e apri l'URL di anteprima su un emulatore o un dispositivo fisico per visualizzare l'anteprima del contenitore bozza nell'applicazione.

Eseguire il debug del contenitore

Quando esegui l'app in un simulatore o in modalità di anteprima, Tag Manager attiva automaticamente la registrazione in modalità dettagliata.

Pubblicare il contenitore

Dopo aver visualizzato l'anteprima del contenitore e verificato che funzioni, puoi pubblicarlo. Dopo aver pubblicato il contenitore, le configurazioni dei tag saranno disponibili per gli utenti delle app mobile.

Leggi Configurazione avanzata.