クッキーと保存

この記事では、Braze Web SDKが使用するさまざまなクッキーについて説明する。

読み進める前に、Braze Web SDKは、ウェブサイトがSDKを初期化するまで、ブラウザにデータを保存しない（クッキーなど）ことに注意すること。

さらに、これらの値は変更される可能性があり、統合を通じて直接アクセスすべきではありません。代わりに、パブリックAPIインターフェースについては、JavaScriptのドキュメントを参照のこと。

クッキー

このセクションでは、Braze Web SDKにおけるCookieの設定および管理方法について説明する。Braze Web SDK は、最大限の柔軟性、法令遵守、メッセージングの関連性を提供するように構築されています。

Braze がCookie を作成すると、新しいセッションで自動的に更新される400 日の有効期限で保存されます。

Cookie を無効にする

すべての Cookie を無効にするには、Web SDK を初期化する際に noCookies オプションを使用します。 Cookie を無効にすると、サブドメイン間を移動する匿名ユーザーを関連付けることができなくなり、各サブドメインで新しいユーザーが発生します。

1
2
3
4
5
import * as braze from"@braze/web-sdk";
braze.initialize("API-KEY", {
    baseUrl: "BASE-URL",
    noCookies: true
});

Brazeのトラッキング全般を停止したり、保存されたブラウザデータをすべて消去するには disableSDKおよび wipeDataSDKメソッドを参照のこと。これらの2つのメソッドは、ユーザーが同意を取り消した場合、または SDK の初期化後に Braze のすべての機能を停止する場合に役立ちます。

クッキー一覧

デバイスのプロパティ

デフォルトでは、Brazeは以下のデバイスレベルのプロパティを収集し、デバイス、言語、タイムゾーンに基づくメッセージのパーソナライズを可能にする：

• ブラウザ
• BROWSER_VERSION
• 言語
• OS
• RESOLUTION
• TIME_ZONE
• USER_AGENT

devicePropertyAllowlist 初期化オプションをDeviceProperties のリストに設定することで、収集するプロパティを無効にしたり指定したりできます。

1
2
3
4
5
import * as braze from"@braze/web-sdk";
braze.initialize("API-KEY", {
    baseUrl: "BASE-URL",
    devicePropertyAllowlist: [ braze.DeviceProperties.LANGUAGE ] // list of `DeviceProperties` you want to collect
});

デフォルトでは、すべてのフィールドが有効になっています。いくつかのプロパティがないと一部の機能が正しく機能しないことがあるので注意してください。たとえば、ローカルタイムゾーンの配信はタイムゾーンなしでは機能しません。

自動的に収集されるデバイスプロパティの詳細については、SDK データ収集オプションをご覧ください。