Analytics-Methoden

Hier finden Sie eine Liste der Adobe Analytics-Methoden, die von der iOS-Bibliothek bereitgestellt werden.

Das SDK unterstützt zurzeit mehrere Adobe Experience Cloud-Lösungen, einschließlich Analytics, Target, Audience Manager und Identity-Dienst für Adobe Experience Platform. Methoden erhalten je nach Lösung unterschiedliche Präfixe. Experience Cloud ID-Methoden erhalten beispielsweise das Präfix track.

Jede dieser Methoden wird zum Senden von Daten in Ihre Adobe Analytics Report Suite verwendet.

• trackState:​data:

  Die Statusangaben entsprechen den verfügbaren Ansichten in der App, z. B. home dashboard, app settings und cart. Diese Statusangaben sind mit den Seiten in einer Website vergleichbar, und trackState-Aufrufe inkrementieren die Seitenansichten. Wenn state leer ist, wird in Berichten App-Name App-Version (Build) angezeigt. Wenn dieser Wert in einem Bericht auftritt, müssen Sie den Status state in jedem trackState-Aufruf festlegen.

  TIPP

  Dies ist der einzige Verfolgungsaufruf, bei dem die Seitenansichten inkrementiert werden.

  • Hier finden Sie die Syntax für diese Methode:

    + (void)  trackState:(NSString  *)state
                    data:(NSDictionary  *)data;
    

  • Hier finden Sie ein Code-Beispiel für diese Methode:

    [ADBMobile  trackState:@"loginScreen"
                      data:nil]; 
    

• trackAction:​data:

  Verfolgt eine Aktion in der App. Aktionen, die Sie messen möchten, wie z. B. logons, banner taps, feed subscriptions und andere Metriken, die in Ihrer App auftreten.

  TIPP

  Falls Code aktiv ist, während die App im Hintergrund ausgeführt wird (z. B. Datenabruf im Hintergrund), verwenden Sie stattdessen trackActionFromBackground.

  • Hier finden Sie die Syntax für diese Methode:

    +  (void)  trackAction:(NSString  *)action
                      data:(NSDictionary  *)data; 
    

  • Hier finden Sie ein Code-Beispiel für diese Methode:

    [ADBMobile  trackAction:@"heroBannerTouched"
                       data:nil]; 
    

• trackingIdentifier

  Ruft die Analytics-Tracking-ID ab.

  • Hier finden Sie die Syntax für diese Methode:

    + (NSString *) trackingIdentifier; 
    

  • Hier finden Sie ein Code-Beispiel für diese Methode:

    NSString *trackingId = [ADBMobile trackingIdentifier];
    

• trackActionFromBackground:​data:

  Verfolgt eine Aktion im Hintergrund, wodurch das Auslösen von Lebenszyklusereignissen in bestimmten Szenarios unterdrückt wird.

  TIPP

  Diese Methode sollte nur in Code aufgerufen werden, der aktiv ist, während die App im Hintergrund ausgeführt wird.

  • Hier finden Sie die Syntax für diese Methode:

     +  (void)  trackActionFromBackground:(NSString  *)action
                                     data:(NSDictionary  *)data; 
    

  • Hier finden Sie ein Code-Beispiel für diese Methode:

    [ADBMobile  trackActionFromBackground:@"downloadedUpdate"
                                     data:nil];
    

• trackLocation:​data:

  Sendet die aktuellen XY-Koordinaten. Ermittelt außerdem anhand der in der Datei ADBMobileConfig.json definierten Zielpunkte (POIs), ob der als Parameter angegebene Standort in einem vorhandenen Zielpunkt liegt. Falls die aktuellen Koordinaten auf einen definierten Zielpunkt passen, wird eine Kontextdatenvariable gefüllt und zusammen mit dem trackLocation-Aufruf gesendet.

  • Hier finden Sie die Syntax für diese Methode:

    +  (void)  trackLocation:(CLLocation  *)location
                        data:(NSDictionary  *)data; 
    

  • Hier finden Sie ein Code-Beispiel für diese Methode:

    [ADBMobile  trackLocation:userLocation
                         data:nil]; 
    

• trackBeacon:​data:

  Verfolgt das Eintreten eines Benutzers in den Radius eines Beacons.

  • Hier finden Sie die Syntax für diese Methode:

    +  (void)  trackLocation:(CLBeacon  *)beacon
                        data:(NSDictionary  *)data;
    

  • Hier finden Sie ein Code-Beispiel für diese Methode:

    [ADBMobile  trackBeacon:beacon
                       data:nil];
    

• trackingClearCurrentBeacon

  Löscht die Beacon-Daten, sobald der Benutzer den Radius des Beacons verlässt.

  • Hier finden Sie die Syntax für diese Methode:

    + (void) trackingClearCurrentBeacon;
    

  • Hier finden Sie ein Code-Beispiel für diese Methode:

    [ADBMobile trackingClearCurrentBeacon];
    

• trackLifetimeValueIncrease:​data:

  Erhöht den Lebenszeitwert des Benutzers um amount.

  • Hier finden Sie die Syntax für diese Methode:

     +  (void)  trackLifetimeValueIncrease:(NSDecimalNumber  *)amount
                                     data:(NSDictionary  *)data; 
    

  • Hier finden Sie ein Code-Beispiel für diese Methode:

    [ADBMobile  trackLifetimeValueIncrease:30
                                       data:nil];
    

