Jest to implementacja Menedżera tagów Google na urządzenia mobilne. Przykładowe zastosowanie:
Container container = TagManager.getInstance(context).openContainer(myContainerId); String value = container.getString("myKey"); DataLayer dataLayer = TagManager.getInstance(context).getDataLayer(); dataLayer.push(DataLayer.mapOf("event", "openScreen", "screenName", "Main Page"));
Klasa Container
udostępnia metody pobierania wartości dla danego klucza.
Rutyny getBoolean(String)
, getDouble(String)
,
getLong(String)
, getString(String)
zwracają bieżącą wartość
jako wartość klucza makra zbierania wartości,
w zależności od reguł powiązanych z kontenerem.
Na przykład: jeśli Twój kontener zawiera makro zbierania wartości z kluczem speed
, którego
ma wartość 32, a reguła włączania to Language
, a wartość „en”; i kolejny zbiór wartości
z kluczem speed
, którego wartość wynosi 45, a regułą włączania jest
Language
nie ma wartości „en”, a następnie wykonuje to wywołanie:
container.getLong("speed")
Warstwa danych to mapa z ogólnymi informacjami o aplikacji.
Klasa DataLayer
udostępnia metody przekazywania danych z warstwy danych i ich pobierania.
Przekazywanie klucza event
do warstwy danych spowoduje, że tagi pasujące do tego zdarzenia
wystrzelić.
Z aplikacją jest dołączana początkowa wersja kontenera. Powinna być
jest umieszczany jako zasób o nazwie tagmanager/containerId, gdzie containerId jest taki sam.
którego będziesz używać w ramach tego interfejsu API. Gdy wywołujesz openContainer(String, Container.Callback)
, kontener
zostanie zwrócona wraz z tymi pakietami reguł/makr.
Utworzysz kontener w interfejsie i klikniesz przycisk Pobierz, aby go pobrać.
Możesz zmodyfikować kontener w interfejsie użytkownika i opublikować nową wersję. W takim przypadku następnym razem aplikacja mobilna odświeża kontener z sieci (obecnie co 12 godzin), otrzyma tę nową wersję. Gdy jedną z procedur get..., wartość zostanie obliczona przy użyciu najnowszych reguł.
pobrany kontener jest zapisywany lokalnie; gdy zadzwonisz do: openContainer(String, Container.Callback)
, najpierw zostanie
wczytaj domyślny kontener, a następnie asynchronicznie wczyta dowolny zapisany kontener. Jeśli żadna
lub jeśli jest on starszy niż 12 godzin, spróbuje pobrać z sieci jego nowszą wersję.
Stan tych wczytań asynchronicznych możesz sprawdzić, przekazując
Container.Callback
do openContainer(String, Container.Callback)
.
Czasami możesz chcieć blokować reklamy do czasu, aż dostępny będzie kontener inny niż domyślny, lub do czasu,
świeży kontener jest dostępny. ContainerOpener
to klasa narzędziowa, która może pomóc.
Gdy skończysz pracę z kontenerem, wywołaj funkcję close()
.
Podsumowanie zajęć zagnieżdżonych
interfejs, | TagManager.Logger | Prosty interfejs do obsługi błędów/warning/info/debug/verbose. | |
enum | typ wyliczeniowy | TagManager.RefreshMode | Tryb odświeżania kontenera. |
Podsumowanie metody publicznej
Kontener |
getContainer(ciąg containerId)
|
Kontekst | |
DataLayer | |
statyczny TagManager |
getInstance(kontekst kontekstu)
|
Rejestrator | |
TagManager.RefreshMode | |
Kontener | |
nieważne | |
nieważne |
Metody publiczne
publiczne Kontener getContainer (Ciąg containerId)
Zwraca otwarty kontener powiązany z tabelą containerId
.
zwraca wartość null
, jeśli kontener nie jest jeszcze otwarty.
publiczne kontekst, . getContext ()
Zwraca zapisany kontekst powiązany z tym obiektem.
publiczne statyczny TagManager getInstance (kontekst kontekst)
Pobierz instancję klasy TagManager
i w razie potrzeby ją utwórz.
publiczne TagManager.RefreshMode getRefreshMode ()
Zwraca tryb odświeżania używany we wszystkich kontenerach.
publiczne Kontener openContainer (Ciąg containerId, Container.Callback wywołanie zwrotne)
Zwraca kontener. Oddzwanianie będzie nawiązywane w różnych sytuacjach kontener. OpenContainer spróbuje wczytać co najmniej zapisaną wersję pliku kontenera. Jeśli nie ma zapisanej wersji lub zapisana wersja jest nieaktualna, spróbuj będzie ładowany z poziomu sieci.
Zwykle zwrócony kontener będzie pusty, ale wczytywanie nastąpi na innym , więc zwracany kontener może zostać odświeżony, zanim zostanie zwrócony, po jego zwróceniu. lub może nigdy nie zostać odświeżona (jeśli na przykład w trakcie użytkowania usługi nie będzie połączenia sieciowego kontenera).
Jeśli ponownie wywołasz openContainer
dla danego containerId
,
zostanie zgłoszony.
Parametry
containerId | identyfikator kontenera do otworzenia |
wywołanie zwrotne | obiekt, którego różne metody będą wywoływane podczas części wczytywania
proces tworzenia konta. Pamiętaj, że metody mogą być wywoływane z różnych wątków. Ponadto mogą oni
należy wywołać przed zwróceniem funkcji openContainer .
|
publiczne nieważne . setLogger (rejestrator rejestrator)
Zastępuje dotychczasowy rejestrator używany przez Menedżera tagów.
publiczne nieważne . setRefreshMode (TagManager.RefreshMode tryb)
Ustawia tryb odświeżania używany we wszystkich kontenerach.