Skapa egna användardefinierade mobilvariabler i Google Taggstyrning som uppfyller specifika krav som inte redan omfattas av inbyggda variabler.
Så här skapar du en användardefinierad variabel:
- Klicka på Variabler i navigeringsfältet till vänster.
- Klicka på Ny i avsnittet Användardefinierade variabler.
- Klicka på Variabelkonfiguration och välj en variabeltyp.
- Fyll i alternativen för den valda variabeltypen.
- Ge variabeln ett namn. Använd ett namnformat som beskriver variabelns funktion, t.ex:Datalagervariabel – produktnamn.
- Klicka på Spara.
Taggstyrning stöder dessa användardefinierade variabeltyper för mobila enheter:
Firebase
Händelsenamn
Värdet ställs in på händelseNamnXYZ när följande kod i appen körs:
Android:
FirebaseAnalytics.getInstance(mContext).logEvent("eventNameXYZ", null);
iOS:
[FIRAnalytics logEventWithName:@"eventNameXYZ" parameters:parameters];
I flesta fall kan du använda motsvarande inbyggda variabel.
Händelseparameter:
Värdet är inställt på värdet av en händelseparameter i Google Analytics (Firebase) för den angivna nyckeln.
Firebase-användaregendom
Värdet är inställt på värdet av en användaregendom i Google Analytics (Firebase) för den angivna nyckeln.
Verktyg
Annonsörsspårning har aktiverats
För Android returnerar variabeln ”true” om annonsspårning har aktiverats och ”false” om användaren har valt att inte använda intressestyrd annonsering. Läs mer i Android Developer Center. SDK-versioner tidigare än v4 returnerar alltid ”false”. För iOS-versionen 6 och senare sätts värdet till egenskapen advertisingTrackingEnabled. I annat fall sätts värdet till ”true”. I flesta fall kan du använda motsvarande inbyggda variabel.
Konstant
Värdet är den sträng du anger.
Inställningar i Google Analytics
Google Analytics inställningsvariabel används i Universal Analytics-taggar i behållare för webb och mobil (Firebase) för att kunna konfigurera och dela gemensamma Google Analytics-inställningar centralt som finns i flera taggar. När du skapar en Google Analytics-tagg med Universal Analytics får du en uppmaning i Taggstyrning om att välja eller skapa en inställningsvariabel för Google Analytics. Läs mer.
Uppslagstabell
Värdet ställs in enligt instruktionerna i uppslagstabellen. Uppslagstabellen innehåller två kolumner (Tabellen är tom för att illustrera hur data används senare):
| När [välj variabel] är lika med | Ange [denna variabel] till |
|---|---|
Med Uppslagstabell kan du skapa en variabel vars värde varierar beroende på värdet på en annan variabel. Det här är användbart om din app är konfigurerad så att det lämpliga värdet (till exempel ett konverteringsspårnings-id) kan mappas till appversionskoden eller en annan aspekt av appen. I det här exemplet skapas en variabel med namnet Conversion ID. Om appversionskoden är 1.0 sätts värdet till 12345. Om appversionskoden är 1.1 sätts värdet till 34567. Det finns ingen gräns för antal rader i uppslagstabellen. Fälten är skiftlägeskänsliga.
| När {{App Version Code}} är lika med | Ange {{Conversion ID}} till |
|---|---|
| 1.0 | 12345 |
| 1.1 | 34567 |
| 1.2 | 56789 |
Slumptal
Värdet sätts till ett slumptal mellan 0 och 2147483647. I flesta fall kan du använda motsvarande inbyggda variabel.
Data för behållare
Behållar-id
Värdet är behållarens offentliga id (t.ex. GTM-ABC42). I flesta fall kan du använda motsvarande inbyggda variabel.
Behållarens versionsnummer
När behållaren är i förhandsgranskningsläge får variabeln värdet som motsvarar numret på förhandsgranskningsversionen av behållaren. Annars blir värdet behållarens aktiva versionsnummer I flesta fall kan du använda motsvarande inbyggda variabel.
App
App-id
Värdet är inställt på paketnamnet (Android) eller app-id (iOS). I flesta fall kan du använda motsvarande inbyggda variabel.
Appnamn
Värdet är inställt på appens namn. I flesta fall kan du använda motsvarande inbyggda variabel.
Appversionskod
Värdet är appversionen som körs. I flesta fall kan du använda motsvarande inbyggda variabel.
Reklam-id
För Android ställs värdet in på reklam-id:t. Tidigare SDK-versioner än v4 returnerar alltid en tom sträng. For iOS-versionen 6 och senare sätts värdet till annonserings-id:t (IDFA). I annat fall blir värdet en tom sträng.
SDK-version
Värdet sätts till SDK-versionen för det operativsystem i vilket appen har installerats. I flesta fall kan du använda motsvarande inbyggda variabel.
Enhet
Enhetsnamn
Värdet ställs in på enhetsnamnet för appen som körs (t.ex. Samsung Android, Pixel 2). I flesta fall kan du använda motsvarande inbyggda variabel.
Språk
Värdet ställs in på den tvåbokstavskod som motsvarar användarens enhetsspråk. I flesta fall kan du använda motsvarande inbyggda variabel.
Operativsystemversion
Värdet ställs in på den operativsystemsversion som appen har installerats i. I flesta fall kan du använda motsvarande inbyggda variabel.
Plattform
Värdet ställs in på plattformen för appen som körs (t.ex. Android, iOS). I flesta fall kan du använda motsvarande inbyggda variabel.
Skärmupplösning
Värdet ställs in på skärmupplösningen på den enhet där appen körs. Formatet är bredd × höjd, till exempel 1920 × 1080. I flesta fall kan du använda motsvarande inbyggda variabel.
Annat
Funktionsanrop
Värdet ställs in på returvärdet på ett anrop till en förregistrerad funktion. Mer information finns i SDK-dokumentationen för Android eller iOS.
Värdesamling (endast äldre behållare)
Den här variabeln innehåller en uppsättning par med nyckel och värde i JSON-format. Du kan använda en värdesamling när du vill ange konfigurationsvärden för din app. I en bilspelsapp kan du till exempel definiera en värdesamlingsvariabel med namnet Appinställningar med följande:
{
"max-fuel": 200,
"starting-fuel": 100,
"fuel-burn-rate": 20
}
Mobilappen kan sedan hämta ett värde i variabeln med nyckeln: Exempel:
public class MainActivity {
// Lägg till offentligt behållar-id.
private static final String CONTAINER_ID = "XXX-YYY";
// Värdenycklar för behållarkonfiguration, används senare
// för att hämta värden.
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";
// Resterande onCreate-kod.
}
}
/*
* Metod för att uppdatera spelkonfigurationsvärden med en
* behållare i Google Taggstyrning.
*/
public void updateConfigurationFromContainer(Container container) {
// Hämta en referens till behållaren.
Container container = mFutureContainer.get();
// Uppdatera spelinställningar med Containers
// konfigurationsvärdesnycklar.
maxFuel = mContainer.getDoubleValue(MAX_FUEL_KEY);
startingFuel = mContainer.getDoubleValue(INIT_FUEL_KEY);
burnRate = mContainer.getDoubleValue(FUEL_BURN_KEY);
}
En värdesamlingsvariabel har tillhörande utlösare. För konfigurationsvärden som gäller alla instanser och versioner av din app ska du ställa in den aktiverande utlösaren på det fördefinierade värdet Alltid. Se utvecklardokumentationen (Android eller iOS) för mer information om hur du använder Value Collection-variabeln.