resetState resetstate
この機能は、単一ページのサイト／画面またはアプリでの ID の使用に関連する問題を解決するために、主に A4T のお客様向けに設計されています。
ユースケース section-840b88a5cdb042488b340cad5d7b22a5
ID サービスを利用している A4T のお客様の場合、以下をおこなう必要があるときには visitor.resetState() 関数を使用することが推奨されます。
- リダイレクトを使用して、補助的なデータ ID（SDID）またはその他の任意の ID を 1 つのページまたは画面から別のページに渡す。 通常、この関数がなければ、ID サービスはこの ID を渡しません。
- Ajax 呼び出しを通じてページまたはアプリの特定のセクションのみを更新するコードを使用し、それらのアクションを追跡する必要がある。 例えば、オブジェクトをクリックすると、特別なセクションのみが読み込まれたり変更されたりするページがあるとします。 この場合、ID サービスは、ページが再読み込みされない限り、別の ID をリクエストできません。 しかし、
visitor.resetState()を使用すると、この条件でも新しい ID をリクエストできます。
以下のコードサンプルを参照してください。
構文 section-9e63503e178f4be28ac850abf44d6d91
構文： visitor.resetState( *state*);
コードサンプル section-d75b211bb4ea473887eb284de2ad838b
ID サービスの実装によって、この関数の使用方法が変わります。 例については、以下の表を参照してください。
サーバー側実装
サーバー側実装は、Analytics、Target、および ID サービスのサーバーおよびクライアント側実装を使用する A4T のお客様向けです。 この方法で ID サービスを設定した場合は、ページに visitor.resetState() を追加するだけでかまいません。 ID サービスの呼び出しにより自動的に新しい ID とサーバーの状態が返されます。
非標準的な実装（ID を渡す場合）
ID サービスを非標準的な実装で設定した場合、visitor.resetState() と共に渡す SDID（またはその他の ID）を保持するための可変オブジェクトを設定する必要があります。 以下に示すように、これには組織 ID と、渡す ID が含まれます。 コードは、以下の例のようになります。
//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);
非標準的な実装（ID を渡さない場合）
この場合は、visitor.resetState() を使用して新しい ID を生成できます。 これは、単一ページアプリで、ユーザーがページを更新せずに新しい画面に移動して新しい 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）
現在、visitor.resetState() を DTM で使用するための設定方法はありません。