iOS-Methoden

iOS-Methoden für Xamarin-Komponenten für Experience Cloud-Lösungen mit SDK 4.x.

Konfigurationsmethoden

  • CollectLifecycleData

    Gibt dem SDK gegenüber an, dass Lebenszyklusdaten für die Nutzung aller Lösungen im SDK erfasst werden sollen. Weitere Informationen finden Sie unter Lebenszyklusmetriken.

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

      public static void CollectLifecycleData();
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:

      ADBMobile.CollectLifecycleData();
      
  • DebugLogging

    Gibt die aktuelle Vorgabe für die Debug-Protokollierung zurück. Der Standardwert lautet false.

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

      public static bool DebugLogging();
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:

      var debugEnabled = ADBMobile.DebugLogging();
      
  • SetDebugLogging

    Legt die Debug-Protokollierungseinstellung auf "Aktiviert"fest.

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

      public static void SetDebugLogging(bool enabled);
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:

      ADBMobile.SetDebugLogging(true);
      
  • LifetimeValue

    Gibt den Lebenszeitwert für den aktuellen Benutzer zurück.

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

      public static double LifetimeValue();
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:

      var lifetimeValue = ADBMobile.LifetimeValue();
      
  • PrivacyStatus

    Gibt die Enum-Darstellung für den Datenschutzstatus des aktuellen Benutzers zurück.

    • ADBMobilePrivacyStatus.OptIn: Treffer werden umgehend gesendet.
    • ADBMobilePrivacyStatus.OptOut: werden Treffer verworfen.
    • ADBMobilePrivacyStatus.Unknown : Wenn die Offline-Verfolgung aktiviert ist, werden die Treffer gespeichert, bis der Datenschutzstatus zu "opt-in"(anschließend werden die Treffer gesendet) oder "opt-out"(anschließend werden die Treffer verworfen) geändert wird. Wenn die Offline-Verfolgung deaktiviert ist, werden die Treffer verworfen, bis der Datenschutzstatus zu "opt-in"geändert wird.

    Der Standardwert wird im ADBMobileConfig.json.

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

      public static ADBPrivacyStatus PrivacyStatus();
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:

      var privacyStatus = ADBMobile.PrivacyStatus();
      
  • SetPrivacyStatus

    Legt den Datenschutzstatus für den aktuellen Benutzer auf den Status fest. Die folgenden Werte sind zulässig:

    • ADBMobilePrivacyStatus.OptIn: Treffer werden umgehend gesendet.

    • ADBMobilePrivacyStatus.OptOut: werden Treffer verworfen.

    • ADBMobilePrivacyStatus.Unknown: Bei aktivierter Offline-Verfolgung werden die Treffer so lange gespeichert, bis sich der Datenschutzstatus in „opt-in“ (anschließend werden die Treffer gesendet) oder „opt-out“ (anschließend werden die Treffer verworfen) ändert. Ist die Offline-Verfolgung nicht aktiviert, werden die Zugriffe verworfen, bis der Datenschutzstatus zu „opt-in“ geändert wird.

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

      public static void SetPrivacyStatus(ADBPrivacyStatus status)
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:

      ADBMobile.SetPrivacyStatus(ADBMobilePrivacyStatus.OptIn);
      
  • UserIdentifier

    Gibt die benutzerdefinierte Benutzer-ID zurück, wenn eine benutzerdefinierte ID festgelegt wurde. Gibt null zurück, wenn keine benutzerdefinierte ID festgelegt ist. Der Standardwert lautet null.

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

      public static string UserIdentifier();
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:

      var userId = ADBMobile.UserIdentifier();
      
  • SetUserIdentifier

    Gibt die benutzerdefinierte Benutzer-ID zurück, wenn eine benutzerdefinierte ID festgelegt wurde. Gibt null zurück, wenn keine benutzerdefinierte ID festgelegt ist. Der Standardwert lautet null.

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

      public static string UserIdentifier();
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:

      ADBMobile.SetUserIdentifier ("customUserIdentifier");
      
  • GetVersion

    Ruft die Bibliotheksversion ab.

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

      public static string Version();
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:

      var version = ADBMobile.Version();
      
  • KeepLifecycleSessionAlive (nur iOS)

    Gibt dem SDK gegenüber an, dass beim nächsten Fortsetzen aus der Ausführung im Hintergrund keine neue Sitzung gestartet werden soll, unabhängig vom Wert für den Lebenszyklussitzungs-Timeout in der Konfigurationsdatei.

    TIPP

    Diese Methode ist für Apps vorgesehen, die sich für Benachrichtigungen während der Ausführung im Hintergrund registrieren und die nur aus dem Code heraus aufgerufen werden sollen, der aktiv ist, während die App im Hintergrund ausgeführt wird.

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

      public static void KeepLifecycleSessionAlive();
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:

      ADBMobile.KeepLifecycleSessionAlive();
      

