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 pressione di pulsanti con il tag Google Gestore (GTM).

1. Crea un nuovo progetto

  1. Apri Xcode. crea un nuovo progetto
  2. Fai clic su Create a new Xcode project (Crea un nuovo progetto Xcode).
  3. Seleziona Single View Application. 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 sarà uguale al nome del prodotto.
    Inserisci il nome del prodotto e altre opzioni
  6. Fai clic su Avanti.
  7. Seleziona una località per il progetto (directory).
  8. Fai clic su Crea.

2. Installa le dipendenze di Google Tag Manager

  1. Esci da Xcode.
  2. In un terminale, esegui questo comando per installare Cocoapodi: 
    $ 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 questo comando per scaricare e installare Google Tag Manager (GTM) delle dipendenze al 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 collegamento per le librerie Objective-C

Per creare un file di intestazione di collegamento:

  1. Apri Xcode.
  2. Fai clic su File > Nuovo > .
  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 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 collegamento 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 Tutte e Combinata e cerca bridging.
    Collegamento per la rete di ricerca
  4. Nella colonna a destra della riga contenente Intestazione ponte Objective-C, inserisci BridgingHeader.h.
    Aggiungi BridgingHeader.h come intestazione Bridging Objective-C

4. Aggiungi un container predefinito al progetto

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

  1. Accedi al tuo 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 per il contenitore selezionato completamente gestita.
    5. Il nome del file scaricato è l'ID contenitore, ad esempio GTM-PT3L9Z.

Per aggiungere un programma binario del container predefinito al tuo progetto:

  1. Apri Xcode.
  2. Fai clic sull'icona del Finder sul 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 ampliare Corso TAGContainerOpenerNotifier: 
    import UIKit

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

    Dopo aver ampliato il corso, otterrai Type 'AppDelegate' does not conform to protocol 'TAGContainerOpenerNotifier' . Il passaggio successivo consente di correggere l'errore.

  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 della schermata

Per monitorare un evento di apertura dello schermo:

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

a. Crea una variabile per memorizzare l'ID monitoraggio

  1. Accedi a 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.
    Usa UA-47605289-5 (da eliminare).
  8. Fai clic su Crea variabile.

b. Crea una variabile di livello dati denominata screenName

  1. Accedi a 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 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 di schermata

  1. Accedi a 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 Nuovo.
  5. Fai clic su Tag senza titolo per inserire il nome del tag Visualizzazione di schermo.
  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 suo valore 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 dello schermo

  1. Apri il file ViewController.swift in Xcode.
  2. Definisci una variabile denominata dataLayer all'interno della sezione Corso ViewController: 
    var dataLayer: TAGDataLayer = TAGManager.instance().dataLayer
  3. Nella funzione viewDidLoad(), esegui il push del 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 l'evento quando viene premuto il pulsante

Per monitorare un evento relativo alla pressione di un 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 a 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 dell'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 a 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. Crea un tag GTM denominato Pulsante premuto

  1. Accedi a 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 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 dell'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 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 nell'area di servizio (barra laterale destra). Storyboard e area di pubblica 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 libreria di oggetti
  5. Inserisci button nella casella di ricerca.
    pulsante nella raccolta di oggetti
  6. Trascina Pulsante sullo storyboard e rilascialo nella parte superiore nell'angolo in alto a sinistra.
    Trascina il pulsante nello storyboard
  7. Fai clic sul pulsante Editor dell'assistente Pulsante Editor dell&#39;assistente nella barra degli strumenti di Xcode.
  8. Trascina il pulsante e rilascialo tenendo premuto il tasto Ctrl in fondo alla definizione della classe ViewController.
    Trascina il pulsante nella definizione della classe ViewController
  9. Nella finestra di dialogo, seleziona la connessione Azione e inserisci il nome della funzione buttonPressed e fai clic su buttonPressed.
    Crea il codice per gestire l&#39;evento della pressione del pulsante

    In questo modo viene aggiunta la funzione seguente alla fine 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 a Esegui il push dell'evento ButtonPressed al livello del 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 Product > (Prodotto > esegui. Xcode creerà ed eseguirà l'app:

Screenshot dell&#39;app avviata