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

本頁內容