マルチドメイン統合

複数のWebドメインにわたってBraze Web SDKを統合する方法について説明します。

実装が複数のドメインにまたがる場合、ブラウザのOrigin境界がBraze Web SDKのユーザー状態の保存と読み取りに影響します。

アプリとAPIキー戦略の選択

1つのWeb SDK APIキーを複数のドメインで使用できますが、ほとんどの場合、同じワークスペース内の別々のアプリにマッピングされた個別のAPIキーを使用する方が、より適切なコントロールが可能です。

1つのワークスペース内で個別のアプリを使用すると、アプリフィルターを活用してドメインごとのセグメンテーションとメッセージターゲティングをより明確に行えます。

1つのドメインでプッシュ通知を設定する

別々のルートドメインの場合、Webプッシュ登録はドメインごとに分離されます。

• 1つのドメインをプッシュ通知ドメインとして選択してください。
• 同じユーザージャーニーで両方のルートドメインにプッシュを登録しないでください。プロンプトや購読の動作が競合する可能性があります。

ドメイン間でユーザーを一貫して識別する

デフォルトでは、各ルートドメインは独自のSDK状態を保存します。ドメイン間のアクティビティを同じBrazeユーザープロファイルに関連付けるには、以下を行います。

• ログイン後、各ドメインで同じexternal_idを使用してchangeUser()を呼び出してください。
• 個別のAPIキーを使用している場合は、両方のアプリを同じワークスペースに配置してください。

ユーザーIDに関する一般的なガイダンスについては、Braze SDKによるユーザーIDの設定を参照してください。

ドメインごとのイベントとトリガー動作を計画する

イベントとトリガーのモデリング方法は、アプリ戦略によって異なります。

• ドメイン間で単一アプリ： ドメイン固有のカスタムイベントを記録して、セグメンテーションとトリガーでサイトごとの行動を区別できるようにします。
• 個別アプリ： ドメイン固有のターゲティングと分析にはアプリフィルターを使用してください。

ドメイン間のセッション動作を理解する

デフォルトでは、Web SDKのセッションタイムアウトは非アクティブ状態が30分間続いた場合です。1つのアプリ/APIキーを使用する別々のルートドメインの場合は、以下の点に注意してください。

• 各ドメインはセッションを独立して開始・終了します。
• 両方のドメイン間を移動するユーザーは、重複するセッションを作成する可能性があります。
• セッション開始トリガーが両方のドメインで発火する場合があります。

セッションライフサイクルの基本的な詳細については、Braze SDKによるセッションのトラッキングを参照してください。