Identity-Dienst-Methoden für Adobe Experience Platform

Hier finden Sie die Identity-Dienst-Methoden für Adobe Experience Platform, 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 des Experience Cloud-Besucher-ID-Service.

Methoden erhalten je nach Lösung unterschiedliche Präfixe. Experience Cloud ID-Methoden erhalten beispielsweise das Präfix visitor. Weitere Informationen finden Sie im Thema über das Aktivieren der Experience Cloud ID.

  • +(nullable NSURL *)visitorAppendToURL:(nullable NSURL *)url;

    Hängt die Adobe-Besucherdaten an eine URL-Zeichenfolge zur Verwendung mit der Adobe-JavaScript-Bibliothek an. Zum Verwenden dieser Methode müssen Sie über Mobile SDK-Version 4.12 oder höher verfügen. Weitere Informationen finden Sie unter Hilfefunktion zum Anhängen der Besucher-ID.

    WICHTIG

    Diese Methode kann einen blockierenden Netzwerkaufruf verursachen. Rufen Sie diese Methode nicht in zeitkritischen Threads auf.

    • Eingabe: URL<NSURL>
      Eine erforderliche URL-Zeichenfolge, an die die Besucherinformationen angehängt werden.

    • URL<NSURL>
      Zeichenfolge mit angehängten Besucherinformationen.

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

       NSURL *url = [NSURL URLWithString:@"https://www.example.com"];  
       NSURL *decoratedURL = [ADBMobile visitorAppendToURL: url];  
       [[UIApplication sharedApplication] openURL: decoratedURL];  
      
  • visitorMarketingCloudID

    Ruft die Experience Cloud ID vom ID-Service ab.

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

      + (NSString  *)  visitorMarketingCloudID;
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:

      NSString *mcid = [ADBMobile visitorMarketingCloudID]; 
      
      WICHTIG

      Diese Methode kann zu einem blockierenden Netzwerkaufruf führen und sollte NICHT über einen UI-Thread aufgerufen werden.

  • visitorSyncIdentifiers:

    Mit der Experience Cloud ID können Sie zusätzliche Kunden-IDs festlegen, die jedem Besucher zugeordnet werden können. 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:

      +  (void)  visitorSyncIdentifiers:(NSDictionary  *)identifiers;
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:

      [ADBMobile visitorSyncIdentifiers:@{@"idType":@"idValue"}];
      
  • visitorSyncIdentifiers:authenticationState:

    Synchronisiert die bereitgestellten IDs mit dem ID-Service. Übergeben Sie authState als einen der folgenden Werte:

    • ADBMobileVisitorAuthenticationStateUnknown

    • ADBMobileVisitorAuthenticationStateAuthenticated

    • ADBMobileVisitorAuthenticationStateLoggedOut

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

      +  (void) visitorSyncIdentifiers:(nullable NSDictionary  *)identifiers  authenticationState:(ADBMobileVisitorAuthenticationState)authState; 
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:

      [ADBMobile visitorSyncIdentifiers:@{@"myIdType":@"valueForUser"}  authenticationState:ADBMobileVisitorAuthenticationStateAuthenticated]; 
      
  • visitorSyncIdentifierWithType:identifier:authenticationState:

    Synchronisiert den bereitgestellten ID-Typ und -Wert mit dem ID-Service. Übergeben Sie authState als einen der folgenden Werte:

    • ADBMobileVisitorAuthenticationStateUnknown

    • ADBMobileVisitorAuthenticationStateAuthenticated

    • ADBMobileVisitorAuthenticationStateLoggedOut

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

      + (void) visitorSyncIdentifierWithType:(nullable NSString *)identifierType  
      identifier:(nullable NSString *)identifier authenticationState:
      (ADBMobileVisitorAuthenticationState)authState; 
      
    • Hier finden Sie die Syntax für diese Methode:

      [ADBMobile visitorSyncIdentifierWithType:@"myIdType" identifier:@"valueForUser"  
      authenticationState:ADBMobileVisitorAuthenticationStateLoggedOut]; 
      
  • visitorGetIDs

    Ruft ein Array schreibgeschützter ADBVisitorID-Objekte ab.

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

      +  (nullable NSArray *) visitorGetIDs;
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:

      NSArray *myVisitorIDs = [ADBMobile visitorGetIDs];
      
  • visitorgetUrlVariablesAsync

    Diese in Version 4.16.0 eingeführte Methode gibt eine entsprechend geformte Zeichenfolge zurück, die URL-Variablen des Besucher-ID-Dienst enthält. Weitere Informationen zur Verwendung dieser Methode finden Sie unter Identity-Dienst-Methoden für Adobe Experience Platform.

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

      + (void) visitorGetUrlVariablesAsync:(nullable void (^)(NSString* __nullable urlVariables))callback;
      
    • Hier finden Sie ein Code-Beispiel für diese Methode:

      NSString *urlString = @"https://www.mydomain.com/index.php"; 
      [ADBMobile visitorGetUrlVariablesAsync:^(NSString * _Nullable urlVariables) { 
        NSString *urlStringWithVisitorData = [NSString stringWithFormat:@"%@?%@", urlString, urlVariables]; 
        // use urlStringWithVisitorData 
      }];
      

ADBVisitorID-Schnittstelle

Öffentliche Methoden:

- (nullable NSString *) idType; 
- (nullable NSString *) identifier; 
- (ADBMobileVisitorAuthenticationState) authenticationState; 

ADBMobileVisitorAuthenticationState enum

ADBMobileVisitorAuthenticationStateUnknown, 
ADBMobileVisitorAuthenticationStateAuthenticated, 
ADBMobileVisitorAuthenticationStateLoggedOut

Auf dieser Seite

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free