Guida introduttiva di Swift

Questa guida descrive come creare e implementare un'app per iOS in Swift per monitorare gli eventi di apertura schermo e pressione dei pulsanti con Google Tag Manager (GTM).

1. Creare un nuovo progetto

  1. Apri Xcode. crea un nuovo progetto
  2. Fai clic su Crea un nuovo progetto Xcode.
  3. Seleziona Applicazione per visualizzazione singola. seleziona applicazione visualizzazione singola
  4. Fai clic su Avanti.
  5. Assegna un nome al progetto e scegli opzioni aggiuntive. Il nome del progetto e dell'app coincideranno con il nome del prodotto.
    Inserisci il nome del prodotto e altre opzioni
  6. Fai clic su Avanti.
  7. Seleziona una posizione (directory) per il progetto.
  8. Fai clic su Crea.

2. Installare le dipendenze di Google Tag Manager

  1. Esci da Xcode.
  2. In un terminale, esegui questo comando per installare Cocoapods: 
    $ sudo gem install cocoapods
  3. Passa alla directory del progetto.
  4. Esegui questo comando per creare un file denominato Podfile: 
    $ pod init
  5. In Podfile, rimuovi il commento use_frameworks! e aggiungi pod 'GoogleTagManager' al target:
    6. # Uncomment this line if you're using Swift
use_frameworks!

target 'GtmSwiftTutorial' do
  pod 'GoogleTagManager'
end
  6. Esegui questo comando per scaricare e installare le dipendenze di Google Tag Manager (GTM) nel tuo progetto: 
    $ pod install

    Questo comando crea anche lo spazio di lavoro GtmSwiftTutorial.xcworkspace. D'ora in poi, utilizza questo spazio di lavoro per sviluppare l'app GtmSwiftTutorial.

3. Aggiungi un'intestazione di bridging per le librerie Objective-C

Per creare un file di intestazione di bridging:

  1. Apri Xcode.
  2. Fai clic su File > Nuovo > File.
  3. In iOS > Origine, seleziona File di intestazione.
  4. Fai clic su Avanti.
  5. Inserisci il nome del file di intestazione BridgingHeader.h.
    Crea file di intestazione di bridging
  6. Fai clic su Crea.
  7. Aggiungi queste istruzioni import al file di intestazione: 
    #ifndef BridgingHeader_h
#define BridgingHeader_h

#import <GoogleTagManager/TAGManager.h>
#import <GoogleTagManager/TAGContainer.h>
#import <GoogleTagManager/TAGContainerOpener.h>
#import <GoogleTagManager/TAGDataLayer.h>
#import <GoogleTagManager/TAGLogger.h>

#endif /* BridgingHeader_h */

Per aggiungere l'intestazione di bridging Objective-C nelle impostazioni della build:

  1. In Xcode, fai clic sul tuo progetto.
  2. Fai clic su Impostazioni build nell'area dell'editor.
    Fai clic su Impostazioni build.
  3. Seleziona Tutti e Combinati e cerca bridging.
    Creazione di bridging delle ricerche
  4. Nella colonna a destra della riga contenente Intestazione Bridging Objective-C, inserisci BridgingHeader.h.
    Aggiungi BridgingHeader.h come intestazione della collaborazione Objective-C

4. Aggiungi un container predefinito al progetto

Prima di aggiungere un container predefinito al progetto, scarica il programma binario di un container mobile:

  1. Accedi all'account Google Tag Manager.
  2. Seleziona un contenitore per dispositivi mobili.
  3. Fai clic su Versioni nella barra dei menu.
  4. Fai clic su Azioni > Scarica nella versione del contenitore selezionata.
    5. Il nome del file scaricato è l'ID contenitore, ad esempio GTM-PT3L9Z.

Per aggiungere il programma binario di un container predefinito al tuo progetto:

  1. Apri Xcode.
  2. Fai clic sull'icona del Finder nel dock.
  3. Fai clic sulla cartella Downoloads.
  4. Trascina il file binario del container nella cartella Downloads e rilascialo nella cartella principale del progetto Xcode.
  1. Apri il file AppDelegate.swift in Xcode.
  2. Chiedi alla classe AppDelegate di estendere la classe TAGContainerOpenerNotifier: 
    import UIKit

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate, TAGContainerOpenerNotifier {
  // ...
}

    Dopo aver esteso il corso, visualizzerai l'errore Type 'AppDelegate' does not conform to protocol 'TAGContainerOpenerNotifier'. Per correggere l'errore, procedi nel seguente modo.

  3. Aggiungi la seguente funzione in fondo alla definizione della classe AppDelegate: 
    func containerAvailable(container: TAGContainer!) {
  container.refresh()
}
  4. Nella funzione application, aggiungi il seguente codice prima dell'istruzione return true: 
    let GTM = TAGManager.instance()
