Méthodes du service d’Experience Cloud ID

Vous trouverez ci-après les méthodes du service d’Experience Cloud ID fournies par la bibliothèque iOS.

Le SDK prend actuellement en charge plusieurs solutions Adobe Experience Cloud, notamment Analytics, Target, Audience Manager, ainsi que le service d’identification des visiteurs d’Experience Cloud.

Un préfixe est attribué aux méthodes selon la solution. Les méthodes d’identification d’Experience Cloud sont précédées du préfixe visitor. Pour plus d’informations, voir Activation de l’Experience Cloud ID.

Méthode Description
+ (nullable NSURL *) visitorAppendToURL: (nullable NSURL *) url;

Ajoute les données du visiteur Adobe à une chaîne d’URL en vue d’une utilisation dans la bibliothèque JavaScript Adobe. Pour utiliser cette méthode, il vous faut le SDK mobile 4.12+. Pour plus d’informations, voir l’article portant sur la fonction d’ajout d’un identifiant visiteur.

Important : Cette méthode peut entraîner un appel de blocage réseau. Ne l’utilisez pas sur les fils sensibles au facteur temps.
  • Entrée : URL<NSURL>

    Chaîne URL à laquelle les données du visiteur seront ajoutées.

  • Sortie : URL<NSURL>

    Chaîne à laquelle les données du visiteur ont été ajoutées.

Exemple :

NSURL *url = [NSURL URLWithString:@"http://www.example.com"]; 
NSURL *decoratedURL = [ADBMobile visitorAppendToURL: url]; 
[[UIApplication sharedApplication] openURL: decoratedURL]; 
visitorMarketingCloudID

Récupère l’Experience Cloud ID du service d’identification.

Syntaxe :

+ (NSString *) visitorMarketingCloudID;

Exemple :

NSString *mcid = [ADBMobile visitorMarketingCloudID];
Important : Cette méthode peut provoquer un appel réseau bloquant et ne doit pas être appelée depuis un fil d’interface utilisateur.

visitorSyncIdentifiers:

Avec l’Experience Cloud ID, vous pouvez définir des identifiants de client supplémentaires pouvant être associés à chaque visiteur. L’API visiteur accepte plusieurs identifiants de client pour le même visiteur, ainsi qu’un identifiant de type Client, afin de séparer la portée des différents identifiants de client. Cette méthode correspond aux identifiants setCustomerIDs dans la bibliothèque JavaScript.

Syntaxe :

+ (void) visitorSyncIdentifiers:(NSDictionary *)identifiers;

Exemple :

[ADBMobile visitorSyncIdentifiers:@{@"idType":@"idValue"}];

visitorSyncIdentifiers:authenticationState:

Synchronise les identifiants fournis au service d’identification. Transmet l’attribut authState par l’intermédiaire de l’une des valeurs suivantes :

  • ADBMobileVisitorAuthenticationStateUnknown
  • ADBMobileVisitorAuthenticationStateAuthenticated
  • ADBMobileVisitorAuthenticationStateLoggedOut

Syntaxe :

+ (void) visitorSyncIdentifiers:(nullable NSDictionary *)identifiers authenticationState:(ADBMobileVisitorAuthenticationState)authState;

Exemple :

[ADBMobile visitorSyncIdentifiers:@{@"myIdType":@"valueForUser"} authenticationState:ADBMobileVisitorAuthenticationStateAuthenticated];

visitorSyncIdentifierWithType:identifier:authenticationState:

Synchronise le type d’identifiant et la valeur fournis au service d’identification. Transmet l’attribut authState par l’intermédiaire de l’une des valeurs suivantes :

  • ADBMobileVisitorAuthenticationStateUnknown
  • ADBMobileVisitorAuthenticationStateAuthenticated
  • ADBMobileVisitorAuthenticationStateLoggedOut

Syntaxe :

+ (void) visitorSyncIdentifierWithType:(nullable NSString *)identifierType identifier:(nullable NSString *)identifier authenticationState:(ADBMobileVisitorAuthenticationState)authState;

Exemple :

[ADBMobile visitorSyncIdentifierWithType:@"myIdType" identifier:@"valueForUser" authenticationState:ADBMobileVisitorAuthenticationStateLoggedOut];

visitorGetIDs

Récupère une matrice d’objets ADBVisitorID en lecture seule.

Syntaxe :

+ (nullable NSArray *) visitorGetIDs;

Exemple :

NSArray *myVisitorIDs = [ADBMobile visitorGetIDs];

ADBVisitorID interface

Méthodes publiques :

- (nullable NSString *) idType;
- (nullable NSString *) identifier;
- (ADBMobileVisitorAuthenticationState) authenticationState;

ADBMobileVisitorAuthenticationState enum

ADBMobileVisitorAuthenticationStateUnknown,
ADBMobileVisitorAuthenticationStateAuthenticated,
ADBMobileVisitorAuthenticationStateLoggedOut