Guida introduttiva di Swift

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

1. Crea un nuovo progetto

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

2. Installa le dipendenze di Google Tag Manager

  1. Esci da Xcode.
  2. In un terminale, esegui il seguente 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 da 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 il seguente comando per scaricare e installare le dipendenze di Google Tag Manager (GTM) nel tuo progetto: 
    $ pod install

    Questo comando crea anche l'area 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 intestazione.
  4. Fai clic su Avanti.
  5. Inserisci il nome del file dell'intestazione BridgingHeader.h.
    Crea file di intestazione per il ponte
  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 di compilazione:

  1. In Xcode, fai clic sul progetto.
  2. Fai clic su Impostazioni di compilazione nell'area di modifica.
    Fai clic su Impostazioni build
  3. Seleziona Tutte e Combinate e cerca bridge.
    Ricerca di ponti
  4. Nella colonna a destra della riga contenente Intestazione ponte Objective-C, inserisci BridgingHeader.h.
    Aggiungi BridgingHeader.h come intestazione di bridging Objective-C

4. Aggiungi un container predefinito al progetto

Prima di aggiungere un contenitore predefinito al progetto, scarica un file binario del contenitore mobile:

  1. Accedi all'account Google Tag Manager.
  2. Seleziona un contenitore mobile.
  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 un file binario del contenitore predefinito al 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 contenitore nella cartella Downloads e rilascialo nella cartella principale del progetto Xcode.
  1. In Xcode, apri il file AppDelegate.swift.
  2. Fai in modo che la classe AppDelegate estenda la classe TAGContainerOpenerNotifier: 
    import UIKit

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

    Dopo aver esteso il corso, riceverai l'errore Type 'AppDelegate' does not conform to protocol 'TAGContainerOpenerNotifier'. Il passaggio seguente correggerà l'errore.

  3. Aggiungi la seguente funzione alla fine della 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. Monitorare l'evento di apertura della schermata

Per monitorare un evento di apertura della schermata:

  1. Crea una variabile per memorizzare l'ID monitoraggio.
  2. Crea una variabile di livello dati denominata screenName.
  3. Crea un tag GTM denominato Visualizzazione schermo.
  4. Aggiungi il codice di monitoraggio dello schermo.

a. Crea una variabile per archiviare l'ID monitoraggio

  1. Accedi all'account Google Tag Manager.
  2. Seleziona un contenitore mobile.
  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 di livello dati denominata screenName

  1. Accedi all'account Google Tag Manager.
  2. Seleziona un contenitore mobile.
  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 visualizzato.
  6. Scegli Variabile di livello dati come tipo di variabile.
  7. Inserisci screenName come Nome variabile livello dati.
  8. Fai clic su Imposta valore predefinito.
  9. Inserisci il valore predefinito unknown screen (schermo sconosciuto).
  10. Fai clic su Crea variabile.

c. Crea un tag GTM denominato Visualizzazione schermo

  1. Accedi all'account Google Tag Manager.
  2. Seleziona un contenitore mobile.
  3. Nella barra di navigazione a sinistra, fai clic su Tag.
  4. Fai clic su Nuovo.
  5. Fai clic su Tag senza titolo per inserire il nome del tag Visualizzazione schermo.
  6. Scegli il prodotto Google Analytics.
  7. Seleziona ID monitoraggio dall'elenco.
  8. Seleziona Visualizzazione 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 valore Nome schermata.
  13. Fai clic su Continua.
  14. In Attivazione, seleziona Qualsiasi evento.
  15. Fai clic su Crea tag.

d. Aggiungi codice di monitoraggio dello schermo

  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 del pulsante:

  1. Crea una variabile di livello dati denominata eventAction.
  2. Crea una variabile evento personalizzata denominata Evento.
  3. Crea un tag GTM denominato Pulsante premuto.
  4. Crea un pulsante e aggiungi il codice per monitorare la pressione del pulsante.

a. Crea una variabile di livello dati denominata eventAction

  1. Accedi all'account Google Tag Manager.
  2. Seleziona un contenitore mobile.
  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 Evento

  1. Accedi all'account Google Tag Manager.
  2. Seleziona un contenitore mobile.
  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. Crea un tag GTM denominato Pulsante premuto

  1. Accedi all'account Google Tag Manager.
  2. Seleziona un contenitore mobile.
  3. Nella barra di navigazione a sinistra, fai clic su Tag.
  4. Fai clic su Nuovo.
  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 Attivazione, 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 di utilità (barra laterale destra). Storyboard e area di utilità
  4. In fondo all'area di servizio,
    pulsante blu per aprire la libreria di oggetti

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

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

    In questo modo, alla fine della definizione della classe ViewController viene aggiunta la seguente funzione:

    @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 spingere l'evento ButtonPressed nel livello giorno: 
    @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 avviata