Show Menu
THEMEN×

Konfigurationsmethoden

Hier finden Sie eine Liste der 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.
  • setAppExtensionType
    Konfiguriert die Adobe Mobile-SDK-Einstellung, um zu bestimmen, welcher Erweiterungstyp aktuell ausgeführt wird.
    Die folgenden Werte sind zulässig:
    • ADBMobileAppExtensionTypeRegular : Erweiterung wird mit einer übergeordneten App gepackt.
    • ADBMobileAppExtensionTypeStandAlone : Erweiterung wird nicht mit einer übergeordneten App gepackt.
    Diese Methode sollte nur verwendet werden, wenn Ihre App eine Erweiterung oder eine eigenständige Erweiterung aufweist. Weitere Informationen finden Sie unten unter ADBMobileAppExtensionType .
    • Hier finden Sie die Syntax für diese Methode:
      + (void) setAppExtensionType:(ADBMobileAppExtensionType)type;
      
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:
      [ADBMobile setAppExtensionType:ADBMobileAppExtensionTypeStandAlone]; 
      
      
  • version
    Gibt die aktuelle Version der Adobe Mobile-Bibliothek zurück.
    • Hier finden Sie die Syntax für diese Methode:
      +(NSString*) version;
      
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:
      NSString*libraryVersion = [ADBMobileversion];
      
      
  • privacyStatus
    Gibt die Enum-Darstellung für den Datenschutzstatus des aktuellen Benutzers zurück:
    • ADBMobilePrivacyStatusOptIn : Treffer werden umgehend gesendet.
    • ADBMobilePrivacyStatusOptOut - werden Treffer verworfen.
    • ADBMobilePrivacyStatusUnknown : 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. Der Standardwert wird in der Datei ADBMobileConfig.json festgelegt.
    • Hier finden Sie die Syntax für diese Methode:
      + (ADBMobilePrivacyStatus) privacyStatus;
      
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:
      ADBMobilePrivacyStatus privacyStatus = [ADBMobileprivacyStatus];
      
      
  • setPrivacyStatus
    Legt für den aktuellen Benutzer den Datenschutzstatus status fest.
    Die folgenden Werte sind zulässig:
    • ADBMobilePrivacyStatusOptIn : Treffer werden umgehend gesendet.
    • ADBMobilePrivacyStatusOptOut - werden Treffer verworfen.
    • ADBMobilePrivacyStatusUnknown : 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:
      + (void) setPrivacyStatus:(ADBMobilePrivacyStatus)status;
      
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:
      [ADBMobile setPrivacyStatus:ADBMobilePrivacyStatusOptIn];
      
      
  • lifetimeValue
    Gibt den Lebenszeitwert für den aktuellen Benutzer zurück. Der Standardwert lautet  0 .
    • Hier finden Sie die Syntax für diese Methode:
      + (NSDecimalNumber *) lifetimeValue;
      
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:
      NSDecimalNumber *lifeValue = [ADBMobile lifetimeValue];
      
      
  • trackingIdentifier
    Gibt die automatisch generierte Besucher-ID zurück. Hierbei handelt es sich um eine App-spezifische Unique Visitor-ID, die von den Adobe-Servern generiert wird. Wenn die Adobe-Server zum Zeitpunkt der Generierung nicht erreicht werden können, wird die ID mithilfe der CFUUID von Apple generiert. Der Wert wird beim ersten Start generiert, dann gespeichert und von diesem Zeitpunkt an verwendet. Diese ID wird zwischen App-Upgrades beibehalten. Sie wird gespeichert und während des Standardanwendungs-Backup-Vorgangs wiederhergestellt und bei der Deinstallation entfernt.
    Wenn für Ihre App ein Upgrade vom Experience Cloud-SDK 3.x auf 4.x vorgenommen wird, wird die vorherige benutzerdefinierte oder automatisch generierte Besucher-ID abgerufen und als die benutzerdefinierte Benutzer-ID gespeichert. Weitere Informationen finden Sie unten in der Zeile userIdentifier . Dadurch werden Besucherdaten zwischen SDK-Upgrades beibehalten. Für neue Installationen für das SDK der Version 4.x lautet die Benutzer-ID nil und die Tracking-ID wird verwendet.
    • Hier finden Sie die Syntax für diese Methode:
      + (NSString *) trackingIdentifier;
      
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:
      NSString *tid = [ADBMobile trackingIdentifier];
      
      
  • userIdentifier
    Wurde eine benutzerdefinierte ID festgelegt, wird die Benutzer-ID zurückgegeben. Wird keine benutzerdefinierte ID festgelegt, wird der Wert nil zurückgegeben. Der Standardwert lautet  nil .
    Wenn für Ihre App ein Upgrade vom Experience Cloud-SDK 3.x auf 4.x vorgenommen wird, wird die vorherige benutzerdefinierte oder automatisch generierte Besucher-ID abgerufen und als die benutzerdefinierte Benutzer-ID gespeichert. Dadurch werden Besucherdaten zwischen SDK-Upgrades beibehalten.
    Bei neuen Installationen der SDK-Version 4.x lautet die Benutzer-ID nil , bis sie festgelegt wird.
    • Hier finden Sie die Syntax für diese Methode:
      +(NSString *) userIdentifier;
      
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:
      NSString *uid = [ADBMobileuserIdentifier];
      
      
  • setUserIdentifier
    Legt die Benutzerkennung auf identifier fest.
    • Hier finden Sie die Syntax für diese Methode:
      +(void)setUserIdentifier:(NSString*)identifier;
      
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:
      [ADBMobile setUserIdentifier:@"billybob"]; 
      
      
  • debugLogging
    Gibt die aktuelle Vorgabe für die Debug-Protokollierung zurück. Der Standardwert lautet  NO .
    • Hier finden Sie die Syntax für diese Methode:
      + (BOOL) debugLogging;
      
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:
      BOOL debugging = [ADBMobile debugLogging];
      
      
  • setDebugLogging
    Legt die Debug-Protokollierungseinstellung auf debug fest.
    • Hier finden Sie die Syntax für diese Methode:
      + (void) setDebugLogging:(BOOL)debug;
      
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:
      [ADBMobile setDebugLogging:YES];
      
      
  • keepLifecycleSessionAlive
    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.
    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, wenn die App im Hintergrund ausgeführt wird.
    • Hier finden Sie die Syntax für diese Methode:
      + (void) keepLifecycleSessionAlive;
      
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:
      [ADBMobile keepLifecycleSessionAlive]; 
      
      
  • 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 .
    Der bevorzugte Speicherort zum Abrufen dieser Methode lautet application:didFinishLaunchingWithOptions: .
    • Hier finden Sie die Syntax für diese Methode:
      + (void) collectLifecycleData;
      
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:
      [ADBMobile collectLifecycleData];
      
      
  • collectLifecycleDataWithAdditionalData:
    Ermöglicht Ihnen die Weitergabe zusätzlicher Daten beim Erfassen von Lebenszyklusmetriken.
    Diese Methode muss vom Einstiegspunkt Ihrer App aufgerufen werden. Dies umfasst ggf. eine oder beide der Methoden application:didFinishLaunchingWithOptions: bzw. applicationWillEnterForeground: in Ihrer Klasse „AppDelegate“.
    Daten, die über collectLifecycleDataWithAdditionalData: an das SDK weitergeleitet werden, bestehen unter NSUserDefaults im SDK fort. Das SDK entfernt die Werte im Parameter NSDictionary , die nicht vom Typ NSString oder NSNumber sind. Um collectLifecycleDataWithAdditionalData: zu nutzen, ist SDK- Version 4.4 oder höher erforderlich.
    • Hier finden Sie die Syntax für diese Methode:
      + (void) collectLifecycleDataWithAdditionalData:(nullableNSDictionary*)data; 
      
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:
      [ADBMobile collectLifecycleDataWithAdditionalData:@{@"entryType":@"appShortcutIcon"}]; 
      
      
  • overrideConfigPath
    Sie können beim Starten der Anwendung eine andere ADBMobile JSON-Konfigurationsdatei laden. Die andere Konfiguration wird verwendet, bis die Anwendung geschlossen wird.
    Um overrideConfigPath zu nutzen, ist SDK-Version 4.2 oder höher erforderlich.
    • Hier finden Sie die Syntax für diese Methode:
       + (void) overrideConfigPath: (nullableNSString *) path;
      
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:
      NSString *filePath = [[NSBundle mainBundle] pathForResource:@"ExampleJSONFile" ofType:@"json"]; 
      [ADBMobile overrideConfigPath:filePath];
      
      
  • setPushIdentifier
    Legt das Geräte-Token für Push-Benachrichtigungen fest.
    Dieses Verfahren kann nur in der Methode application:didRegisterForRemoteNotificationsWithDeviceToken: verwendet werden.
    • Hier finden Sie die Syntax für diese Methode:
      + (void) setPushIdentifier:(NSData *)deviceToken;
      
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:
      - (void) application:(UIApplication *) application  didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken { 
      [ADBMobile setPushIdentifier:deviceToken];  
      }
      
      
  • setAdvertisingIdentifier
    Legt den IDFA im SDK fest. Wurde der IDFA im SDK eingerichtet, wird er im Lebenszyklus übermittelt. Auf ihn kann auch in Signalen (Postbacks) zugegriffen werden.
    Rufen Sie den IDFA nur dann aus den Apple-APIs ab, wenn Sie einen Dienst für Werbeanzeigen verwenden. Wenn Sie den IDFA abrufen und ihn nicht richtig verwenden, wird Ihre App ggf. abgelehnt.
    • Hier finden Sie die Syntax für diese Methode:
      +(void) setAdvertisingIdentifier:(NSString*)identifier;
      
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:
      NSString *idfa = [[[ASIdentifierManager sharedManager]advertisingIdentifier] UUIDString]; 
      [ADBMobile setAdvertisingIdentifier:idfa]; 
      
      

ADBMobileAppExtensionType enum

/** 
 * @brief An enum type. 
 * The possible types of app extension you might use 
 * @see setAppExtensionType 
 */ 
typedef NS_ENUM(NSUInteger, ADBMobileAppExtensionType) { 
    ADBMobileAppExtensionTypeRegular = 0, /*!< Enum value ADBMobileAppExtensionTypeRegular. */ 
    ADBMobileAppExtensionTypeStandAlone = 1 /*!< Enum value ADBMobileAppExtensionTypeStandAlone. */ 
};