Show Menu
TOPICS×

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

Como um cliente A4T que usa o serviço de ID, você pode desejar usar a função
visitor.resetState()
quando precisar:
  • Passar uma ID de dados suplementares (SDID) ou qualquer outra ID de uma página ou tela para outra por um redirecionamento. Em geral, o serviço de ID não passará essa ID sem essa função.
  • Use o código que atualiza somente seções específicas de uma página ou um aplicativo por chamadas do Ajax e você deseja rastrear essas ações. Por exemplo, considere que há uma página em que clicar em um objeto carrega ou altera apenas uma seção especial. Nesse caso, o serviço de ID não pode solicitar uma ID diferente exceto quando a página é recarregada. Entretanto, com
    visitor.resetState()
    , você pode solicitar uma nova ID sob essas condições.
Consulte as amostras de código abaixo.

Sintaxe

Sintaxe:
visitor.resetState( *
status
*);

Amostras de código

A implementação do serviço de ID afeta como você usaria essa função. Consulte a tabela abaixo para obter mais 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ê precisar 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()
.