resetState resetstate
Essa função foi projetada principalmente para clientes do A4T e tem como objetivo ajudar a solucionar problemas que podem surgir ao trabalhar com IDs em sites/telas ou aplicativos de uma única página.
Casos de uso section-840b88a5cdb042488b340cad5d7b22a5
Como um cliente A4T que usa o serviço de ID, você pode desejar usar a função visitor.resetState() quando precisar:
- Para passar uma ID de dados complementares (SDID) ou qualquer outra ID de uma página ou tela para outra por meio de um redirecionamento. Normalmente, o serviço de ID não passa essa ID sem essa função.
- Use o código que atualiza apenas seções específicas de uma página ou aplicativo por meio de chamadas Ajax para rastrear essas ações. Por exemplo, digamos que você tenha uma página em que clicar em um objeto apenas carrega ou altera uma seção especial. Nesse caso, o serviço de ID não pode solicitar uma ID diferente, a menos que a página seja recarregada. Entretanto, com
visitor.resetState(), você pode solicitar uma nova ID sob essas condições.
Consulte as amostras de código abaixo.
Sintaxe section-9e63503e178f4be28ac850abf44d6d91
Sintaxe: visitor.resetState( *status*);
Amostras de código section-d75b211bb4ea473887eb284de2ad838b
A implementação do serviço de ID afeta como você usaria essa função. Consulte a tabela abaixo para obter exemplos.
Implementação do lado do servidor
Uma implementação do lado do servidor é para clientes da A4T com implementações mistas do lado do servidor e do lado do cliente para o Target, o Analytics e o serviço de ID. Se você configurou o serviço de ID com esse método, é necessário adicionar visitor.resetState() à página. As chamadas para o serviço de ID retornam uma nova ID e o estado do servidor automaticamente.
Implementação não padrão (com ID)
Se você configurou o serviço de ID com uma implementação não padrão, é necessário configurar um objeto de variável para manter a SDID (ou outras IDs) que você deseja passar com visitor.resetState(). Como mostrado abaixo, isso incluiria a ID da organização e a ID que você deseja passar. O código pode ser semelhante ao seguinte exemplo.
//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);
Implementação não padrão (sem passar uma ID)
Nesse caso, visitor.resetState() pode ser usada para gerar uma nova ID. Isso pode ser útil em um aplicativo de página única quando um usuário navega para uma nova tela sem atualizar a página e você precisa de uma nova 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
Gerenciador dinâmico de tags (DTM)
No momento, não há um caminho de configuração do DTM para visitor.resetState().