Analytics-Methoden

  • TrackingIdentifier

    Ruft die Analytics-Tracking-ID ab.

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

      public static string TrackingIdentifier();
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:

      var trackingId = ADBMobile.TrackingIdentifier();
      
  • TrackState

    Verfolgt einen App-Status mit optionalen Kontextdaten. Status sind die in Ihrer App verfügbaren Ansichten, z. B. "Titelbildschirm", "Level 1", "Pause". Diese Status ähneln den Seiten auf einer Website und TrackState Aufrufe inkrementieren der Seitenansichten. Wenn der Status leer ist, wird in Berichten als "App Name App Version (Build)"angezeigt. Wenn dieser Wert in Berichten auftritt, stellen Sie sicher, dass Sie in jedem TrackState aufrufen.

    TIPP

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

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

      public static void TrackState(string state, NSDictionary cdata);
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:

      NSDictionary contextData;
       contextData = NSDictionary.FromObjectAndKey (NSObject.FromObject("val"),NSObject.FromObject("key"));
        ADBMobile.TrackState("title screen", contextData);
      
  • TrackAction

    Verfolgt eine Aktion in der App. Bei Aktionen handelt es sich um die Dinge, die in Ihrer App vor sich gehen, die Sie messen möchten, z. B. "Todesfälle", "Erreichte Stufe", "Feed-Abonnements"und andere Metriken.

    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:

      public static void TrackAction(string action, NSDictionary cdata);
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:

      ADBMobile.TrackAction("level gained", null);
      
  • TrackActionFromBackground (nur iOS)

    Verfolgt eine Aktion, die im Hintergrund aufgetreten ist. Dadurch wird das Auslösen von Lebenszyklusereignissen in bestimmten Szenarien unterbunden.

    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:

      public static void TrackActionFromBackground(string action, NSDictionary cdata);
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:

      ADBMobile.TrackActionFromBackground("majorLocationChange", null);
      
  • TrackLocation

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

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

      public static void TrackLocation(CLLocation location, NSDictionary cdata);
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:

      CoreLocation.CLLocation l = new CoreLocation.CLLocation  (111.111, 44.156);
      ADBMobile.TrackLocation (l, null);
      
  • TrackBeacon

    Verfolgt das Eintreten eines Benutzers in den Radius eines Beacons.

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

      public static void TrackBeacon( CLBeacon beacon, NSDictionary cdata);
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:

      CoreLocation.CLBeacon beacon = new CoreLocation.CLBeacon ();
      ADBMobile.TrackBeacon (beacon, null);
      
  • TrackingClearCurrentBeacon

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

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

      public static void TrackingClearCurrentBeacon();
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:

      ADBMobile.TrackingClearCurrentBeacon();
      
  • TrackLifetimeValueIncrease

    Erhöht den Lebenszeitwert des Benutzers um einen Wert.

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

      public nbsp;static void TrackLifetimeValueIncrease(double amount, NSDictionary data);

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

      ADBMobile.TrackLifetimeValueIncrease(5, null);
      
  • TrackTimedActionStart

    Beginnt eine zeitgesteuerte Aktion mit einer benannten Aktion. 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:

      public static void TrackTimedActionStart(string action, NSDictionary cdata);
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:

      ADBMobile.TrackTimedActionStart("level2", null);
      
  • TrackTimedActionUpdate

    Übergibt Daten, um die Kontextdaten zu aktualisieren, die mit der angegebenen Aktion verknüpft sind. Die übergebenen Daten werden an die vorhandenen Daten für die Aktion angehängt und überschreiben die Daten, wenn der Schlüssel bereits für die Aktion definiert ist.

    TIPP

    Dieser Aufruf sendet keinen Treffer.

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

      public static void TrackTimedActionUpdate(string action, NSDictionary cdata);
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:

      NSDictionary updatedData = NSDictionary.FromObjectAndKey (NSObject.FromObject("val2"), NSObject.FromObject ("key2"));
        ADBMobile.TrackTimedActionUpdate("level2", updatedData);
      
  • TrackTimedActionEnd

    Beendet eine zeitgesteuerte Aktion.

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

      public static void TrackTimedActionEnd(string action, Func<double, double, NSMutableDictionary, sbyte> block);
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:

      ADBMobile.TrackTimedActionEnd  ("level2", (double  arg1,  double  arg2,  NSMutableDictionary  arg3)  =>  {
      return  Convert.ToSByte(true);
      });
      
  • TrackingTimedActionExists

    Gibt an, ob eine zeitgesteuerte Aktion ausgeführt wird (oder nicht).

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

      public static bool TrackingTimedActionExists(string action);
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:

      ADBMobile.TrackTimedActionEnd  ("timedAction",  (double  inAppDuration,
      double  totalDuration,  NSMutableDictionary  data)  =>  {
                   return  true;
      });
      
  • TrackingSendQueuedHits

    Erzwingt in der Bibliothek das Senden aller Zugriffe aus der Offline-Warteschlange, unabhängig von der Anzahl der Zugriffe.

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

      public static void TrackingSendQueuedHits();
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:

      ADBMobile.TrackingSendQueuedHits();
      
  • TrackingClearQueue

    Löscht alle Zugriffe aus der Offline-Warteschlange.

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

      public static void TrackingClearQueue();
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:

       ADBMobile.TrackingClearQueue();
      
  • TrackingGetQueueSize

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

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

      public static int TrackingGetQueueSize();
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:

      var queueSize = ADBMobile.TrackingGetQueueSize();
      

