resetState resetstate
Questa funzione è stata progettata in particolare per aiutare i clienti A4T a risolvere problemi relativi all’utilizzo degli ID su app oppure siti/schermate a pagina singola.
Casi d’uso section-840b88a5cdb042488b340cad5d7b22a5
In qualità di cliente A4T che utilizza il servizio ID visitatore, potresti voler utilizzare la funzione visitor.resetState() quando devi:
- Trasmettere un Supplemental Data ID (SDID) o qualsiasi altro ID da una pagina o una schermata a un’altra mediante un rendirizzamento. Normalmente, il Servizio ID visitatore non passa questo ID senza questa funzione.
- Usare il codice che aggiorna esclusivamente sezioni specifiche di una pagina o di un’app mediante chiamate Ajax e vuoi tenere traccia di quelle azioni. Ad esempio, supponiamo che tu abbia una pagina in cui solo facendo clic su un oggetto si carica o si modifica una sezione speciale. In questo caso, il Servizio ID visitatore non può richiedere un ID diverso a meno che la pagina non venga ricaricata. Tuttavia, con
visitor.resetState(), puoi richiedere un nuovo ID nel rispetto di queste condizioni.
Vedi gli esempi di codice seguenti.
Sintassi section-9e63503e178f4be28ac850abf44d6d91
Sintassi: visitor.resetState( *stato*);
Esempi di codice section-d75b211bb4ea473887eb284de2ad838b
L’implementazione del servizio ID visitatore influisce su come utilizzeresti questa funzione. Per alcuni esempi, consulta la tabella seguente.
Implementazione lato server
L’implementazione lato server è rivolta ai clienti A4T con implementazioni miste lato server e client di Target, Analytics e del servizio ID visitatori. Se hai impostato il servizio ID visitatori con questo metodo non dovrai fare altro che aggiungere visitor.resetState() alla pagina. Le chiamate al servizio ID visitatore restituiranno automaticamente un nuovo ID e lo stato del server.
Implementazione non standard (con ID)
Se hai impostato il servizio ID visitatori con un implementazione non standard, devi configurare un oggetto variabile per contenere l’SDID (o altri ID) che desideri trasmettere con visitor.resetState(). Come mostrato di seguito, questo includerebbe il tuo ID organizzazione IMS e l’ID che desideri trasmettere. Il codice sarà simile all’esempio di seguito.
//Instantiate server state variable
var serverState = {
"INSERT-IMS-ORG-ID-HERE": {
//Specify the SDID or other ID
supplementalDataIDCurrent: "1234",
supplementalDataIDCurrentConsumed: {
"payload:top-center": false
}
}
};
//Instantiate Visitor ID Service
var visitor = Visitor.getInstance ("INSERT-IMS-ORG-ID-HERE", {
...
});
//Reset server state to pass the SDID
visitor.resetState(serverState);
Implementazione non standard (senza trasmissione di un ID)
In questo caso, visitor.resetState() può essere usato per generare un nuovo ID. Questo può essere utile in un’app a pagina singola quando un utente passa a una nuova schermata senza aggiornare la pagina e hai bisogno di un nuovo ID.
//Instantiate Visitor ID Service
var visitor = Visitor.getInstance ("INSERT-IMS-ORG-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