resetState resetstate

Den här funktionen är främst avsedd för A4T-kunder för att hjälpa till att lösa problem som rör arbete med ID:n på enstaka sidor/skärmar eller appar.

Användningsfall section-840b88a5cdb042488b340cad5d7b22a5

Som A4T-kund som använder ID-tjänsten kan du använda funktionen visitor.resetState() när du behöver:

  • Om du vill skicka ett SDID (Additional Data ID), eller något annat ID, från en sida eller skärm till en annan via en omdirigering. I vanliga fall skickas inte ID-tjänsten detta ID utan den här funktionen.
  • Använd kod som bara uppdaterar specifika avsnitt på en sida eller i en app via Ajax-anrop och du vill spåra dessa åtgärder. Anta att du har en sida där klickning på ett objekt bara laddar eller ändrar ett speciellt avsnitt. I det här fallet kan ID-tjänsten inte begära ett annat ID om inte sidan läses in igen. Med visitor.resetState() kan du dock begära ett nytt ID under dessa villkor.

Se kodexemplen nedan.

Syntax section-9e63503e178f4be28ac850abf44d6d91

Syntax: visitor.resetState( *state*);

Kodexempel section-d75b211bb4ea473887eb284de2ad838b

Implementeringen av din ID-tjänst påverkar hur du använder funktionen. Se tabellen nedan för exempel.

Implementering på serversidan

En implementering på serversidan är för A4T-kunder med blandade implementeringar på server- och klientsidan av Target, Analytics och ID-tjänsten. Om du har konfigurerat ID-tjänsten med den här metoden behöver du bara lägga till visitor.resetState() på sidan. Anrop till ID-tjänsten returnerar automatiskt ett nytt ID och servertillstånd.

Icke-standardimplementering (med ID)

Om du har konfigurerat ID-tjänsten med en icke-standardimplementering måste du konfigurera ett variabelobjekt så att det innehåller det SDID (eller andra ID) som du vill skicka med visitor.resetState(). Som framgår nedan inkluderar detta ditt organisations-ID och det ID som du vill skicka. Koden kan se ut ungefär som i följande exempel.

//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);

Icke-standardimplementering (utan att skicka ett ID)

I det här fallet kan visitor.resetState() användas för att generera ett nytt ID. Detta kan vara användbart i ett enkelsidigt program när en användare navigerar till en ny skärm utan att uppdatera sidan och du behöver ett nytt 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

Dynamic Tag Manager (DTM)

Det finns för närvarande ingen DTM-konfigurationssökväg för visitor.resetState().

recommendation-more-help
9c9e8ca9-9f7e-42c9-a5d5-a0d82776362a