ストレージ
Braze SDKによって保存されるさまざまなデバイスレベルプロパティについて学習する。
デバイスのプロパティ
デフォルトでは、Brazeは以下のデバイスレベルプロパティを収集し、デバイス、言語、タイムゾーンベースのメッセージパーソナライゼーションを可能にする:
AD_TRACKING_ENABLED
ANDROID_VERSION
CARRIER
IS_BACKGROUND_RESTRICTED
LOCALE
MODEL
NOTIFICIATION_ENABLED
RESOLUTION
TIMEZONE
AD_TRACKING_ENABLED
と TIMEZONE
は null
または空白の場合は収集されません。GOOGLE_ADVERTISING_ID
は SDK によって自動的に収集されないため、setGoogleAdvertisingId
経由で渡す必要があります。
- デバイスの通信事業者 (
CTCarrier
非推奨に関する注記を参照) - デバイスのロケール
- デバイスモデル
- デバイス OS のバージョン
- プッシュ認証ステータス
- プッシュ表示オプション
- プッシュ通知が有効
- デバイスの解像度
- デバイスのタイムゾーン
Braze SDK はIDFA を自動的に収集しません。アプリはオプションで、以下のメソッドを直接実装することで IDFA を Braze に渡すことができます。アプリは IDFA を Braze に渡す前に、アプリトラッキングの透明性フレームワークを通じてエンドユーザーによるトラッキングへの明示的なオプトインを取得する必要があります。
- 広告のトラッキング状態を設定するには
set(adTrackingEnabled:)
を使用します。 - 広告主の識別子 (IDFA) を設定するには、
set(identifierForAdvertiser:)
を使用します。
BROWSER
BROWSER_VERSION
LANGUAGE
OS
RESOLUTION
TIME_ZONE
USER_AGENT
デフォルトでは、すべてのプロパティがイネーブルメントになっている。しかし、手動でイネーブルメントを有効にも無効にもできる。Braze SDKの機能の中には、特定のプロパティ(ローカルタイムゾーン配信やタイムゾーンなど)を必要とするものがあるため、本番環境にリリースする前に、必ず設定をテストしておくことに留意すること。
たとえば、Android OSのバージョンやデバイスのロケールを指定して、allowlistedにすることができる。詳細は setDeviceObjectAllowlistEnabled()
と setDeviceObjectAllowlist()
メソッドを参照のこと。
1
2
3
new BrazeConfig.Builder()
.setDeviceObjectAllowlistEnabled(true)
.setDeviceObjectAllowlist(EnumSet.of(DeviceKey.ANDROID_VERSION, DeviceKey.LOCALE));
例えば、タイムゾーンやロケールコレクションを許可リストに指定することができる。詳細については、 オブジェクトの devicePropertyAllowList
configuration
プロパティを参照のこと。
1
configuration.devicePropertyAllowList = [.timeZone, .locale]
1
2
3
4
configuration.devicePropertyAllowList = @[
BRZDeviceProperty.timeZone,
BRZDeviceProperty.locale
];
例えば、許可リストに入れるデバイスの言語を指定することができる。詳しくは、devicePropertyAllowlist
のオプションを参照のこと。 InitializationOptions
.
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データ収集を参照のこと。
Cookieを保存する(Webのみ)
Web Braze SDKを初期化すると、有効期限400日のCookieが作成・保存され、新しいセッションで自動的に更新される。
以下のCookieが保存される:
クッキー | 説明 | サイズ |
---|---|---|
ab.storage.userId.[your-api-key] |
現在ログインしているユーザーが変更されたかどうかを判断し、イベントを現在のユーザーに関連付けるために使用される。 | changeUser に渡された値のサイズに基づく |
ab.storage.sessionId.[your-api-key] |
メッセージを同期し、セッション分析を計算するために、ユーザーが新しいセッションを開始しているか、既存のセッションを開始しているかを判断するために使用されるランダムに生成される文字列。 | ~200バイト |
ab.storage.deviceId.[your-api-key] |
匿名ユーザーを識別し、ユーザーのデバイスを区別し、デバイスベースのメッセージングを可能にするために使用されるランダムに生成される文字列。 | ~200バイト |
ab.optOut |
disableSDK が呼び出されたときにユーザーのオプアウト設定を格納するために使用されます |
~40バイト |
ab._gd |
ルートレベルの Cookie ドメインを決定するために一時的に作成 (その後削除) されます。これにより、サブドメイン間で SDK が適切に動作できるようになります。 | 該当なし |
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
および wipeData
SDKメソッドを参照のこと。これらの2つのメソッドは、ユーザーが同意を取り消した場合、または SDK の初期化後に Braze のすべての機能を停止する場合に役立ちます。