Universal Analytics-Tags

Wenn Sie Änderungen während der Laufzeit an Ihrer Google Analytics-Implementierung vornehmen möchten, für die Sie Ihr App-Binärprogramm nicht neu erstellen und noch einmal an Marktplätze senden müssen, müssen Sie Universal Analytics (UA) mit Google Tag Manager (GTM) in Ihre App implementieren.

In diesem Leitfaden erfahren Sie, wie Sie Universal Analytics-Tags und das Google Tag Manager SDK für iOS für Folgendes verwenden:

Bildschirmaufrufe senden

So senden Sie bei jedem Öffnen eines neuen Bildschirms in Ihrer App einen Bildschirmaufruf an Google Analytics:

  1. Erstellen Sie eine Variable für den Bildschirmnamen.
  2. Erstellen Sie einen Trigger für ein Open-Screen-Ereignis.
  3. Erstellen Sie ein Bildschirmaufruf-Tag für Universal Analytics.
  4. Übertragen Sie das Ereignis und den Bildschirmnamen bei geöffnetem Bildschirm in die Datenschicht.

1. Variable für Bildschirmnamen erstellen

So erstellen Sie eine Variable für den Bildschirmnamen in GTM:

  1. Melden Sie sich in Ihrem Google Tag Manager-Konto an.
  2. Wählen Sie einen mobilen Container aus.
  3. Klicken Sie in der linken Navigationsleiste auf Variablen.
  4. Klicken Sie unter Benutzerdefinierte Variablen auf Neu.
  5. Klicken Sie auf Unbenannte Variable und geben Sie den Variablennamen Bildschirmname ein.
  6. Wählen Sie als Variablentyp Datenschichtvariable aus.
  7. Geben Sie als Name der Datenschichtvariablen screenName ein und legen Sie den Standardwert unbekannter Bildschirm fest.
  8. Klicken Sie auf Variable erstellen.

2. Trigger für ein Open-Screen-Ereignis erstellen

So erstellen Sie in GTM einen Trigger zum Auslösen des Universal Analytics-Bildschirmaufruf-Tags:

  1. Melden Sie sich in Ihrem Google Tag Manager-Konto an.
  2. Wählen Sie einen mobilen Container aus.
  3. Klicken Sie in der linken Navigationsleiste auf Trigger.
  4. Klicken Sie auf Neu.
  5. Klicken Sie auf Unbenannter Trigger, um den Triggernamen OpenScreenEvent einzugeben.
  6. Wählen Sie Benutzerdefiniertes Ereignis aus.
  7. Geben Sie unter Auslösen bei die folgende Bedingung ein:

    Trigger, der ausgelöst wird, wenn das Ereignis den Wert "openScreen" hat

  8. Klicken Sie auf Trigger erstellen.

3. Bildschirmaufruf-Tag für Universal Analytics erstellen

So erstellen Sie ein Universal Analytics-Bildschirmaufruf-Tag, das durch das Open-Screen-Ereignis ausgelöst wird:

  1. Melden Sie sich in Ihrem Google Tag Manager-Konto an.
  2. Wählen Sie einen mobilen Container aus.
  3. Klicken Sie in der linken Navigationsleiste auf Tags.
  4. Klicken Sie auf Neu.
  5. Klicken Sie auf Unbenanntes Tag, um den Tag-Namen Open Screen einzugeben.
  6. Wählen Sie das Produkt Google Analytics aus.
  7. Geben Sie die Tracking-ID ein.
  8. Wählen Sie App-Datenansicht als Tracking-Typ aus.
  9. Klicken Sie auf Weitere Einstellungen.
  10. Klicken Sie auf Festzulegende Felder.
  11. Klicken Sie wiederholt auf + Feld hinzufügen, um die folgenden Felder hinzuzufügen:

    Fügen Sie diese Felder hinzu: App-Name, App-Version und Bildschirmname.

  12. Klicken Sie auf Weiter.
  13. Klicken Sie unter Auslösen bei auf Benutzerdefiniert.
  14. Wählen Sie den benutzerdefinierten Trigger OpenScreenEvent aus.
  15. Klicken Sie auf Speichern.
  16. Klicken Sie auf Tag erstellen.

4. Übertragen Sie das Ereignis und den Bildschirmnamen in die Datenschicht

Fügen Sie Ihrer App Code hinzu, um ein openScreen-Ereignis und einen screenName-Wert an die Datenschicht zu senden. Beispiel:

//  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

Ereignisse senden

