クッキー

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

Sitecore Personalize CookieをファーストパーティCookieとしてWebブラウザに保存します。ファーストパーティCookieは、Webブラウザのアドレスバーに表示されるドメインによって設定されるCookieです。

bid_{:placeholder-token:}{clientKey}{/:placeholder-token:}- このCookieは、セッション間でブラウザIDを保持します。これは、Engage SDKがSitecore Personalizeに対して行うすべての呼び出しに必要です。このCookieは、Cookieの有効期限が切れるか削除されるまで、ブラウザごとに一意の汎用一意識別子(UUID)を生成します。Cookieの有効期限が切れるか削除された後、訪問者が次に戻ったときに新しいUUIDが生成されます。
bx_bucket_number - このセッションCookieは、アプリでWebエクスペリエンスまたはWeb実験を使用している場合にのみ使用されます。Cookieは、ゲストを特定のバリアントに割り当てます。特定のセッション中にサイトで公開されている各ウェブテストに対して割り当てが実行されます。Cookieは、セッションの期間中のみ保存されます。
bx_guest_ref - このセッションCookieは、アプリでWebエクスペリエンスまたはWeb実験を使用している場合にのみ使用されます。このCookieは、バケットを持つすべてのユーザーに汎用一意識別子(UUID)を割り当てます。Cookieは、セッションの期間中のみ保存されます。

このEngage SDKは、クライアントおよびサーバーからのCookieの設定をサポートしています。

Cookieの同意を確認する

大事な

Engage SDKを読み込み、Cookieを設定するのは、サイトの訪問者が同意した場合のみにしてください。

サイト訪問者がCookieを受け入れた場合にのみEngage SDKを初期化するコード例を次に示します。

お客様独自のCookie同意の実装は、アプリケーションの要件、法的規制、およびユーザーエクスペリエンスの設計によって異なります。この例は説明のみを目的としており、独自のコードでカスタマイズしない限り機能しません。

// Import your custom logic that checks whether the site visitor has accepted cookies:
import { getCookieConsent } from "<YOUR_CUSTOM_LOGIC_PATH>";

// Your custom function to check whether the site visitor has accepted cookies:
const hasConsent = getCookieConsent();

// If the site visitor accepts cookies, initialize the SDK:
if (hasConsent === true)
{
 engage = await window.Engage.init(settings);
};

クライアント設定のCookie

アプリのクライアント側のみにアクセスできる場合は、クライアントからCookieを設定する必要があります。

クライアントからCookieを設定するには、settingsオブジェクトでforceServerCookieMode属性をfalseに設定し、settingsオブジェクトをEngage.init() 関数に渡します。コードサンプルについては、「Reactアプリの統合」および「Nextアプリの統合 (クライアント設定Cookie)」を参照してください。

サーバー設定のCookie

アプリのサーバー側にアクセスできる場合は、クライアントではなくサーバーからCookieを設定することを選択できます。このシナリオでは、Webサーバー上でCookieを作成および管理します。次に、WebサーバーはCookieをクライアントアプリに送信します。最後に、クライアントアプリはCookieをWebブラウザーに保存します。

サーバーからCookieを設定すると、次の利点があります。

CookieにhttpOnly属性を追加することでセキュリティを強化します。これにより、クライアント側のJavaScriptがCookieにアクセスするのを防ぎ、クロスサイトスクリプティング (XSS) 攻撃を軽減できます。
Intelligent Tracking Prevention(ITP)がCookieに与える影響を軽減します。たとえば、クライアント設定のCookieとは異なり、サーバー設定のCookieは7日後に自動的に期限切れになりません。

Engage SDKパッケージを使用すると、settingsオブジェクトでforceServerCookieMode属性をtrueに設定し、settingsオブジェクトをクライアント側のEngage.init() 関数とサーバー側のEngage.initServer() 関数に渡すことで、サーバーからCookieを設定できます。コードサンプルについては、「Nextアプリの統合 (サーバー設定Cookie)」を参照してください。

この記事を改善するための提案がある場合は、お知らせください!