Tagi Universal Analytics

Aby umożliwić wprowadzanie zmian w czasie działania w implementacji Google Analytics, które nie wymagają ponownego skompilowania pliku binarnego aplikacji i ponownego przesłania go do platform handlowych, zaimplementuj Universal Analytics (UA) w swojej aplikacji za pomocą Menedżera tagów Google.

Z tego przewodnika dowiesz się, jak za pomocą tagów Universal Analytics i pakietu SDK Menedżera tagów Google na iOS:

• Wysyłanie wyświetleń ekranu
• Wysyłanie wydarzeń.
• Wysyłanie transakcji e-commerce
• Wysyłanie danych Ulepszonego e-commerce

Uwaga: w tym przewodniku zakładamy, że zostały przez Ciebie wykonane instrukcje podane w Wprowadzeniu do implementacji Menedżera tagów Google w iOS.

Wysyłaj wyświetlenia ekranu

Aby wysyłać do Google Analytics wyświetlenia ekranu po każdym otwarciu nowego ekranu w aplikacji:

1. Utwórz zmienną nazwy ekranu.
2. Utwórz aktywator zdarzenia otwartego ekranu.
3. Utwórz tag Universal Analytics wyświetlenia ekranu.
4. Przekaż zdarzenie otwarcia ekranu i nazwę ekranu do warstwy danych.

1. Tworzenie zmiennej nazwy ekranu

Aby utworzyć w Menedżerze tagów Google zmienną nazwy ekranu:

1. Zaloguj się na konto Menedżera tagów Google.
2. Wybierz kontener mobilny.
3. Na pasku nawigacyjnym po lewej stronie kliknij Zmienne.
4. W sekcji Zmienne zdefiniowane przez użytkownika kliknij Nowa.
5. Kliknij Zmienna bez nazwy, by wpisać nazwę zmiennej nazwa ekranu.
6. Jako typ zmiennej wybierz Zmienna warstwy danych.
7. W polu Nazwa zmiennej warstwy danych wpisz screenName i ustaw jego wartość domyślną unknown screen.

   Zobacz zrzut ekranu przedstawiający tworzenie zmiennej nazwy ekranu.

   

8. Kliknij Utwórz zmienną.

2. Tworzenie reguły zdarzenia otwartego ekranu

Aby utworzyć w Menedżerze tagów Google regułę uruchamiającą tag wyświetlenia ekranu Universal Analytics:

1. Zaloguj się na konto Menedżera tagów Google.
2. Wybierz kontener mobilny.
3. Na pasku nawigacyjnym po lewej stronie kliknij Reguły.
4. Kliknij Nowa.
5. Kliknij Reguła bez nazwy, aby wpisać nazwę reguły OpenScreenEvent.
6. Wybierz Zdarzenie niestandardowe.
7. W sekcji Warunki uruchamiania wpisz ten warunek:

   

8. Kliknij Utwórz regułę.

3. Tworzenie tagu wyświetlenia ekranu Universal Analytics

Aby utworzyć tag wyświetlenia ekranu Universal Analytics uruchamiany przez zdarzenie ekranu otwartego:

1. Zaloguj się na konto Menedżera tagów Google.
2. Wybierz kontener mobilny.
3. Na pasku nawigacyjnym po lewej stronie kliknij Tagi.
4. Kliknij Nowa.
5. Kliknij Tag bez nazwy, aby wpisać nazwę tagu Open Screen.
6. Wybierz usługę Google Analytics.
7. Wpisz identyfikator śledzenia.
8. Jako Typ śledzenia wybierz Widok aplikacji.
9. Kliknij Więcej ustawień.
10. Kliknij Pola do ustawienia.
11. Kliknij wielokrotnie + Dodaj pole, aby dodać te pola:

    

12. Kliknij Dalej.
13. W sekcji Warunki uruchamiania kliknij Niestandardowe.
14. Wybierz aktywator niestandardowy OpenScreenEvent.
15. Kliknij Zapisz.
16. Kliknij Utwórz tag.

4. Przekaż zdarzenie otwarcia ekranu i nazwę ekranu do warstwy danych