So senden Sie ein Ereignis an Google Analytics, wenn ein Nutzer mit UI-Steuerelementen oder Inhalten in Ihrer App interagiert:

  1. Optional: Ereignisvariablen erstellen
  2. Erstellen Sie einen Ereignistrigger.
  3. Erstellen Sie ein Universal Analytics-Ereignis-Tag.
  4. Wert der Ereignis- und Ereignisvariablen in die Datenschicht übertragen:

Im Folgenden wird beschrieben, wie ein Ereignis an Google Analytics gesendet wird, wenn ein Nutzer eine Videowiedergabe startet.

1. Optional: Ereignisvariablen erstellen

Wenn die Felder für Kategorie, Aktion, Label oder Wert des Ereignisses Datenschichtvariablen verwendet werden, müssen Sie diese Variablen zuerst erstellen. In diesem Beispiel verwendet das Ereignis-Tag für die Videowiedergabe eine Datenschichtvariable, um den Namen des Videos abzurufen.

So erstellen Sie eine Variable für den Videonamen in GTM:

  1. Melden Sie sich in Ihrem Google Tag Manager-Konto an.
  2. Wählen Sie einen mobilen Container aus.
  3. Klicken Sie in der linken Navigationsleiste auf Variablen.
  4. Klicken Sie unter Benutzerdefinierte Variablen auf Neu.
  5. Klicken Sie auf Unbenannte Variable, um den Variablennamen Videoname einzugeben.
  6. Wählen Sie als Variablentyp Datenschichtvariable aus.
  7. Geben Sie als Name der Datenschichtvariablen videoName ein und legen Sie den Standardwert unbekanntes Video fest.
  8. Klicken Sie auf Variable erstellen.

2. Ereignistrigger erstellen

So erstellen Sie in GTM einen Ereignistrigger, mit dem das Universal Analytics-Ereignis-Tag ausgelöst wird:

  1. Melden Sie sich in Ihrem Google Tag Manager-Konto an.
  2. Wählen Sie einen mobilen Container aus.
  3. Klicken Sie in der linken Navigationsleiste auf Trigger.
  4. Klicken Sie auf Neu.
  5. Klicken Sie auf Unbenannter Trigger und geben Sie den Triggernamen VideoPlayEvent ein.
  6. Wählen Sie Benutzerdefiniertes Ereignis aus.
  7. Geben Sie unter Auslösen bei die folgende Bedingung ein:

    Ein Trigger, der ausgelöst wird, wenn das Ereignis den Wert „videoPlay“ hat.

  8. Klicken Sie auf Trigger erstellen.

3. Universal Analytics-Ereignis-Tag erstellen

So erstellen Sie ein Universal Analytics-Ereignis-Tag, das durch das Videowiedergabeereignis ausgelöst wird:

  1. Melden Sie sich in Ihrem Google Tag Manager-Konto an.
  2. Wählen Sie einen mobilen Container aus.
  3. Klicken Sie in der linken Navigationsleiste auf Tags.
  4. Klicken Sie auf Neu.
  5. Klicken Sie auf Unbenanntes Tag, um den Tag-Namen Videowiedergabe-Ereignis einzugeben.
  6. Wählen Sie das Produkt Google Analytics aus.
  7. Geben Sie die Tracking-ID ein.
  8. Wählen Sie Ereignis als Tracking-Typ aus.
  9. Geben Sie die folgenden Ereignis-Tracking-Parameter ein:

    Geben Sie folgende Tracking-Parameter ein: Kategorie: Video, Aktion: abspielen und Label: Video.

  10. Klicken Sie auf Weitere Einstellungen.
  11. Klicken Sie auf Festzulegende Felder.
  12. Klicken Sie wiederholt auf + Feld hinzufügen, um die folgenden Felder hinzuzufügen:

    Fügen Sie diese Felder hinzu: App-Name, App-Version und Bildschirmname.

  13. Klicken Sie auf Weiter.
  14. Klicken Sie unter Auslösen bei auf Benutzerdefiniert.
  15. Wählen Sie den benutzerdefinierten Trigger VideoPlayEvent aus.
  16. Klicken Sie auf Speichern.
  17. Klicken Sie auf Tag erstellen.

4. Werte der Ereignis- und Ereignisvariablen in die Datenschicht übertragen

Schreiben Sie Code, um ein videoPlay-Ereignis und einen videoName-Wert an die Datenschicht zu übertragen. Beispiel:

//  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


E-Commerce-Transaktionen senden

