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