Konfiguracja zaawansowana – pakiet SDK na iOS

W tym dokumencie znajdziesz przegląd niektórych zaawansowanych funkcji konfiguracyjnych pakietu Google Analytics SDK na iOS w wersji 2.

Przegląd

Pakiet SDK Google Analytics na iOS używa 2 klas do zarządzania globalnym stanem wdrożenia i wysyłania danych na serwery Google Analytics.

  • GAI – pojedynczy element, który obsługuje globalny stan Twojej implementacji, w tym pobieranie nowych obiektów GAITracker, a także ustawienie rezygnacji na poziomie aplikacji i ustawienia wysyłania.
  • GAITracker – klasa, z której wysyłasz dane do Google Analytics. Można utworzyć wiele wystąpień skryptu, po jednym na każdy unikalny identyfikator usługi.

Korzystanie z wielu trackerów

Od wersji 2 pakietu SDK możesz używać wielu skryptów śledzenia w jednej implementacji, po jednym na każdy unikalny identyfikator śledzenia. Wszystkie trackery są przypisane do tego samego stanu globalnego, którym podlega Twój singleton GAI.

W tym przykładzie wyświetlenie ekranu jest wysyłane do 2 osobnych usług za pomocą 2 tagów śledzenia, z których każda ma własny unikalny identyfikator usługi:

#import "RootViewController.h"
#import "GAI.h"

@interface RootViewController ()

@end

@implementation RootViewController
{
- (void)viewDidLoad {
  [super viewDidLoad];

  // Send a screen view to the first property.
  id tracker1 = [[GAI sharedInstance] trackerWithTrackingId:@"UA-XXXX-Y"];
  [tracker1 sendView:@"/HomeScreen"];

  // Send another screen view to the second property.
  id tracker2 = [[GAI sharedInstance] trackerWithTrackingId:@"UA-XXXX-Z"];
  [tracker2 sendView:@"Home"];
}

@end

Pamiętaj, że funkcje automatycznego pomiaru, takie jak automatyczne sprawdzanie danych i pomiar niewykrytych wyjątków, używają tylko jednego trackera do wysyłania danych do Google Analytics. Jeśli korzystasz z tych funkcji i chcesz wysyłać dane za pomocą innych trackerów, musisz to zrobić ręcznie.

W celach informacyjnych, automatyczny pomiar ekranu korzysta z lokalizatora określonego we właściwości tracker danej wartości GAITrackedViewController. Pomiar niewykrytych wyjątków używa domyślnego trackera określonego w instancji GAI.

Domyślny tracker

Implementacja może korzystać z kilku skryptów śledzenia, ale globalnie ma jeden domyślny. Pierwszy pobrany plik Tracker stanie się domyślnym modułem do śledzenia.

Aby pobrać domyślny tracker, użyj:

// Get default tracker.
id myDefault = [GAI sharedInstance].defaultTracker;

Aby ustawić domyślny tracker, użyj:

// Get a new tracker.
id newTracker = [[GAI sharedInstance]trackerWithTrackingId:@"UA-NEW-TRACKING-ID");

// Set the new tracker as the default tracker, globally.
[GAI sharedInstance].defaultTracker = newTracker;

Próbkowanie

Możesz włączyć próbkowanie po stronie klienta, aby ograniczyć liczbę działań wysyłanych do Google Analytics. Jeśli Twoja aplikacja ma dużą liczbę użytkowników lub w inny sposób wysyła do Google Analytics dużą ilość danych, włączenie próbkowania pomoże zapewnić nieprzerwane raportowanie.

Aby np. wdrożyć próbkowanie po stronie klienta z częstotliwością 50%, użyj tego kodu:

// Set a sample rate of 50%.
[tracker setSampleRate:50.0];  // Sample rate is a double.

Rezygnacja na poziomie aplikacji

Możesz włączyć flagę rezygnacji na poziomie aplikacji, która spowoduje wyłączenie Google Analytics w całej aplikacji. Po ustawieniu flaga będzie stosowana przez cały czas istnienia aplikacji lub do chwili jej zresetowania.

Aby uzyskać ustawienie rezygnacji na poziomie aplikacji:

// Get the app-level opt out preference.
if ([GAI sharedInstance].optOut) {
  ... // Alert the user they have opted out.
}

Aby ustawić flagę rezygnacji na poziomie aplikacji, wpisz:


// Set the app-level opt out preference.
[[GAI sharedInstance].setOptOut = YES];

Testowanie i debugowanie

Pakiet Google Analytics SDK na iOS udostępnia tryb debugowania, w którym wyświetlane są przydatne informacje o tym, jakie dane w dziennikach są wysyłane do Google Analytics.

// Enable debug mode.
[GAI sharedInstance].debug = YES;