So senden Sie die Transaktion und die zugehörigen Artikel nach einem In-App-Kauf an Google Analytics:

  1. Transaktionstrigger erstellen
  2. Erstellen Sie ein Universal Analytics-Transaktions-Tag.
  3. Transaktionsereignisse, -transaktion und -elemente in die Datenschicht übertragen

Eine Liste der unterstützten Namen für Transaktions- und Artikelvariablen finden Sie unter Unterstützte E-Commerce-Datenschichtvariablen.

1. Transaktionstrigger erstellen

So erstellen Sie einen Transaktionstrigger in GTM, um das Universal Analytics-Transaktions-Tag auszulösen:

  1. Melden Sie sich in Ihrem Google Tag Manager-Konto an.
  2. Wählen Sie einen mobilen Container aus.
  3. Klicken Sie in der linken Navigationsleiste auf Trigger.
  4. Klicken Sie auf Neu.
  5. Klicken Sie auf Unbenannter Trigger, um den Triggernamen TransactionCompleted einzugeben.
  6. Wählen Sie Benutzerdefiniertes Ereignis aus.
  7. Geben Sie unter Auslösen bei die folgende Bedingung ein:

    Ein Trigger, der ausgelöst wird, wenn das Ereignis den Bedingungen einer Transaktion entspricht.

  8. Klicken Sie auf Trigger erstellen.

2. Universal Analytics-Transaktions-Tag erstellen

So erstellen Sie ein Universal Analytics-Transaktions-Tag, das durch das Transaktionsereignis ausgelöst wird:

  1. Melden Sie sich in Ihrem Google Tag Manager-Konto an.
  2. Wählen Sie einen mobilen Container aus.
  3. Klicken Sie in der linken Navigationsleiste auf Tags.
  4. Klicken Sie auf Neu.
  5. Klicken Sie auf Unbenanntes Tag und geben Sie den Tag-Namen Transaktion abgeschlossen ein.
  6. Wählen Sie das Produkt Google Analytics aus.
  7. Geben Sie die Tracking-ID ein.
  8. Wählen Sie Transaktion als Tracking-Typ aus.
  9. Klicken Sie auf Weitere Einstellungen.
  10. Klicken Sie auf Festzulegende Felder.
  11. Klicken Sie wiederholt auf + Feld hinzufügen, um die folgenden Felder hinzuzufügen:

    Fügen Sie diese Felder hinzu: App-Name, App-Version und Bildschirmname.

  12. Klicken Sie auf Weiter.
  13. Klicken Sie unter Auslösen bei auf Benutzerdefiniert.
  14. Wählen Sie den benutzerdefinierten Trigger TransactionCompleted aus.
  15. Klicken Sie auf Speichern.
  16. Klicken Sie auf Tag erstellen.

3. Übertragen Sie Transaktionsereignisse, Transaktionen und Elemente in die Datenschicht.

Schreiben Sie Code, um das Transaktionsereignis, die Transaktion und die zugehörigen Elemente an die Datenschicht zu übertragen. Sie müssen die unterstützten Namen für Transaktionen und Artikelvariablen verwenden, um Transaktions- und Artikeldaten an die Datenschicht zu senden. Beispiel:

// 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]}];
}


Weitere Informationen zur Implementierung von erweiterten E-Commerce-Funktionen in Universal Analytics mit dem Google Tag Manager SDK für Android finden Sie unter Erweiterte E-Commerce-Berichte.

Unterstützte E-Commerce-Datenebenenvariablen

Universelle Transaktions-Tags unterstützen die folgenden Namen von Transaktions- und Artikelvariablen.

Transaktionsvariablen

Variablenname Beschreibung Typ Erforderlich
transactionId Eindeutige Transaktionskennung String Ja
transactionAffiliation Partner oder Geschäft String Nein
transactionTotal Gesamtwert der Transaktion String Nein
transactionTax Steuerbetrag für die Transaktion String Nein
transactionShipping Versandkosten für die Transaktion String Nein
transactionCurrency Währung der Transaktion String Nein
transactionProducts Liste der bei der Transaktion erworbenen Artikel ein Array von Elementvariablen. Nein

Artikelvariablen

Variablenname Beschreibung Typ Erforderlich
name Produktname String Ja
sku Artikelnummer des Produkts String Nein
category Produktkategorie String Nein
price Produktpreis String Nein
currency Der Währungstyp von price String Nein
quantity Menge der Artikel String Nein

Erweiterte E-Commerce-Daten senden

Informationen zum Senden von erweiterten E-Commerce-Daten finden Sie im Entwicklerleitfaden zu erweiterten E-Commerce-Berichten.