Show Menu
主題×

Adobe Experience Platform Identity Service 方法

以下為 iOS 資料庫所提供的 Adobe Experience Platform Identity Service 方法。
SDK 目前可支援多個 Adobe Experience Cloud 解決方案,包括 Analytics、Target、Audience Manager 以及 Experience Cloud 訪客 ID 服務。
各方法會根據解決方案加上前置詞,因此 Experience Cloud ID 方法會加上前置詞 visitor 。如需詳細資訊,請參閱 啟用 Experience Cloud ID
  • + (nullable NSURL * )visitorAppendToURL:(nullable NSURL * )url;
    將 Adobe 訪客資料附加至 URL 字串以與 Adobe JavaScript 資料庫搭配使用。若要使用此方法,您必須有 Mobile SDK 4.12 版或更新版本。如需詳細資訊,請參閱 附加訪客 ID 協助程式功能
    此方法會造成封鎖網路呼叫。請勿在具時效性的執行緒上呼叫此方法。
    • 輸入: URL<NSURL> 要附加訪客資訊的必要 URL 字串。
    • URL<NSURL> 已附加訪客資訊的字串。
    • 以下是此方法的範例程式碼:
       NSURL *url = [NSURL URLWithString:@"https://www.example.com"];  
       NSURL *decoratedURL = [ADBMobile visitorAppendToURL: url];  
       [[UIApplication sharedApplication] openURL: decoratedURL];  
      
      
  • visitorMarketingCloudID
    從 ID 服務中擷取 Experience Cloud ID。
    • 以下是此方法的語法:
      + (NSString  *)  visitorMarketingCloudID;
      
      
    • 以下是此方法的範例程式碼:
      NSString *mcid = [ADBMobile visitorMarketingCloudID]; 
      
      
      此方法會造成封鎖網路呼叫,且​ ​應從使用者介面執行緒呼叫此方法。
  • visitorSyncIdentifiers:
    透過 Experience Cloud ID,您可以設定與每個訪客相關聯的額外客戶 ID。訪客 API 可接受同一名訪客具有多個客戶 ID,並透過客戶類型識別碼來區分不同客戶 ID 的範圍。此方法對應至 JavaScript 資料庫中的 setCustomerIDs
    • 以下是此方法的語法:
      +  (void)  visitorSyncIdentifiers:(NSDictionary  *)identifiers;
      
      
    • 以下是此方法的範例程式碼:
      [ADBMobile visitorSyncIdentifiers:@{@"idType":@"idValue"}];
      
      
  • visitorSyncIdentifiers:authenticationState:
    將提供的識別碼同步至 ID 服務。在 authState 中以下列其中一個值傳遞:
    • ADBMobileVisitorAuthenticationStateUnknown
    • ADBMobileVisitorAuthenticationStateAuthenticated
    • ADBMobileVisitorAuthenticationStateLoggedOut
    • 以下是此方法的語法:
      +  (void) visitorSyncIdentifiers:(nullable NSDictionary  *)identifiers  authenticationState:(ADBMobileVisitorAuthenticationState)authState; 
      
      
    • 以下是此方法的範例程式碼:
      [ADBMobile visitorSyncIdentifiers:@{@"myIdType":@"valueForUser"}  authenticationState:ADBMobileVisitorAuthenticationStateAuthenticated]; 
      
      
  • visitorSyncIdentifierWithType:identifier:authenticationState:
    將提供的識別碼類型和值同步至 ID 服務。在 authState 中以下列其中一個值傳遞:
    • ADBMobileVisitorAuthenticationStateUnknown
    • ADBMobileVisitorAuthenticationStateAuthenticated
    • ADBMobileVisitorAuthenticationStateLoggedOut
    • 以下是此方法的語法:
      + (void) visitorSyncIdentifierWithType:(nullable NSString *)identifierType  
      identifier:(nullable NSString *)identifier authenticationState:
      (ADBMobileVisitorAuthenticationState)authState; 
      
      
    • 以下是此方法的語法:
      [ADBMobile visitorSyncIdentifierWithType:@"myIdType" identifier:@"valueForUser"  
      authenticationState:ADBMobileVisitorAuthenticationStateLoggedOut]; 
      
      
  • visitorGetIDs
    擷取一連串唯讀 ADBVisitorID 物件。
    • 以下是此方法的語法:
      +  (nullable NSArray *) visitorGetIDs;
      
      
    • 以下是此方法的範例程式碼:
      NSArray *myVisitorIDs = [ADBMobile visitorGetIDs];
      
      
  • visitorgetUrlVariablesAsync
    4.16.0 版導入了此方法,可傳回包含訪客 ID 服務 URL 變數的適當形式字串。如需如何使用此方法的詳細資訊,請參閱 Adobe Experience Platform Identity Service 方法
    • 以下是此方法的語法:
      + (void) visitorGetUrlVariablesAsync:(nullable void (^)(NSString* __nullable urlVariables))callback;
      
      
    • 以下是此方法的範例程式碼:
      NSString *urlString = @"https://www.mydomain.com/index.php"; 
      [ADBMobile visitorGetUrlVariablesAsync:^(NSString * _Nullable urlVariables) { 
        NSString *urlStringWithVisitorData = [NSString stringWithFormat:@"%@?%@", urlString, urlVariables]; 
        // use urlStringWithVisitorData 
      }];
      
      

ADBVisitorID interface

公用方法:
- (nullable NSString *) idType; 
- (nullable NSString *) identifier; 
- (ADBMobileVisitorAuthenticationState) authenticationState; 

ADBMobileVisitorAuthenticationState enum

ADBMobileVisitorAuthenticationStateUnknown, 
ADBMobileVisitorAuthenticationStateAuthenticated, 
ADBMobileVisitorAuthenticationStateLoggedOut