Dodaj do aplikacji kod, aby przekazać zdarzenie openScreen i wartość screenName do warstwy danych, na przykład:

//  ViewController.m
//  Push an 'openScreen' event to the data layer.
//
#import "ViewController.h"
#import "TAGDataLayer.h"
#import "TAGManager.h"

@implementation ViewController

- (void)viewDidAppear {
    [super viewDidAppear];

    // NOTE: A GTM container should already have been opened, otherwise events
    //     pushed to the DataLayer will not fire tags in that container.
    TAGDataLayer *dataLayer = [TAGManager instance].dataLayer;

    [dataLayer push:@{@"event": @"openScreen",          // Event, name of Open Screen Event.
                      @"screenName": @"Home Screen"}];  // Name of the screen name field, screen name value.
}

// Rest of the ViewController implementation

@end

Wysyłaj wydarzenia

Aby wysyłać do Google Analytics zdarzenie, gdy użytkownik wejdzie w interakcję z elementami sterującymi lub zawartością Twojej aplikacji:

1. (Opcjonalnie) Utwórz zmienne wydarzenia.
2. Utwórz regułę zdarzenia.
3. Utwórz tag zdarzenia Universal Analytics.
4. Przekaż wartość zmiennej zdarzenia i zdarzenia do warstwy danych.

Z podanych niżej instrukcji dowiesz się, jak zdarzenie jest wysyłane do Google Analytics, gdy użytkownik rozpoczyna odtwarzanie filmu.

1. (Opcjonalnie) Tworzenie zmiennych wydarzenia

Jeśli zdarzenie używa zmiennych warstwy danych do reprezentowania pól kategorii, działania, etykiety lub wartości, musisz najpierw utworzyć te zmienne. W tym przykładzie tag zdarzenia odtworzenia filmu korzysta ze zmiennej warstwy danych, aby uzyskać nazwę filmu.

Aby utworzyć zmienną nazwy filmu w Menedżerze tagów Google:

1. Zaloguj się na konto Menedżera tagów Google.
2. Wybierz kontener mobilny.
3. Na pasku nawigacyjnym po lewej stronie kliknij Zmienne.
4. W sekcji Zmienne zdefiniowane przez użytkownika kliknij Nowa.
5. Kliknij Zmienna bez nazwy, aby wpisać nazwę zmiennej nazwa filmu.
6. Jako typ zmiennej wybierz Zmienna warstwy danych.
7. Wpisz videoName w polu Nazwa zmiennej warstwy danych i ustaw jego wartość domyślną na nieznany film.

   Zobacz zrzut ekranu przedstawiający tworzenie zmiennej nazwy filmu.

   

8. Kliknij Utwórz zmienną.

2. Tworzenie reguły zdarzenia

Aby utworzyć w Menedżerze tagów Google regułę zdarzenia powodującą uruchamianie tagu zdarzenia Universal Analytics:

1. Zaloguj się na konto Menedżera tagów Google.
2. Wybierz kontener mobilny.
3. Na pasku nawigacyjnym po lewej stronie kliknij Reguły.
4. Kliknij Nowa.
5. Kliknij Reguła bez nazwy, aby wpisać nazwę reguły VideoPlayEvent.
6. Wybierz Zdarzenie niestandardowe.
7. W sekcji Warunki uruchamiania wpisz ten warunek:

   

8. Kliknij Utwórz regułę.

3. Tworzenie tagu zdarzenia Universal Analytics

Aby utworzyć tag zdarzenia Universal Analytics uruchamiany przez zdarzenie odtworzenia wideo:

1. Zaloguj się na konto Menedżera tagów Google.
2. Wybierz kontener mobilny.
3. Na pasku nawigacyjnym po lewej stronie kliknij Tagi.
4. Kliknij Nowa.
5. Kliknij Tag bez nazwy, aby wpisać nazwę tagu Zdarzenie odtwarzania wideo.
6. Wybierz usługę Google Analytics.
7. Wpisz identyfikator śledzenia.
8. Jako Typ śledzenia wybierz Zdarzenie.
9. Wpisz te parametry śledzenia zdarzeń:

   

