W Menedżerze tagów Google możesz tworzyć niestandardowe zmienne definiowane przez użytkownika dla aplikacji mobilnych, które są dopasowane do konkretnych wymagań, jakich nie spełniają zmienne wbudowane.
Aby utworzyć nową zmienną definiowaną przez użytkownika:
- W menu po lewej stronie kliknij Zmienne.
- W sekcji Zmienne zdefiniowane przez użytkownika kliknij Nowa.
- Kliknij Konfiguracja zmiennej i wybierz odpowiedni typ zmiennej.
- Określ opcje dla wybranego typu zmiennej.
- Nadaj nazwę zmiennej. Zastosuj opisową konwencję nazewnictwa wskazującą funkcję zmiennej, np. „Zmienna warstwy danych – nazwa produktu”.
- Kliknij Zapisz.
Menedżer tagów obsługuje następujące typy zmiennych definiowanych przez użytkownika do aplikacji mobilnych:
Firebase
Nazwa zdarzenia
Wartość będzie ustawiona na „nazwaZdarzeniaXYZ”, gdy w aplikacji zostanie wykonany następujący kod:
Android:
FirebaseAnalytics.getInstance(mContext).logEvent("nazwaZdarzeniaXYZ", null);
iOS:
[FIRAnalytics logEventWithName:@"nazwaZdarzeniaXYZ" parameters:parameters];
W większości przypadków należy użyć odpowiedniej zmiennej wbudowanej.
Parametr zdarzenia
Przyjmowana jest wartość parametru zdarzenia Google Analytics (Firebase) dla danego klucza.
Usługa użytkownika Firebase
Przyjmowana jest wartość usługi użytkownika Google Analytics (Firebase) dla danego klucza.
Narzędzia
Śledzenie reklam włączone
Na Androidzie zmienna zwraca wartość „prawda”, jeśli śledzenie reklam jest włączone, lub „fałsz”, jeśli użytkownik zrezygnował z reklam opartych na zainteresowaniach. Więcej informacji znajdziesz w witrynie dla programistów Androida. Pakiet SDK w wersji starszej niż 4 będzie zawsze zwracać wartość „fałsz”. W systemie iOS w wersji 6 lub nowszej przyjmowaną wartością jest advertisingTrackingEnabled. W innym wypadku wartość jest ustawiona jako „prawda”. W większości przypadków należy użyć odpowiedniej zmiennej wbudowanej.
Stała
Wartość jest ustawiona na podany przez Ciebie ciąg.
Ustawienia Google Analytics
Zmienna ustawień Google Analytics jest używana w tagach Universal Analytics w kontenerach stron internetowych i aplikacji mobilnych (Firebase) do centralnego konfigurowania i udostępniania ustawień Google Analytics wykorzystywanych w wielu tagach. Gdy utworzysz tag Google Analytics za pomocą Universal Analytics, Menedżer tagów poprosi Cię o wybranie lub utworzenie zmiennej ustawień Google Analytics. Więcej informacji
Tabela przeglądowa
Wartość jest ustawiana zgodnie z instrukcjami podanymi w tabeli przeglądowej. Tabela przeglądowa zawiera dwie kolumny (pusta tabela ilustruje sposób późniejszego użycia danych):
| Kiedy [wybierz zmienną] równa się | Ustaw [tę zmienną] na |
|---|---|
Tabela przeglądowa pozwala utworzyć zmienną, której wartość będzie zależna od wartości innej zmiennej. Jest to przydatne, gdy Twoją aplikację skonfigurowano tak, że odpowiednia wartość (np. identyfikator śledzenia konwersji) może zostać zmapowana na kod wersji aplikacji lub inny jej aspekt. Ten przykład pokazuje utworzenie zmiennej o nazwie Identyfikator konwersji. W przypadku kodu wersji aplikacji 1.0 przyjmowana jest wartość „12345”. Jeśli kod wersji aplikacji to 1.1, przyjmowana jest wartość „34567”. Tabela przeglądowa nie ma limitu wierszy. Wielkość liter w polach ma znaczenie.
| Gdy {{Kod wersji aplikacji}} równa się | Ustaw {{Identyfikator konwersji}} na |
|---|---|
| 1.0 | 12345 |
| 1.1 | 34567 |
| 1.2 | 56789 |
Losowa liczba
Ustawieniem tej wartości jest losowa liczba od 0 do 2147483647. W większości przypadków należy użyć odpowiedniej zmiennej wbudowanej.
Dane kontenera
Identyfikator kontenera
Ta wartość to publiczny identyfikator kontenera (np. GTM-ABC42). W większości przypadków należy użyć odpowiedniej zmiennej wbudowanej.
Numer wersji kontenera
Gdy kontener znajduje się w trybie podglądu, wartością tej zmiennej jest numer wersji podglądu kontenera. W innym wypadku wartością zmiennej jest numer opublikowanej wersji kontenera. W większości przypadków należy użyć odpowiedniej zmiennej wbudowanej.
Aplikacja
Identyfikator aplikacji
Przyjmowaną wartością jest nazwa pakietu (Android) lub identyfikator pakietu (iOS). W większości przypadków należy użyć odpowiedniej zmiennej wbudowanej.
Nazwa aplikacji
Przyjmowaną wartością jest nazwa aplikacji. W większości przypadków należy użyć odpowiedniej zmiennej wbudowanej.
Kod wersji aplikacji
Wartość jest ustawiona na wersję aktualnie działającej aplikacji. W większości przypadków należy użyć odpowiedniej zmiennej wbudowanej.
Identyfikator reklam
Na Androidzie przyjmowaną wartością jest identyfikator wyświetlania reklam. Pakiet SDK w wersji starszej niż 4 zawsze będzie zwracać pusty ciąg znaków. W iOS w wersji 6 lub nowszej przyjmowaną wartością jest identyfikator reklamy (IDFA). W innych przypadkach wartość jest ustawiona jako pusty ciąg.
Wersja SDK
Wartość jest ustawiona na wersję SDK systemu operacyjnego, w którym zainstalowano aplikację. W większości przypadków należy użyć odpowiedniej zmiennej wbudowanej.
Urządzenie
Nazwa urządzenia
Wartość jest ustawiona na nazwę urządzenia, na którym aktualnie działa aplikacja (np. „Samsung Android”, „Pixel 2”). W większości przypadków należy użyć odpowiedniej zmiennej wbudowanej.
Język
Wartość jest ustawiona na dwuliterowy kod języka, który odpowiada językowi urządzenia ustawionemu przez użytkownika. W większości przypadków należy użyć odpowiedniej zmiennej wbudowanej.
Wersja systemu operacyjnego
Wartość jest ustawiona na wersję systemu operacyjnego, w którym jest zainstalowana aplikacja. W większości przypadków należy użyć odpowiedniej zmiennej wbudowanej.
Platforma
Przyjmowaną wartością jest nazwa platformy aktualnie działającej aplikacji („Android” lub „iOS”). W większości przypadków należy użyć odpowiedniej zmiennej wbudowanej.
Rozdzielczość ekranu
Przyjmowaną wartością jest rozdzielczość ekranu urządzenia, na którym aplikacja jest aktualnie uruchomiona. Format to „szerokość x wysokość”, np. „1920 x 1080”. W większości przypadków należy użyć odpowiedniej zmiennej wbudowanej.
Inne
Połączenie z funkcją
Wartość jest ustawiona na zwróconą wartość wywołania zarejestrowanej wcześniej funkcji. Więcej informacji znajdziesz w dokumentacji pakietu SDK na Androida lub iOS.
Zbiór wartości (tylko starsze kontenery)
Ta zmienna zawiera zestaw par klucz-wartość wyrażonych w formacie JSON. Może ona służyć do ustawiania wartości konfiguracyjnych aplikacji. W przypadku np. aplikacji z symulatorem wyścigów samochodowych można zdefiniować następującą zmienną „Ustawienia aplikacji” należącą do typu Zbiór wartości:
{
"max-fuel": 200,
"starting-fuel": 100,
"fuel-burn-rate": 20
}
Aplikacja mobilna może pobrać wartość zmiennej za pomocą klucza. Na przykład:
public class MainActivity {
// Dodaj publiczny identyfikator kontenera.
private static final String CONTAINER_ID = "XXX-YYY";
// Klucze wartości konfiguracyjnych kontenera, służące później
// do pobierania wartości.
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";
// Reszta kodu onCreate.
}
}
/*
* Metoda aktualizowania wartości konfiguracyjnych gry za pomocą
* kontenera Menedżera tagów Google.
*/
public void updateConfigurationFromContainer(Container container) {
// Pobranie odniesienia do kontenera.
Container container = mFutureContainer.get();
// Aktualizacja ustawień gry przy użyciu
// kluczy wartości konfiguracyjnych kontenera.
maxFuel = mContainer.getDoubleValue(MAX_FUEL_KEY);
startingFuel = mContainer.getDoubleValue(INIT_FUEL_KEY);
burnRate = mContainer.getDoubleValue(FUEL_BURN_KEY);
}
Ze zmienną typu Zbiór wartości są powiązane reguły. W przypadku zmiennych konfiguracji mających zastosowanie do wszystkich wystąpień i wersji Twojej aplikacji ustaw dla reguły wstępnie zdefiniowaną opcję Zawsze. Szczegółowe informacje o korzystaniu ze zmiennej Zbiór wartości znajdziesz w dokumentacji dla programistów Androida lub iOS.