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 de visitante, 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 de visitante 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 de visitante 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 do visitante 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 do visitante. Se você configurou o Serviço de ID de visitante com este método, é necessário adicionar visitor.resetState() à página. As chamadas ao Serviço de ID do visitante retornarão 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 de visitante 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 sua ID da Organização IMS e a ID que você deseja passar. O código pode ser semelhante ao seguinte exemplo.
//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);
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 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