GTM.logger.setLogLevel(kTAGLoggerLogLevelVerbose)

TAGContainerOpener.openContainerWithId("GTM-PT3L9Z",  // change the container ID "GTM-PT3L9Z" to yours
    tagManager: GTM, openType: kTAGOpenTypePreferFresh,
    timeout: nil,
    notifier: self)

6. Monitora l'evento di apertura dello schermo

Per monitorare un evento di apertura schermata:

  1. Crea una variabile per archiviare l'ID monitoraggio.
  2. Crea una variabile del livello dati denominata screenName.
  3. Crea un tag GTM denominato Visualizzazione schermata.
  4. Aggiungi codice di monitoraggio delle schermate.

a. Crea una variabile per archiviare l'ID monitoraggio

  1. Accedi all'account Google Tag Manager.
  2. Seleziona un contenitore per dispositivi mobili.
  3. Nella barra di navigazione a sinistra, fai clic su Variabili.
  4. In Variabili definite dall'utente, fai clic su Nuova.
  5. Fai clic su Variabile senza titolo per inserire il nome della variabile ID monitoraggio.
  6. Scegli Costante come tipo di variabile.
  7. Inserisci l'ID monitoraggio (nel formato UA-XXXXXXXX-X, dove X è una cifra) come valore della variabile.
    Utilizza UA-47605289-5 (da eliminare).
  8. Fai clic su Crea variabile.

b. Crea una variabile del livello dati denominata screenName

  1. Accedi all'account Google Tag Manager.
  2. Seleziona un contenitore per dispositivi mobili.
  3. Nella barra di navigazione a sinistra, fai clic su Variabili.
  4. In Variabili definite dall'utente, fai clic su Nuova.
  5. Fai clic su Variabile senza titolo per inserire il titolo Nome schermata.
  6. Scegli Variabile di livello dati come tipo di variabile.
  7. Inserisci screenName come Nome variabile del livello dati.
  8. Fai clic su Imposta valore predefinito.
  9. Inserisci il valore predefinito schermata sconosciuta.
  10. Fai clic su Crea variabile.

c. Creare un tag GTM denominato Visualizzazione schermata

  1. Accedi all'account Google Tag Manager.
  2. Seleziona un contenitore per dispositivi mobili.
  3. Nella barra di navigazione a sinistra, fai clic su Tag.
  4. Fai clic su Nuova.
  5. Fai clic su Tag senza titolo per inserire il nome del tag Visualizzazione di schermata.
  6. Scegli il prodotto Google Analytics.
  7. Seleziona ID monitoraggio dall'elenco.
  8. Seleziona Vista app come Tipo di monitoraggio.
  9. Fai clic su Altre impostazioni.
  10. Fai clic su Campi da impostare.
  11. Fai clic su + Aggiungi campo.
  12. Seleziona il nome del campo screenName e il relativo valore Screen Name (Nome schermata).
  13. Fai clic su Continua.
  14. In Attiva su, seleziona Qualsiasi evento.
  15. Fai clic su Crea tag.

d. Aggiungi codice di monitoraggio delle schermate

  1. Apri il file ViewController.swift in Xcode.
  2. Definisci una variabile denominata dataLayer all'interno della classe ViewController: 
    var dataLayer: TAGDataLayer = TAGManager.instance().dataLayer
  3. Nella funzione viewDidLoad(), esegui il push dell'evento OpenScreen al livello dati:
    dataLayer.push(["event": "OpenScreen", "screenName": "Home Screen"])

La definizione della classe ViewController ha il seguente aspetto:

import UIKit

class ViewController: UIViewController {
  var dataLayer: TAGDataLayer = TAGManager.instance().dataLayer

  override func viewDidLoad() {
    super.viewDidLoad()
    dataLayer.push(["event": "OpenScreen", "screenName": "Home Screen"])
  }

  override func didReceiveMemoryWarning() {
    super.didReceiveMemoryWarning()
    // Dispose of any resources that cant be recreated
  }
}