10. Kliknij Więcej ustawień.
11. Kliknij Pola do ustawienia.
12. Kliknij wielokrotnie + Dodaj pole, aby dodać te pola:

    

13. Kliknij Dalej.
14. W sekcji Warunki uruchamiania kliknij Niestandardowe.
15. Wybierz regułę niestandardową VideoPlayEvent.
16. Kliknij Zapisz.
17. Kliknij Utwórz tag.

4. Przekazywanie wartości zmiennej i zdarzenia do warstwy danych

Napisz kod, który przekazuje zdarzenie videoPlay i wartość videoName do warstwy danych, na przykład:

//  VideoPlayer.m
//  Push a 'videoPlay' event to the data layer.
//
#import "TAGDataLayer.h"
#import "TAGManager.h"
#import "Video.h"
#import "VideoPlayer.h"

@implementation VideoPlayer
// Called when a user initiates a video playback.
- (void)onPlay:(Video *)video {

    TAGDataLayer *dataLayer = [TAGManager instance].dataLayer;

    // This call assumes the container has already been opened, otherwise events
    // pushed to the DataLayer will not fire tags in that container.
    [dataLayer push:@{@"event": @"videoPlay",          // Event, name of Video Play Event.
                      @"videoName": video.title,       // Additional data layer variables used by the event tag.
                      @"screenName": @"Home Screen"}];

    [self play:video];
}

// Rest of the implementation
@end

Wysyłaj transakcje e-commerce

Ważne: śledzenie e-commerce wymaga użycia typów śledzenia transakcji i produktów. Nie należy używać funkcji Ulepszonego e-commerce do standardowego śledzenia e-commerce.

Aby wysłać transakcję i powiązane z nią elementy do Google Analytics, gdy użytkownik dokona zakupu w aplikacji:

1. Utwórz regułę transakcji.
2. Utwórz tag transakcji Universal Analytics.
3. Przekazywanie zdarzeń, transakcji i elementów do warstwy danych

Listę obsługiwanych nazw zmiennych transakcji i elementów znajdziesz w artykule Obsługiwane zmienne warstwy danych e-commerce.

1. Tworzenie aktywatora transakcji

Aby utworzyć w Menedżerze tagów Google regułę transakcji, która będzie uruchamiać tag transakcji Universal Analytics:

1. Zaloguj się na konto Menedżera tagów Google.
2. Wybierz kontener mobilny.
3. Na pasku nawigacyjnym po lewej stronie kliknij Reguły.
4. Kliknij Nowa.
5. Kliknij Reguła bez nazwy, aby wpisać nazwę reguły TransactionCompleted.
6. Wybierz Zdarzenie niestandardowe.
7. W sekcji Warunki uruchamiania wpisz ten warunek:

   

8. Kliknij Utwórz regułę.

2. Tworzenie tagu transakcji Universal Analytics

Aby utworzyć tag transakcji Universal Analytics uruchamiany przez zdarzenie transakcji:

1. Zaloguj się na konto Menedżera tagów Google.
2. Wybierz kontener mobilny.
3. Na pasku nawigacyjnym po lewej stronie kliknij Tagi.
4. Kliknij Nowa.
5. Kliknij Tag bez nazwy, aby wpisać nazwę tagu Transakcja zakończona.
6. Wybierz usługę Google Analytics.
7. Wpisz identyfikator śledzenia.
8. Jako Typ śledzenia wybierz Transakcja.
9. Kliknij Więcej ustawień.
10. Kliknij Pola do ustawienia.
11. Kliknij wielokrotnie + Dodaj pole, aby dodać te pola:

    

12. Kliknij Dalej.
13. W sekcji Warunki uruchamiania kliknij Niestandardowe.
14. Wybierz regułę niestandardową TransactionCompleted.
15. Kliknij Zapisz.
16. Kliknij Utwórz tag.

3. Przekazywanie transakcji, transakcji i elementów do warstwy danych

Napisz kod, który przekazuje zdarzenie transakcji, transakcję i powiązane z nimi elementy do warstwy danych. Aby przekazywać dane o transakcjach i produktach do warstwy danych, musisz używać obsługiwanych nazw zmiennych transakcji i produktów. Na przykład:

// Called when a user completes a transaction.
- (void)onPurchaseCompleted:(Purchase *)purchase {

  TAGDataLayer *dataLayer = [TAGManager instance].dataLayer;

  // An array to store dictionaries of item data.
  NSMutableArray *purchasedItems = [NSMutableArray array];

  // Push item data into dictionaries and store in the purchasedItems array.
  // Note that item.price and item.quantity must be of type NSString.
  for (id item in purchase.items) {
    [purchasedItems addObject:@{@"name": item.name,
                                @"sku": item.sku,
                                @"category": item.category,
                                @"price": item.price,
                                @"currency": @"USD",
                                @"quantity": item.quantity}];
  }

  // This call assumes the container has already been opened, otherwise events
  // pushed to the DataLayer will not fire tags in that container.
  // Note that purchase.tax, purchase.shipping, and purchase.total must be of type NSString.
  [dataLayer push:@{@"event": @"transaction",                  // Event, name of Transaction Event.
                    @"transactionId": purchase.transactionId,  // Additional fields required by the tag.
                    @"transactionTotal": purchase.total,
                    @"transactionAffiliation": @"In-app Store",
                    @"transactionTax": purchase.tax,
                    @"transactionShipping": purchase.shipping,
                    @"transactionCurrency": @"USD",
                    @"transactionProducts": purchasedItems}];

  // Since the data layer is persistent, you should reset fields to [NSNull null] after
  // you are done pushing the transaction.
  [dataLayer push:@{@"transactionId": [NSNull null],
                    @"transactionTotal": [NSNull null],
                    @"transactionAffiliation": [NSNull null],
                    @"transactionTax": [NSNull null],
                    @"transactionShipping": [NSNull null],
                    @"transactionCurrency": [NSNull null],
                    @"transactionProducts": [NSNull null]}];
}

Więcej informacji o korzystaniu z pakietu SDK Menedżera tagów Google na Androida do wdrażania funkcji ulepszonego e-commerce Universal Analytics znajdziesz w artykule Ulepszony e-commerce.

Obsługiwane zmienne warstwy danych e-commerce

Uniwersalne tagi transakcji obsługują podane niżej nazwy zmiennych transakcji i elementów.

Uwaga: warstwa danych jest trwała, dlatego po przekazaniu transakcji do warstwy danych zresetuj wartości zmiennych transakcji i elementów do null.

Zmienne transakcji

Nazwa zmiennej	Opis	Typ	Wymagane
transactionId	Unikalny identyfikator transakcji	ciąg znaków	Tak
transactionAffiliation	Partner lub sklep	ciąg znaków	Nie
transactionTotal	Łączna wartość transakcji	ciąg znaków	Nie
transactionTax	Wysokość podatku od transakcji	ciąg znaków	Nie
transactionShipping	Koszt dostawy w ramach transakcji	ciąg znaków	Nie
transactionCurrency	Waluta transakcji.	ciąg znaków	Nie
transactionProducts	Lista przedmiotów zakupionych w ramach transakcji	tablicę zmiennych elementów.	Nie

Zmienne elementu

Nazwa zmiennej	Opis	Typ	Wymagane
name	Nazwa produktu	ciąg znaków	Tak
sku	Kod SKU produktu	ciąg znaków	Nie
category	Kategoria produktu	ciąg znaków	Nie
price	Cena produktu	ciąg znaków	Nie
currency	Rodzaj waluty dla kolumny price	ciąg znaków	Nie
quantity	Liczba produktów	ciąg znaków	Nie

Wysyłaj dane ulepszonego e-commerce

Ważne: Ulepszony e-commerce jest dostępny tylko w przypadku śledzenia ekranu (widok aplikacji) i śledzenia zdarzeń. Nie należy używać typów śledzenia transakcji i produktów, które są przeznaczone do standardowego śledzenia e-commerce.

Więcej informacji o wysyłaniu danych ulepszonego e-commerce znajdziesz w przewodniku dla programistów po Ulepszonym e-commerce.