Skip to content

クッキーと保存

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

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

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

クッキー

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

BrazeがCookieを作成する場合、Cookieは1年間の有効期限で保存され、新しいセッションで自動的に更新されます。

クッキーを無効にする

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

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のすべての機能を停止したい場合に便利です。

クッキー一覧

クッキー 説明 サイズ  
ab.storage.userId.[your-api-key] ｜現在ログインしているユーザーが変更されたかどうかを判断し、イベントを現在のユーザーに関連付けるために使用される。｜changeUser ｜に渡される値のサイズに基づく。      
ab.storage.sessionId.[your-api-key] メッセージを同期し、セッション分析を計算するために、ユーザーが新しいセッションを開始しているか、既存のセッションを開始しているかを判断するために使用されるランダムに生成される文字列。    
ab.storage.deviceId.[your-api-key] ｜匿名ユーザーを識別し、ユーザーのデバイスを区別し、デバイスベースのメッセージングを可能にするために使用されるランダムに生成される文字列。      
ab.optOut disableSDK が呼び出されたときに、ユーザーのオプトアウト・プリファレンスを保存するために使用される ~40バイト 。
ab._gd ルートレベルのクッキー・ドメインを決定するために一時的に作成され（その後削除され）、SDKがサブドメイン間で適切に動作するようにします。    

デバイスのプロパティ

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

  • ブラウザー
  • ブラウザーのバージョン
  • 言語
  • OS
  • 解像度
  • タイムゾーン
  • 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データ収集オプションをご覧ください。

  GitHub でこのページを編集
「このページはどの程度役に立ちましたか?」
New Stuff!