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 接口

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

ADBMobileVisitorAuthenticationState 枚举

ADBMobileVisitorAuthenticationStateUnknown, 
ADBMobileVisitorAuthenticationStateAuthenticated, 
ADBMobileVisitorAuthenticationStateLoggedOut