Skip to content

ストレージ

Braze SDKによって保存されるさまざまなデバイスレベルプロパティについて学習する。

デバイスのプロパティ

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

  • BROWSER
  • BROWSER_VERSION
  • LANGUAGE
  • OS
  • RESOLUTION
  • TIME_ZONE
  • USER_AGENT
  • AD_TRACKING_ENABLED
  • ANDROID_VERSION
  • CARRIER
  • IS_BACKGROUND_RESTRICTED
  • LOCALE
  • MODEL
  • NOTIFICATION_ENABLED
  • RESOLUTION
  • TIMEZONE
  • デバイスの通信事業者 (CTCarrier 非推奨に関する注記を参照)
  • デバイスのロケール
  • デバイスモデル
  • デバイス OS のバージョン
  • プッシュ認証ステータス
  • プッシュ表示オプション
  • プッシュ通知が有効
  • デバイスの解像度
  • デバイスのタイムゾーン

デフォルトでは、すべてのプロパティが有効になっています。しかし、手動で有効にも無効にもできます。Braze SDKの機能の中には、特定のプロパティ(ローカルタイムゾーン配信やタイムゾーンなど)を必要とするものがあるため、本番環境にリリースする前に、必ず設定をテストしておくことに留意すること。

例えば、許可リストに登録するデバイスの言語を指定することができます。詳細については、InitializationOptionsdevicePropertyAllowlist オプションを参照してください。

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
});

たとえば、許可リストに登録する Android OS バージョンとデバイスロケールを指定できます。詳細は setDeviceObjectAllowlistEnabled()setDeviceObjectAllowlist()メソッドを参照のこと。

1
2
3
new BrazeConfig.Builder()
    .setDeviceObjectAllowlistEnabled(true)
    .setDeviceObjectAllowlist(EnumSet.of(DeviceKey.ANDROID_VERSION, DeviceKey.LOCALE));

たとえば、許可リストに登録するタイムゾーンとロケール収集を指定できます。詳細については、configuration オブジェクトの devicePropertyAllowList プロパティを参照してください。

1
configuration.devicePropertyAllowList = [.timeZone, .locale]
1
2
3
4
configuration.devicePropertyAllowList = @[
    BRZDeviceProperty.timeZone,
    BRZDeviceProperty.locale
];

Cookie を保存する (Web のみ)

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

以下の Cookie が保存されます。

Cookie を無効にする

すべての Cookie を無効にするには、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 のすべての機能を停止する場合に役立ちます。

New Stuff!