Experience Cloud-ID-Methoden

  • GetMarketingCloudID

    Ruft die Experience Cloud ID vom ID-Service ab.

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

      public static string GetMarketingCloudID();
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:

      var mcid = ADBMobile.GetMarketingCloudID();
      
  • VisitorSyncIdentifiers

    Mit der Experience Cloud-ID können Sie zusätzliche Kunden-IDs festlegen, die jedem Besucher zugeordnet werden. Die Besucher-API akzeptiert mehrere Kunden-IDs für denselben Besucher sowie eine Kundentypkennung, die den Umfang der einzelnen Kunden-IDs abgrenzt. Diese Methode entspricht setCustomerIDs in der JavaScript-Bibliothek.

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

      public static void VisitorSyncIdentifiers(NSDictionary identifiers);
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:

      NSDictionary  ids  =  NSDictionary.FromObjectAndKey  (NSObject.FromObject  ("value2"),  NSObject.FromObject  ("pushID"));
      ADBMobile.VisitorSyncIdentifiers(ids);
      

Target-Methoden

  • TargetLoadRequest

    Sendet Anforderungen an Ihren konfigurierten Target-Server und gibt den Zeichenfolgenwert des in einer Action<NSDictionary> Callback.

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

      public static void TargetLoadRequest (ADBTargetLocationRequest request, Action<NSString> callback);
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:

      NSDictionary  dict  =  NSDictionary.FromObjectAndKey  (NSObject.FromObject  ("value2"),  NSObject.FromObject  ("key1"));
      ADBTargetLocationRequest  req  =  ADBMobile.TargetCreateRequest  ("iOSTest",  "defGal",  dict);
      ADBMobile.TargetLoadRequest(req,    (context)  =>  {
      Console.WriteLine  (context);
      });
      
  • TargetCreateRequest

    Komfortabler Konstruktor zum Erstellen eines ADBTargetLocationRequest -Objekt mit den angegebenen Parametern.

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

      public static ADBTargetLocationRequest ADBTargetLocationRequest TargetCreateRequest (string name, string defaultContent, NSDictionary parameters);
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:

      NSDictionary  dict  =  NSDictionary.FromObjectAndKey  (NSObject.FromObject  ("value2"),  NSObject.FromObject  ("key1"));
      ADBTargetLocationRequest  req  =  ADBMobile.TargetCreateRequest  ("iOSTest",  "defGal",  dict);
      
  • TargetCreateOrderConfirmRequest

    Erstellt ein ADBTargetLocationRequest-Objekt.

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

      public static ADBTargetLocationRequest ADBTargetLocationRequest TargetCreateRequest (string name, string defaultContent, NSDictionary parameters);
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:

      ADBMobile.TargetCreateOrderConfirmRequest ("myOrder", "12345", "29.41", "cool stuff", null);
      
  • TargetClearCookies

    Löscht alle Ziel-Cookies aus der App.

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

      public static void TargetClearCookies();
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:

      ADBMobile.TargetClearCookies();
      