• trackTimedActionStart:​data:

  Startet eine zeitgesteuerte Aktion mit dem Namen action. Wenn Sie diese Methode für eine bereits gestartete Methode aufrufen, wird die vorherige zeitgesteuerte Aktion überschrieben.

  TIPP

  Dieser Aufruf sendet keinen Treffer.

  • Hier finden Sie die Syntax für diese Methode:

    +  (void)  trackTimedActionStart:(NSString  *)action
                                data:(NSDictionary  *)data; 
    

  • Hier finden Sie ein Code-Beispiel für diese Methode:

    [ADBMobile  trackTimedActionStart:@"cartToCheckout"
                                data:nil]; 
    

• trackTimedActionUpdate:​data:

  Übergibt data, mit denen die Kontextdaten für die vorliegende action aktualisiert werden sollen. Die übergebenen Daten (data) werden an die vorhandenen Daten für die Aktion angehängt und wenn der Schlüssel bereits für action definiert ist, werden die Daten überschrieben.

  TIPP

  Dieser Aufruf sendet keinen Treffer.

  • Hier finden Sie die Syntax für diese Methode:

     +  (void)  trackTimedActionUpdate:(NSString  *)action
                                  data:(NSDictionary  *)data; 
    

  • Hier finden Sie ein Code-Beispiel für diese Methode:

    [ADBMobile  trackTimedActionUpdate:@"cartToCheckout"
                                  data:@{@"quantity":@"3"}];
    

• trackTimedActionEnd:​logic:

  Beendet eine zeitgesteuerte Aktion. Wenn Sie block angeben, haben Sie Zugriff auf die endgültigen Zeitwerte und können data vor dem Senden des endgültigen Treffers ändern.

  TIPP

  Wenn Sie block angeben, müssen Sie YES zurückgeben, um einen Treffer zu senden. Wenn Sie nil für block übergeben, wird der endgültige Treffer gesendet.

  • Hier finden Sie die Syntax für diese Methode:

    +  (void)  trackTimedActionEnd:(NSString  *)action
                        logic:(BOOL  (^)  (NSTimeInterval  inAppDuration,
                                                NSTimeInterval totalDuration,
                                                NSMutableDictionary *data))block; 
    

  • Hier finden Sie ein Code-Beispiel für diese Methode:

    [ADBMobile  trackTimedActionEnd:@"cartToCheckout"
                  logic:^(NSTimeInterval inApp,
                  NSTimeInterval  total,
                  NSMutableDictionary  *data)  {
                      data[@"price"]  =  @"49.95";
                      return  YES;
                  }];
    

• trackingTimedActionExists

  Gibt zurück, ob derzeit eine zeitgesteuerte Aktion ausgeführt wird.

  • Hier finden Sie die Syntax für diese Methode:

    + (BOOL) trackingTimedActionExists:(NSString *)action;
    

  • Hier finden Sie ein Code-Beispiel für diese Methode:

    BOOL *actionExists = [ADBMobile trackingTimedActionExists];
    

• trackingSendQueuedHits

  Erfordert SDK 4.1. Unabhängig davon, wie viele Treffer sich derzeit in der Warteschlange befinden, wird erzwungen, dass die Bibliothek alle Treffer in der Offline-Warteschlange sendet.

  • Hier finden Sie die Syntax für diese Methode:

    + (void) trackingSendQueuedHits;
    

  • Hier finden Sie ein Code-Beispiel für diese Methode:

    [ADBMobile trackingSendQueuedHits]; 
    

• trackingGetQueueSize

  Ruft die Anzahl der Zugriffe ab, die sich derzeit in der Offline-Warteschlange befinden.

  • Hier finden Sie die Syntax für diese Methode:

     + (NSUInteger) trackingGetQueueSize;
    

  • Hier finden Sie ein Code-Beispiel für diese Methode:

    NSUInteger *queueSize = [ADBMobile trackingGetQueueSize];
    

• trackingClearQueue

  Löscht alle Zugriffe aus der Offline-Warteschlange.

  VORSICHT

  Gehen Sie beim manuellen Löschen der Warteschlange vorsichtig vor. Dieser Vorgang kann nicht rückgängig gemacht werden.

  • Hier finden Sie die Syntax für diese Methode:

    + (void) trackingClearQueue;
    

  • Hier finden Sie ein Code-Beispiel für diese Methode:

    [ADBMobile trackingClearQueue]; 
    

• trackPushMessageClickThrough

  Verfolgt die Clickthrough-Rate bei Push-Nachrichten.

  WICHTIG

  Bei dieser Methode werden die Seitenansichten nicht inkrementiert.

  • Hier finden Sie die Syntax für diese Methode:

    + (void) trackPushMessageClickThrough:(NSDictionary *)userInfo;
    

  • Hier finden Sie ein Code-Beispiel für diese Methode:

    -  (void)application:(UIApplication  *)application  
    didReceiveRemoteNotification:(NSDictionary  *)userInfo  
    fetchCompletionHandler:(void  (^)
    (UIBackgroundFetchResult))completionHandler  {
        // only send the hit if the app is not active
        if (application.applicationState !=  UIApplicationStateActive)  {
            [ADBMobile  trackPushMessageClickThrough:userInfo];
    
        }
        completionHandler(UIBackgroundFetchResultNoData);
    }