主题×
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