Show Menu
TOPICS×

resetState

Esta función se ha diseñado principalmente para ayudar a los clientes de A4T a solucionar los problemas relacionados con el uso de ID en páginas o pantallas únicas, o bien en aplicaciones.

Casos de uso

Como cliente de A4T que utiliza el servicio de ID, puede que desee utilizar la función
visitor.resetState()
cuando necesite:
  • Pasar un ID de datos adicionales (SDID) o cualquier otro ID de una página o pantalla a otra mediante un redireccionamiento. Normalmente, el servicio de ID no pasará este ID sin esta función.
  • Utilizar código que solo actualice secciones específicas de una página o aplicación a través de llamadas de Ajax y desea realizar el seguimiento de esas acciones. Por ejemplo, tiene una página en la que al hacer clic en un objeto solo se carga o cambia una sección especial. En este caso, el servicio de ID no puede solicitar un ID diferente a menos que se vuelva a cargar la página. Sin embargo, con
    visitor.resetState()
    , puede solicitar un nuevo ID con estas condiciones.
Consulte los ejemplos de código que aparecen a continuación.

Sintaxis

Sintaxis:
visitor.resetState( *
state
*);

Ejemplos de código

Su implementación del servicio de ID influye en cómo utilizaría esta función. Consulte la tabla siguiente para obtener ejemplos.
Implementación del lado del servidor
Una implementación del lado del servidor va dirigida a los clientes de A4T con implementaciones mixtas del lado del servidor y del cliente de Target, Analytics y el servicio de ID. Si ha configurado el servicio de ID con este método, todo lo que debe hacer es agregar
visitor.resetState()
a la página. Las llamadas al servicio de ID devolverán un nuevo estado de servidor e ID inmediatamente.
Implementación no estándar
(con ID)
Si ha configurado el servicio de ID con una implementación no estándar , debe configurar un objeto de variable para mantener el SDID (u otros ID) que desee pasar con
visitor.resetState()
. Como se muestra a continuación, esto incluiría su ID de organización y el ID que desea pasar. Su código podría ser similar al del siguiente ejemplo.
//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);
Implementación no estándar
(sin pasar un ID)
En este caso, se puede utilizar
visitor.resetState()
para generar un nuevo ID. Esto puede ser útil en una aplicación de una sola página cuando un usuario navega a una nueva pantalla sin actualizar la página y necesita un nuevo ID.
//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
Administrador dinámico de etiquetas (DTM)
Actualmente, no hay ninguna ruta de configuración de DTM para
visitor.resetState()
.