resetState

Cette fonction s’adresse principalement aux utilisateurs d’A4T, pour les aider à résoudre des problèmes liés à l’utilisation d’identifiants sur des sites, écrans ou applications d’une seule page.

Cas d’utilisation

En tant que client d’A4T utilisant le service d’ID, vous pouvez utiliser la fonction visitor.resetState() lorsque vous devez :

  • Pour transmettre un SDID (Supplemental Data ID), ou tout autre ID, d’une page ou d’un écran à l’autre par le biais d’une redirection. Normalement, le service d’ID ne transmet pas cet identifiant sans cette fonction.
  • Utilisez du code qui met uniquement à jour des sections spécifiques d’une page ou d’une application via des appels Ajax et vous souhaitez effectuer le suivi de ces actions. Supposons, par exemple, que vous ayez une page sur laquelle le fait de cliquer sur un objet charge ou modifie uniquement une section spéciale. Dans ce cas, le service d’ID ne peut pas demander un autre ID, sauf si la page est rechargée. Cependant, avec visitor.resetState(), vous pouvez demander un nouvel ID.

Voir les exemples de code ci-dessous.

Syntaxe

Syntaxe : visitor.resetState( *état*);

Exemples de code

La mise en oeuvre de votre service d’ID affecte votre manière d’utiliser cette fonction. Consultez le tableau ci-dessous pour obtenir des exemples.

Mise en œuvre côté serveur

Une mise en œuvre côté serveur concerne les clients d’A4T disposant d’un serveur mixte, des mises en œuvre de Target et d’Analytics côté client et du service d’ID. Si vous avez configuré le service d’ID avec cette méthode, il ne vous reste plus qu’à ajouter visitor.resetState() à la page. Les appels au service d’ID renvoient automatiquement un nouvel ID et un nouvel état du serveur.

Mise en œuvre non standard (avec ID)

Si vous avez configuré le service d’ID avec une mise en œuvre non standard, vous devez configurer un objet variable pour contenir le SDID (ou les autres ID) que vous souhaitez transmettre avec visitor.resetState(). Comme indiqué ci-dessous, cela inclut votre ID d’organisation et l’ID que vous souhaitez transmettre. Voici à quoi pourrait ressembler votre code.

//Instantiate server state variable 
var serverState = { 
     "Insert Experience Cloud organization ID here": { 
          //Specify the SDID or other ID 
          supplementalDataIDCurrent: "1234", 
          supplementalDataIDCurrentConsumed: { 
               "payload:top-center": false 
          } 
     } 
}; 
 
//Instantiate ID service 
var visitor = Visitor.getInstance ("Insert Experience Cloud organization ID here", { 
     ... 
}); 
 
//Reset server state to pass the SDID 
visitor.resetState(serverState);

Mise en œuvre non standard (sans transmission d’un ID)

Dans ce cas, vous pouvez utiliser visitor.resetState() pour générer un nouvel ID. Cela peut s’avérer utile dans une application d’une seule page lorsqu’un utilisateur accède à un nouvel écran sans actualiser la page et que vous avez besoin d’un nouvel identifiant.

 
//Instantiate ID service 
var visitor = Visitor.getInstance ("Insert Experience Cloud organization ID here", { 
     ... 
}); 
 
//Request a supplemental Data ID for consumer1 and consumer2: 
var sdid1 = visitor.getSupplementalDataID("consumer1"); // sdid1: 1234 
var sdid2 = visitor.getSupplementalDataID("consumer2"); // sdid2: 1234 
 
//User navigates to a new screen in a single-page app, without refreshing the page. 
//To reset the Supplemental Data ID internal, call resetState without passing any parameters. 
//This way we will not be recycling the `1234` ID anymore. Instead Visitor will generate a new supplemental Data ID going forward. 
visitor.resetState(); 
 
//Request a supplemental Data ID for consumer3 and consumer4: 
var sdid1 = visitor.getSupplementalDataID("consumer3"); // sdid1: 5678 
 
var sdid2 = visitor.getSupplementalDataID("consumer4"); // sdid2: 5678

Gestionnaire dynamique de balises

À l’heure actuelle, il n’existe pas de parcours de configuration de DTM pour visitor.resetState().

Sur cette page

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now