Audience Manager

  • AudienceVisitorProfile

    Gibt das zuletzt erfasste Besucherprofil zurück. Gibt null zurück, wenn noch kein Signal gesendet wurde. Das Besucherprofil wird gespeichert in NSUserDefaults für einfachen Zugriff über mehrere Starts Ihrer App hinweg.

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

      public static NSDictionary AudienceVisitorProfile ();
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:

      NSDictionary profile = ADBMobile.AudienceVisitorProfile();
      
  • AudienceDpid

    Gibt die aktuelle DPID zurück.

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

      public static string AudienceDpid ();
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:

      string currentDpid = ADBMobile.AudienceDpid();
      
  • AudienceDpuuid

    Gibt die aktuelle DPUUID zurück.

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

      public static string AudienceDpuuid ();
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:

      string currentDpuuid = ADBMobile.AudienceDpuuid();
      
  • AudienceSetDpidAndDpuuid

    Legt die dpid und dpuuid fest. Wenn dpid und dpuuid festgelegt sind, werden sie mit jedem Signal gesendet.

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

      public static void AudienceSetDpidAndDpuuid (NSDictionary data, Action<NSDictionary> callback);
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:

      ADBMobile.AudienceSetDpidAndDpuuid ("testDppid", "testDpuuid")
      
  • AudienceSignalWithData

    Sendet dem Zielgruppen-Management ein Signal mit Eigenschaften und ruft die passenden Segmente ab, die in einer Action<NSDictionary> Callback.

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

      public static void AudienceSignalWithData (NSDictionary data, Action<NSDictionary> callback);
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:

      NSDictionary  audienceData  =  NSDictionary.FromObjectAndKey  (NSObject.FromObject  ("value2"),  NSObject.FromObject  ("key1"));
      ADBMobile.AudienceSignalWithData  (audienceData,  (context)  =>  {
      Console.WriteLine  (context);
      });
      
  • AudienceReset

    Setzt die UUID des Zielgruppen-Managers zurück und löscht das aktuelle Besucherprofil.

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

      public static void AudienceReset ();
      
    • Hier finden Sie die Syntax für diese Methode:

      ADBMobile.AudienceReset ();
      

Video

Weitere Informationen finden Sie unter Video Analytics.

  • MediaCreateSettings

    Gibt ein ADBMediaSettings-Objekt mit den angegebenen Parametern zurück.

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

      public static ADBMediaSettings MediaCreateSettings ([string name, double length, string playerName, string playerID);
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:

      ADBMediaSettings settings = ADBMobile.MediaCreateSettings ("name1", 10, "playerName1", "playerID1");
      
  • MediaAdCreateSettings

    Gibt ein ADBMediaSettings-Objekt für die Verfolgung einer Videoanzeige zurück.

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

      public static ADBMediaSettings MediaAdCreateSettings ( string name,  double length,  string playerName,  string parentName,  string parentPod,  double parentPodPosition,  string CPM);
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:

      ADBMediaSettings adSettings = ADBMobile.MediaAdCreateSettings("adName1", 2, "playerName1", "name1", "podName1", 4, "CPM1");
      
  • MediaOpenWithSettings

    Öffnet ein ADBMediaSettings-Objekt für die Verfolgung.

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

      public static void MediaOpenWithSettings ( ADBMediaSettings settings,  Action<ADBMediaState> callback);
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:

      ADBMediaSettings settings = ADBMobile.MediaCreateSettings  ("name1",  10,  "playerName1",  "playerID1");
      ADBMobile.MediaOpenWithSettings  (settings,  (state)  =>  {
      Console.WriteLine  (state.Name);
      });
      
  • MediaClose

    Schließt das Medienelement mit dem Namen name.

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

      public static void MediaClose ( string name);
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:

      ADBMobile.MediaClose  (settings.Name);
      
  • MediaPlay

    Gibt das Medienelement mit dem Namen name mit dem Versatz offset (in Sekunden) wieder.

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

      public static void MediaPlay ( string name, double offset);
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:

      ADBMobile.MediaPlay (settings.Name, 0);
      
  • MediaComplete

    Kennzeichnet das Medienelement am angegebenen offset (in Sekunden) als abgeschlossen.

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

      public static void MediaComplete ( string name, double offset);
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:

      ADBMobile.MediaComplete (settings.Name, 5);
      
  • MediaStop

    Benachrichtigt das Medienmodul darüber, dass das Video mit dem Versatz Offset beendet oder angehalten wurde.

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

      public static void MediaStop ( string name, double offset);
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:

      ADBMobile.MediaStop (settings.Name, 3);
      
  • MediaClick

    Benachrichtigt das Medienmodul darüber, dass das Medienelement angeklickt wurde.

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

      public static void MediaClick ( string name, double offset);
      
  • MediaTrack

    Sendet einen Verfolgungsaktionsaufruf (keine Seitenansicht) für den aktuellen Medienstatus.

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

      public static void MediaTrack ( string name, NSDictionary data);
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:

       ADBMobile.MediaTrack (settings.Name, null);
      

Auf dieser Seite