7. Monitora evento di pressione del pulsante

Per monitorare un evento di pressione di un pulsante:

  1. Crea una variabile del livello dati denominata eventAction.
  2. Crea una variabile evento personalizzata denominata Event.
  3. Crea un tag GTM denominato Button Pressed.
  4. Crea un pulsante e aggiungi il codice per rilevare la pressione del pulsante.

a. Crea una variabile del livello dati denominata eventAction

  1. Accedi all'account Google Tag Manager.
  2. Seleziona un contenitore per dispositivi mobili.
  3. Nella barra di navigazione a sinistra, fai clic su Variabili.
  4. In Variabili definite dall'utente, fai clic su Nuova.
  5. Fai clic su Variabile senza titolo per inserire il titolo Azione evento.
  6. Scegli Variabile di livello dati come tipo di variabile.
  7. Inserisci eventAction come Nome variabile livello dati.
  8. Fai clic su Imposta valore predefinito.
  9. Inserisci il valore predefinito evento sconosciuto.
  10. Fai clic su Crea variabile.

b. Crea una variabile evento personalizzata denominata Event

  1. Accedi all'account Google Tag Manager.
  2. Seleziona un contenitore per dispositivi mobili.
  3. Nella barra di navigazione a sinistra, fai clic su Variabili.
  4. In Variabili definite dall'utente, fai clic su Nuova.
  5. Fai clic su Variabile senza titolo per inserire il nome della variabile Evento.
  6. Scegli Evento personalizzato come tipo di variabile.
  7. Fai clic su Crea variabile.

c. Creare un tag GTM denominato Pulsante premuto

  1. Accedi all'account Google Tag Manager.
  2. Seleziona un contenitore per dispositivi mobili.
  3. Nella barra di navigazione a sinistra, fai clic su Tag.
  4. Fai clic su Nuova.
  5. Fai clic su Tag senza titolo per inserire il nome del tag Pulsante premuto.
  6. Scegli il prodotto Google Analytics.
  7. Seleziona ID monitoraggio dall'elenco.
  8. Seleziona Evento come Tipo di monitoraggio.
  9. Seleziona la categoria Evento.
  10. Seleziona Azione evento.
  11. Fai clic su Continua.
  12. In Attiva su, seleziona Qualsiasi evento.
  13. Fai clic su Crea tag.

d. Crea un pulsante e aggiungi il codice per monitorare la pressione del pulsante

  1. Apri il progetto Xcode.
  2. Apri Main.storyboard.
  3. Fai clic sul pulsante in alto a destra nella barra degli strumenti di Xcode per aprire l'area dell'utilità (barra laterale a destra). Storyboard e area di servizio
  4. Nella parte inferiore dell'area dei servizi pubblici,
    pulsante blu per aprire la raccolta degli oggetti

    Fai clic sul pulsante Mostra libreria di oggetti (il pulsante blu):

    Finestra popup della libreria di oggetti
  5. Inserisci button nella casella di ricerca.
    pulsante nella libreria di oggetti
  6. Trascina Pulsante nello storyboard e rilasciarlo nell'angolo in alto a sinistra.
    Trascina il pulsante nello storyboard
  7. Fai clic sul pulsante dell'editor dell'assistente Pulsante Editor dell&#39;assistente nella barra degli strumenti di Xcode.
  8. Tenendo premuto il tasto Ctrl, trascina il pulsante fino in fondo alla definizione della classe ViewController.
    Trascina il pulsante nella definizione della classe ViewController
  9. Nella finestra di dialogo, seleziona la connessione Action (Azione), inserisci il nome della funzione buttonPressed e fai clic su Connetti.
    Crea il codice per gestire l&#39;evento di pressione del pulsante

    Questa operazione aggiunge la seguente funzione alla fine della definizione della classe ViewController:

    @IBAction func buttonPressed(sender: AnyObject) {
}

    La funzione viene eseguita ogni volta che viene premuto il pulsante.

  10. Nella funzione buttonPressed, aggiungi il seguente codice per eseguire il push dell'evento ButtonPressed al livello giornaliero: 
    @IBAction func buttonPressed(sender: AnyObject) {
  dataLayer.push(["event": "ButtonPressed", "eventAction": "Test Event"])
}

8. Crea ed esegui la tua app

In Xcode, fai clic su Prodotto > Esegui. Xcode creerà ed eseguirà l'app:

Screenshot dell&#39;app lanciata