利用可能なオプション
| Option↕ | Description↕ |
|---|---|
URL_PARAM | 選択した国をURLクエリ文字列 ?zCountry=XX として永続化します。国別URLを共有・ブックマークできます。URLはページリロードなしで window.history.replaceState() を使用して更新されます。 |
SESSION | 選択した国をブラウザのsession storageのキー zonos--country に永続化します。買い物客が移動する際に選択が維持されますが、ブラウザタブまたはセッション終了時にクリアされます。 |
デフォルト値は URL_PARAM です。
国オーバーライド動作の設定
Zonos.init 呼び出しの helloSettings で countryOverrideBehavior プロパティを設定します：
1
Zonos.init({2
// ... other settings3
helloSettings: {4
countryOverrideBehavior: "URL_PARAM",5
},6
});各オプションの使用タイミング
URL_PARAM
- 買い物客に国別リンクを他の人と共有してほしい場合。
- 検索エンジンにページの国別バージョンをインデックスしてほしい場合。
- 選択した国をページ更新後も維持したい場合。
SESSION
- クエリパラメーターのないクリーンなURLを好む場合。
- 現在のブラウザセッションを超えて国選択を永続化する必要がない場合。
- サイトに追加のクエリパラメーターと競合する可能性のあるURLセンシティブなロジックがある場合。
国検出の仕組み
Helloは以下の順序で選択された国をチェックします：
- URLパラメーター — URLクエリ文字列で
zCountryを探します。レガシーパラメーターcountryとcustomerCountryもフォールバックとしてサポートします。 - Session storage — URLパラメーターが見つからない場合、
sessionStorageでzonos--countryキーをチェックします。 - Geolocation — どちらも設定されていない場合、Helloは買い物客の検出された位置を使用します。
どの countryOverrideBehavior を選択しても、買い物客が選択すると国は常にsession storageに保存されます。設定はURLも更新するかどうかを制御します。
国オーバーライド動作
Helloが買い物客の選択国を記憶する方法を制御します。買い物客がHelloウィジェットで別の国を選択すると、Zonosはサイトを移動する際にその選択を記憶する必要があります。
helloSettingsのcountryOverrideBehavior設定が、この国選択の永続化方法を制御します。