Crea variabili personalizzate per dispositivi mobili definite dall'utente in Google Tag Manager in base a requisiti specifici che potrebbero non essere soddisfatti dalle variabili integrate.
Per creare una nuova variabile definita dall'utente:
- Apri il contenitore di Tag Manager che vuoi modificare.
- Nella scheda Area di lavoro del riquadro di navigazione a sinistra, fai clic su Variabili.
- Nella sezione Variabili definite dall'utente, fare clic su Nuova.
- Fai clic su Configurazione variabile e seleziona il tipo di variabile da applicare.
- Completa le opzioni per il tipo di variabile selezionato.
- Assegna un nome alla variabile. Per la funzione della variabile, utilizza uno schema di denominazione descrittivo, ad esempio "Variabile livello dati - Nome prodotto".
- Fai clic su Salva.
Tag Manager supporta i seguenti tipi di variabili definite dall'utente per dispositivi mobili:
Firebase
Nome evento
Il valore viene impostato su "eventNameXYZ" quando il seguente codice viene eseguito nella tua app:
Android:
FirebaseAnalytics.getInstance(mContext).logEvent("eventNameXYZ", null);
iOS:
[FIRAnalytics logEventWithName:@"eventNameXYZ" parameters:parameters];
Nella maggior parte dei casi, devi utilizzare la variabile integrata equivalente.
Parametro evento
Il valore è impostato sul valore di un parametro dell'evento Google Analytics (Firebase) registrato per la chiave specificata.
Proprietà utente di Firebase
Il valore è impostato sul valore della proprietà utente di Google Analytics (Firebase) registrato per la chiave specificata.
Utilità
Monitoraggio inserzionista attivato
Per Android, la variabile restituisce vero se il monitoraggio degli annunci è attivato o falso se l'utente ha disattivato gli annunci basati sugli interessi. Per ulteriori informazioni, consulta il Centro per sviluppatori Android. Le versioni SDK precedenti alla v4 restituiranno sempre falso. Per iOS 6 e versioni successive, il valore viene impostato sulla proprietà advertisingTrackingEnabled. In caso contrario, il valore viene impostato su true. Nella maggior parte dei casi, devi utilizzare la variabile integrata equivalente.
Costante
Il valore viene impostato sulla stringa specificata.
Tabella di ricerca
Il valore viene impostato in base alle istruzioni presenti nella tabella di ricerca, La tabella di ricerca contiene due colonne (tabella vuota per illustrare come vengono utilizzati i dati in seguito):
| Quando [seleziona variabile] è uguale a | Imposta [questa variabile] su |
|---|
Il tipo Tabella di ricerca consente di creare una variabile il cui valore varia in base al valore di un'altra variabile. Questo è utile se la tua app è impostata in modo che il valore appropriato (ad esempio un ID monitoraggio delle conversioni) possa essere mappato al Codice versione app o a un altro aspetto dell'app. In questo esempio, viene creata una variabile denominata Conversion ID. Se il Codice versione app è 1.0, il valore viene impostato su "12345"; se il Codice versione app è 1.1, il valore restituito è "34567". Non vi è alcun limite al numero di righe della tabella di ricerca. I campi fanno distinzione tra maiuscole e minuscole.
| Quando {{App Version Code}} è uguale a | Imposta {{Conversion ID}} su |
|---|---|
| 1.0 | 12345 |
| 1.1 | 34567 |
| 1.2 | 56789 |
Numero casuale
Il valore è impostato su un numero casuale compreso tra 0 e 2147483647. Nella maggior parte dei casi, devi utilizzare la variabile integrata equivalente.
Dati del contenitore
ID contenitore
Il valore è l'ID pubblico del contenitore (ad esempio GTM-ABC42). Nella maggior parte dei casi, devi utilizzare la variabile integrata equivalente.
Numero versione contenitore
Quando il contenitore è in modalità di anteprima, il valore di questa variabile corrisponde al numero di versione di anteprima del contenitore. In caso contrario, la variabile restituisce il numero della versione pubblicata del contenitore. Nella maggior parte dei casi, devi utilizzare la variabile integrata equivalente.
Applicazione
ID app
Il valore viene impostato sul nome del pacchetto (Android) o sull'ID app (iOS). Nella maggior parte dei casi, devi utilizzare la variabile integrata equivalente.
Nome applicazione
Il valore è impostato sul nome dell'app. Nella maggior parte dei casi, devi utilizzare la variabile integrata equivalente.
Codice versione app
Il valore è impostato sulla versione dell'applicazione attualmente in esecuzione. Nella maggior parte dei casi, devi utilizzare la variabile integrata equivalente.
ID per la pubblicità
Per Android, il valore viene impostato su Advertising ID. Le versioni dell'SDK precedenti alla 4 restituiscono sempre una stringa vuota. Per la versione iOS 6 e successive, il valore viene impostato sull'identificatore della pubblicità (IDFA). altrimenti, il valore è impostato su una stringa vuota.
Versione SDK
Il valore è impostato sulla versione SDK del sistema operativo in cui è installata l'applicazione. Nella maggior parte dei casi, devi utilizzare la variabile integrata equivalente.
Dispositivo
Nome dispositivo
Il valore è impostato sul nome dispositivo dell'applicazione attualmente in esecuzione (ad esempio "Samsung Android", "Pixel 2"). Nella maggior parte dei casi, devi utilizzare la variabile integrata equivalente.
Lingua
Il valore viene impostato sul codice lingua di due lettere corrispondente alla lingua del dispositivo impostata dall'utente. Nella maggior parte dei casi, devi utilizzare la variabile integrata equivalente.
Versione sistema operativo
Il valore è impostato sulla versione del sistema operativo in cui è installata l'applicazione. Nella maggior parte dei casi, devi utilizzare la variabile integrata equivalente.
Piattaforma
Il valore è impostato sulla piattaforma dell'applicazione attualmente in esecuzione (ad esempio "Android", "iOS"). Nella maggior parte dei casi, devi utilizzare la variabile integrata equivalente.
Risoluzione dello schermo
Il valore viene impostato sulla risoluzione dello schermo del dispositivo dell'applicazione al momento in esecuzione. Il formato è "larghezza x altezza", ad esempio "1920 x 1080". Nella maggior parte dei casi, devi utilizzare la variabile integrata equivalente.
Altro
Chiamata funzione
Il valore è impostato sul valore restituito di una chiamata a una funzione preregistrata. Per saperne di più, consulta la documentazione dell'SDK Android o iOS.
Raccolta valori (solo contenitori precedenti)
Questa variabile contiene un insieme di coppie chiave-valore espresse nel formato JSON. La Raccolta valori va utilizzata per impostare i valori della configurazione della tua app. Ad esempio, per un'app di gioco di corse automobilistiche, puoi definire una variabile "Impostazioni app" di tipo Raccolta valori come segue:
{
"fuel-burn-rate": 20
}
La tua app mobile può restituire un valore nella variabile fornendo una chiave. Ad esempio:
public class MainActivity {
// Aggiungi il tuo ID contenitore pubblico.
private static final String CONTAINER_ID = "XXX-YYY";
// Chiavi di valore di configurazione del contenitore, usate in un secondo momento
// per recuperare i valori.
private static final String MAX_FUEL_KEY = "max-fuel";
private static final String INIT_FUEL_KEY = "init-fuel";
private static final String FUEL_BURN_KEY = "fuel-burn-rate";
// Resto del codice onCreate.
}
}
/*
* Metodo per aggiornare i valori di configurazione del gioco usando un
* contenitore Google Tag Manager.
*/
public void updateConfigurationFromContainer(Container container) {
// Ottieni riferimento al contenitore.
Container container = mFutureContainer.get();
// Aggiorna le impostazioni di gioco usando le
// chiavi di valore di configurazione di Container.
maxFuel = mContainer.getDoubleValue(MAX_FUEL_KEY);
startingFuel = mContainer.getDoubleValue(INIT_FUEL_KEY);
burnRate = mContainer.getDoubleValue(FUEL_BURN_KEY);
}
A una variabile Raccolta valori sono associati attivatori. Per i valori di configurazione che si applicano a tutte le istanze e versioni della tua app, imposta l'attivatore di abilitazione sul valore predefinito Sempre. Per informazioni dettagliate su come utilizzare la variabile Raccolta valori, consulta la documentazione per lo sviluppo (Android o iOS).