Skip to content

セグメント

セグメントは、顧客データの収集、クリーンアップ、およびアクティブ化を支援する顧客データプラットフォームです。

Brazeとセグメントの統合により、ユーザーを追跡し、さまざまなユーザー分析プロバイダーにデータを転送できます。セグメントでは次の操作を行うことができます。

前提条件

必要条件 説明
セグメントアカウント このパートナーシップを活用するには、セグメントアカウントが必要です。
インストール済みのソースとセグメントソースライブラリ モバイルアプリ、Webサイト、バックエンドサーバーなど、セグメントに送信されるすべてのデータの発生元です。

Source > Destinationフローを正しく設定するには、事前にアプリ、サイト、またはサーバーにライブラリをインストールする必要があります。

統合

Brazeとセグメントを統合するには、選択した統合タイプ（接続モード）に従って、Brazeを送信先として設定する必要があります。Brazeを初めてご利用のお客様は、セグメント replaysを使用して履歴データをBrazeに転送できます。次に、マッピングを設定し、統合をテストして、Brazeとセグメント間のスムーズなデータフローを確認する必要があります。

ステップ 1:Braze送信先を作成する

ソースの設定が正常に完了したら、各ソース（iOS、Android、Webなど）に対してBrazeを送信先として設定する必要があります。接続設定を使用して、Brazeとセグメント間のデータフローをカスタマイズするための多くのオプションがあります。

ステップ 2:送信先フレームワークと接続タイプを選択する

セグメントで、Destinations > Braze > Configure Braze > Select your Source > Setupに移動します。

ソース設定ページ。このページには、送信先フレームワークを「actions」または「classic」に設定し、接続モードを「cloud mode」または「device mode」に設定するための設定が含まれています。

セグメントのウェブソース（Analytics.js）およびネイティブのクライアントサイドライブラリは、サイドバイサイド（デバイスモード）統合またはサーバー間（クラウドモード）統合のいずれかを使用してBrazeと統合できます。

接続モードの選択は、送信先が設定されているソースのタイプによって決まります。

統合 詳細
サイドバイサイド
（デバイスモード）		 セグメントのSDKを使用してイベントをBrazeのネイティブ呼び出しに変換し、サーバー間統合よりも深い機能へのアクセスとBrazeのより包括的な使用を可能にします。

セグメントはすべてのメソッド（たとえばContent Cards）をサポートしているわけではないことに注意してください。対応するマッピングを通じてマッピングされていないBrazeメソッドを使用するには、コードベースにネイティブのBrazeコードを追加してメソッドを呼び出す必要があります。
サーバー間
（クラウドモード）		 セグメントからBraze REST APIエンドポイントにデータを転送します。

アプリ内メッセージ、Content Cards、プッシュ通知などのBraze UI機能はサポートされていません。また、デバイスレベルのフィールドなど、この方法では利用できない自動キャプチャデータも存在します。

これらの機能を使用したい場合は、サイドバイサイド統合を検討してください。

サイドバイサイドSDK統合

デバイスモードとも呼ばれるこの統合は、セグメントのSDKとメソッドをBraze SDKにマッピングし、プッシュ、アプリ内メッセージ、その他のBrazeネイティブメソッドなど、SDKが提供するすべての機能にアクセスできるようにします。

デバイスモード接続を使用する場合、Braze SDKをネイティブに統合する場合と同様に、Braze SDKはすべてのユーザーにdevice_idとバックエンド識別子であるbraze_idを割り当てます。これにより、BrazeはuserIdの代わりにこれらの識別子を照合してデバイスからの匿名アクティビティをキャプチャできます。

Androidソースのデバイスモード送信先としてBrazeを設定するには、送信先フレームワークとしてActionsを選択し、Saveを選択します。

サイドバイサイド統合を完了するには、Braze Kotlin送信先プラグインをAndroidアプリに追加する必要があります。このプラグインはセグメント SDKとBraze SDKをブリッジし、デバイスモードのデータをBrazeにフローさせます。セグメントのインストール手順に従って、プラグインの依存関係を追加し、セグメント analyticsインスタンスで初期化してください。

Androidデバイスモード統合のソースコードはBrazeが管理しており、新しいBraze SDKリリースを反映して定期的に更新されます。

iOSソースのデバイスモード送信先としてBrazeを設定するには、送信先フレームワークとしてActionsを選択し、Saveを選択します。

サイドバイサイド統合を完了するには、Braze Swift送信先プラグインをiOSアプリに追加する必要があります。このプラグインはセグメント SDKとBraze SDKをブリッジし、デバイスモードのデータをBrazeにフローさせます。セグメントのインストール手順に従って、プラグインの依存関係（Swift Package マネージャーまたはCocoaPods経由）を追加し、セグメント analyticsインスタンスで初期化してください。

iOSデバイスモード統合のソースコードはBrazeが管理しており、新しいBraze SDKリリースを反映して定期的に更新されます。

セグメントのBraze Web Mode (Actions) フレームワークは、ウェブソースのデバイスモード送信先としてBrazeを設定する際に推奨されます。

セグメントで、送信先フレームワークとしてActionsを、接続モードとしてDevice Modeを選択します。

Actionsフレームワークとデバイスモードが選択されたセグメント送信先設定。

React Native Brazeプラグインのソースコードはセグメントが管理しており、新しいBraze SDKリリースを反映して定期的に更新されます。

React Native セグメントソースをBrazeに接続する場合、オペレーティングシステムごとにソースと送信先を設定する必要があります。たとえば、iOS送信先とAndroid送信先をそれぞれ設定します。

アプリのコードベース内で、デバイスタイプに応じて条件分岐でセグメント SDKを初期化し、各アプリに関連付けられたそれぞれのソースライトキーを使用します。

プッシュトークンがデバイスから登録されBrazeに送信されると、SDKの初期化時に使用されたアプリ識別子に関連付けられます。デバイスタイプの条件分岐による初期化は、Brazeに送信されるプッシュトークンが適切なアプリに関連付けられることを確認するのに役立ちます。

各ソースのデバイスモード送信先としてBrazeを設定するには、送信先フレームワークとしてActionsを選択し、Saveを選択します。

サーバー間統合

クラウドモードとも呼ばれるこの統合は、セグメントからBraze REST APIにデータを転送します。セグメントのBraze Cloud Mode (Actions)フレームワークを使用して、任意のソースに対してクラウドモード送信先を設定します。

サイドバイサイド統合とは異なり、サーバー間統合ではアプリ内メッセージ、Content Cards、自動プッシュトークン登録などのBraze UI機能はサポートされていません。また、クラウドモードでは利用できない自動キャプチャデータ（匿名ユーザーやデバイスレベルのフィールドなど）も存在します。

このデータやこれらの機能を使用したい場合は、サイドバイサイド（デバイスモード）SDK統合の使用を検討してください。

Braze Cloud Mode (Actions) 送信先のソースコードはセグメントが管理しています。

ステップ 3:設定

送信先の設定を定義します。すべての設定がすべての送信先タイプに適用されるわけではありません。

設定 説明
アプリ識別子 特定のアプリを参照するために使用されるアプリ識別子。Brazeダッシュボードの設定の管理で確認できます。
カスタムAPIエンドポイント
（SDKエンドポイント）		 インスタンスに対応するBraze SDKエンドポイント（例：sdk.iad-01.braze.com）
エンドポイントリージョン Brazeインスタンス（例：US 01、US 02、EU 01など）
自動アプリ内メッセージ登録を有効にする アプリ内メッセージを手動で登録したい場合はこれを無効にしてください。
設定 説明
アプリ識別子 特定のアプリを参照するために使用されるアプリ識別子。Brazeダッシュボードの設定の管理で確認できます。
カスタムAPIエンドポイント
（SDKエンドポイント）		 インスタンスに対応するBraze SDKエンドポイント（例：sdk.iad-01.braze.com）
Safari Webサイトプッシュ ID Safariプッシュをサポートする場合、Safariプッシュ証明書を作成する際にAppleに提供したWebサイトプッシュIDでこのオプションを指定する必要があります（webで始まります。例：web.com.example.domain）。
Braze Web SDKバージョン 使用したいBraze Web SDKのバージョン
アプリ内メッセージを自動送信 デフォルトでは、ユーザーが対象となるすべてのアプリ内メッセージが自動的に配信されます。アプリ内メッセージを手動で表示したい場合はこれを無効にしてください。
Font Awesomeを読み込まない Brazeはアプリ内メッセージのアイコンにFont Awesomeを使用します。デフォルトでは、BrazeはFontAwesome CDNからFontAwesomeを自動的に読み込みます。この動作を無効にするには（たとえば、サイトがFontAwesomeのカスタマイズ版を使用している場合）、このオプションをTRUEに設定します。この場合、サイトにFontAwesomeが読み込まれていることを確認する責任があります。そうしないと、アプリ内メッセージが正しくレンダリングされない場合があります。
HTMLアプリ内メッセージを有効にする このオプションを有効にすると、Brazeダッシュボードユーザーがアプリ内メッセージでHTMLを使用できるようになります。
アプリ内メッセージを新しいタブで開く デフォルトでは、アプリ内メッセージのクリックからのリンクは、ダッシュボードでメッセージごとに指定されたとおりに、現在のタブまたは新しいタブで読み込まれます。すべてのアプリ内メッセージクリックからのリンクを新しいタブまたはウィンドウで強制的に開くには、このオプションをTRUEに設定します。
アプリ内メッセージのzインデックス このオプションの値を指定して、Brazeのデフォルトのzインデックスをオーバーライドします。
アプリ内メッセージの明示的な閉じを必要とする デフォルトでは、アプリ内メッセージが表示されているときに、Escapeキーを押すかページのグレーアウトされた背景をクリックするとメッセージが閉じられます。この動作を防止し、メッセージを閉じるために明示的なボタンクリックを必要とするには、このオプションをtrueに設定します。
トリガーアクション間の最小間隔（秒） デフォルトは30です。
デフォルトでは、トリガーアクションは前回のトリガーアクションから少なくとも30秒経過した場合にのみ発火します。この設定オプションの値を指定してデフォルトをオーバーライドできます。通知でユーザーにスパムを送信しないように、この値を10より小さくしないことをお勧めします。
Service Workerの場所 デフォルトでは、Webプッシュ通知のユーザー登録時に、BrazeはWebサーバーのルートディレクトリ/service-worker.jsで必要なService Workerファイルを探します。Service Workerをそのサーバーの別のパスでホストしたい場合、ファイルへの絶対パスの値をこのオプションに指定します（例：/mycustompath/my-worker.js）。ここで値を設定すると、サイトのプッシュ通知のスコープが制限されることに注意してください。たとえば、この例では、Service Workerファイルが/mycustompath/ディレクトリ内にあるため、requestPushPermissionはhttp://yoursite.com/mycustompath/で始まるWebページからのみ呼び出すことができます。
プッシュトークンメンテナンスを無効にする デフォルトでは、すでにWebプッシュ許可を付与したユーザーは、新しいセッション時にBrazeバックエンドとプッシュトークンを自動的に同期して配信性を確保します。この動作を無効にするには、このオプションをFALSEに設定します。
Service Workerを外部管理する 独自のService Workerを登録してそのライフサイクルを制御している場合、このオプションをTRUEに設定すると、Braze SDKはService Workerの登録や登録解除を行いません。このオプションをTRUEに設定した場合、プッシュが正しく機能するためには、requestPushPermissionを呼び出す前にService Workerを自分で登録し、self.importScripts('https://js.appboycdn.com/web-sdk-develop/4.1/service-worker.js');でBraze Service Workerコードを含めるか、そのファイルの内容を直接含める必要があります。このオプションがTRUEの場合、serviceWorkerLocationオプションは無関係で無視されます。
Content Securityノンス このオプションに値を指定すると、Braze SDKはSDKによって作成されたすべての<script>要素と<style>要素にノンスを追加します。これにより、Braze SDKがWebサイトのContent Securityポリシーと連携できるようになります。このノンスの設定に加えて、FontAwesomeの読み込みを許可する必要がある場合があります。これは、Content SecurityポリシーのAllowlistにuse.fontawesome.comを追加するか、doNotLoadFontAwesomeオプションを使用して手動で読み込むことで行えます。
クローラーアクティビティを許可する デフォルトでは、Braze Web SDKはユーザーエージェント文字列に基づいて、Googleなどの既知のスパイダーやWebクローラーからのアクティビティを無視します。これにより、データポイントが節約され、分析がより正確になり、ページランクが向上する可能性があります。ただし、これらのクローラーからのアクティビティをBrazeで記録したい場合は、このオプションをTRUEに設定できます。
ログを有効にする TRUEに設定すると、デフォルトでログが有効になります。これにより、Brazeはすべてのユーザーに表示されるJavaScriptコンソールにログを記録します。ページを本番環境にリリースする前に、これを削除するか、setLoggerで代替ロガーを提供する必要があります。
ユーザー提供のJavaScriptを許可する デフォルトでは、Braze Web SDKはユーザー提供のJavaScriptクリックアクションを許可しません。これは、Brazeダッシュボードユーザーがサイト上でJavaScriptを実行できるようになるためです。Brazeダッシュボードユーザーが悪意のないJavaScriptクリックアクションを記述することを信頼していることを示すには、このプロパティをTRUEに設定します。enableHtmlInAppMessagesがTRUEの場合、このオプションもTRUEに設定されます。
アプリバージョン このオプションに値を指定すると、Brazeに送信されるユーザーイベントが指定されたバージョンに関連付けられ、ユーザーセグメンテーションに使用できます。
セッションタイムアウト（秒） デフォルトは30です。
デフォルトでは、セッションは30分の非アクティブ後にタイムアウトします。この設定オプションの値を指定してデフォルトをオーバーライドできます。
デバイスプロパティAllowlist デフォルトでは、Braze SDKはDevicePropertiesのすべてのデバイスプロパティを自動的に検出して収集します。この動作をオーバーライドするには、DevicePropertiesの配列を指定します。一部のプロパティがないと、すべての機能が正しく機能しない場合があることに注意してください。たとえば、ローカルタイムゾーン配信はタイムゾーンなしでは機能しません。
ローカライゼーション デフォルトでは、SDKが生成するユーザー向けメッセージはユーザーのブラウザ言語で表示されます。この動作をオーバーライドして特定の言語を強制するには、このオプションの値を指定します。このオプションの値はISO 639-1言語コードである必要があります。
Cookieなし デフォルトでは、Braze SDKは少量のデータ（ユーザーID、セッションID）をCookieに保存します。これにより、Brazeがサイトの異なるサブドメイン間でユーザーとセッションを認識できるようになります。これが問題となる場合、このオプションにTRUEを渡してCookieストレージを無効にし、HTML 5 localStorageのみに依存してユーザーとセッションを識別します。
すべてのページをトラック Classic Destination Webデバイスモード（メンテナンス）のみ

セグメントでは、この設定をマッピングを通じて有効にできるWeb Actionsフレームワーク送信先への移行を推奨しています。

すべてのPageコールを「Loaded/Viewed a Page」イベントとしてBrazeに送信します。
名前付きページのみをトラック Classic Destination Webデバイスモード（メンテナンス）のみ

セグメントでは、この設定をマッピングを通じて有効にできるWeb Actionsフレームワーク送信先への移行を推奨しています。

名前が関連付けられたPageコールのみをBrazeに送信します。
収益がある場合に購入を記録 Classic Destination Webデバイスモード（メンテナンス）のみ

セグメントでは、この設定をマッピングを通じて有効にできるWeb Actionsフレームワーク送信先への移行を推奨しています。

このオプションを有効にすると、revenueプロパティを含むすべてのTrackコールが購入イベントをトリガーします。
既知のユーザーのみをトラック Classic Destination Webデバイスモード（メンテナンス）のみ

セグメントでは、この設定をマッピングを通じて有効にできるWeb Actionsフレームワーク送信先への移行を推奨しています。

有効にすると、この新しい設定は有効なuserIdが存在するまでwindow.braze.initializeの呼び出しを遅延させます。
設定 説明
アプリ識別子 特定のアプリを参照するために使用されるアプリ識別子。Brazeダッシュボードの設定の管理で確認できます。
REST APIキー Brazeダッシュボードの設定 > APIキーで確認できます。
カスタムREST APIエンドポイント インスタンスに対応するBraze RESTエンドポイント（例：rest.iad-01.braze.com）。
既存ユーザーのみを更新 Classic Destination クラウドモード（メンテナンス）のみ

セグメントでは、この設定をマッピングを通じて有効にできるCloud Actionsフレームワーク送信先への移行を推奨しています。

既存ユーザーのみを更新するかどうかを決定します。

ステップ 4:メソッドをマッピングする

Brazeは、セグメントのPage、Identify、およびTrackメソッドをサポートしています。これらのメソッド内で使用される識別子のタイプは、データがサーバー間（クラウドモード）統合で送信されるか、サイドバイサイド（デバイスモード）統合で送信されるかによって異なります。Braze Web Mode ActionsおよびCloud Mode Actions送信先では、セグメント aliasコールのマッピングを設定することもできます。

識別子タイプ サポートされる送信先
userId (external_id) すべて
匿名ユーザー デバイスモード送信先
ユーザーエイリアス クラウドモード送信先

Cloud Mode (Actions) 送信先には、エイリアスのみのユーザーを作成するか、既存のexternal_idプロファイルにエイリアスを追加するために使用できるCreate Aliasアクションが用意されています。Identify UserアクションをCreate Aliasアクションと併用して、ユーザーにexternal_idが利用可能になった後にエイリアスのみのユーザーをexternal_idとマージできます。

braze_idを使用してクラウドモードで匿名ユーザーデータを送信する回避策を構築することも可能です。これには、すべてのセグメント API呼び出しにユーザーのbraze_idを手動で含める必要があります。この回避策の設定方法の詳細については、セグメントのドキュメントを参照してください。

Cloud Mode Actions内でBrazeに送信される送信先データはバッチ処理が可能です。バッチサイズは75イベントを上限とし、これらのバッチは30秒間蓄積された後にフラッシュされます。リクエストのバッチ処理はアクションごとに行われます。たとえば、Identifyコール（属性）は1つのリクエストにバッチされ、Trackコール（カスタムイベント）は2番目のリクエストにバッチされます。セグメントからBrazeへのリクエスト数が削減されるため、この機能を有効にすることをBrazeは推奨しています。これにより、送信先がBrazeのレート制限に達してリクエストをリトライするリスクも軽減されます。

アクションのバッチ処理を有効にするには、Braze送信先 > Mappingsに移動します。そこから、マッピングの横にある3点アイコンをクリックし、Edit Mappingを選択します。Select mappingsセクションの一番下までスクロールし、Batch Data to BrazeがYesに設定されていることを確認します。

Identify

Identifyコールを使用すると、ユーザーをアクションに結び付け、属性を記録できます。

特定のセグメント特別トレイトは、Brazeの標準属性プロファイルフィールドにマッピングされます：

セグメント特別トレイト Braze標準属性
userId external_id
firstName first_name
lastName last_name
email email
birthday dob
address.country country
address.city home_city
gender gender

email_subscribeやpush_subscribeなどの他の予約済みBrazeプロファイルフィールドは、これらのフィールドのBraze命名規則を使用し、Identifyコール内のトレイトとして渡すことで送信できます。

購読グループへのユーザーの追加

トレイトパラメーター内の以下のフィールドを使用して、特定の購読グループにユーザーを購読または購読解除することもできます。

braze_subscription_groupsと呼ばれる予約済みBrazeプロファイルフィールドを使用します。これはオブジェクトの配列に関連付けることができます。配列内の各オブジェクトには2つの予約キーが必要です：

  1. subscription_group_state：ユーザーが特定の購読グループに"subscribed"（購読済み）か"unsubscribed"（購読解除済み）かを示します。
  2. subscription_group_id：購読グループの一意のIDを表します。このIDはBrazeダッシュボードのSubscription Group Managementで確認できます。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

analytics.identify(
  userId: "{your-user}",
  traits: [
    "braze_subscription_groups": [
      [
        "subscription_group_id": "{your-group-id}",
        "subscription_group_state": "subscribed"
      ],
      [
        "subscription_group_id", "{your-group-id}",
        "subscription_group_state": "unsubscribed"
      ]
    ]
  ]
)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

analytics.identify(
  "{your-user}",
  buildJsonObject {
    put("braze_subscription_groups", buildJsonArray {
        add(
          buildJsonObject {
            put("subscription_group_id", "{your-group-id}")
            put("subscription_group_state", "subscribed")
          }
        )
        add(
          buildJsonObject {
            put("subscription_group_id", "{your-group-id}")
            put("subscription_group_state", "unsubscribed")
          }
        )
      }
    )
  }
)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

analytics.identify(
  "{your-user}",
  {
    braze_subscription_groups: [
      {
        subscription_group_id: "{your-group-id}",
        subscription_group_state: "subscribed"
      },
      {
        subscription_group_id: "{your-group-id}",
        subscription_group_state: "unsubscribed"
      }
    ]
  }
)
カスタム属性

その他のすべてのトレイトはカスタム属性として記録されます。

セグメントメソッド Brazeメソッド 例
ユーザーIDでIdentify External IDを設定 セグメント: analytics.identify("dawei");
Braze: Braze.changeUser("dawei")
予約済みトレイトでIdentify ユーザー属性を設定 セグメント: analytics.identify({email: "[email protected]"});
Braze: Braze.getUser().setEmail("[email protected]");
カスタムトレイトでIdentify カスタム属性を設定 セグメント: analytics.identify({fav_cartoon: "Naruto"});
Braze: Braze.getUser().setCustomAttribute("fav_cartoon": "Naruto");
ユーザーIDとトレイトでIdentify セグメント: External IDと属性を設定 上記のメソッドを組み合わせます。

Web Mode ActionsおよびCloud Mode Actions送信先では、Update User Profileアクションを使用してこれらのマッピングを設定できます。

Track

イベントをトラックすると、指定された名前を使用してカスタムイベントとして記録されます。

Trackコールのpropertiesオブジェクト内で送信されたメタデータは、関連するイベントのカスタムイベントプロパティとしてBrazeに記録されます。すべてのカスタムイベントプロパティのデータ型がサポートされています。

Web Mode ActionsおよびCloud Mode Actions送信先では、Track Eventアクションを使用してこれらのマッピングを設定できます。

セグメントメソッド Brazeメソッド 例
Track カスタムイベントとして記録されます。 セグメント: analytics.track("played_game");
Braze: Braze.logCustomEvent("played_game");
プロパティ付きTrack イベントプロパティとして記録されます。 セグメント: analytics.track("played_game", {name: "BotW", weapon: "boomerang"});
Braze: Braze.logCustomEvent("played_game", { "name": "BotW", "weapon": "boomerang"});
製品付きTrack 購入イベントとして記録されます。 セグメント: analytics.track("Order Completed", {products: [product_id: "ab12", price: 19]});
Braze: Braze.logPurchase("ab12", 19);
注文完了

セグメントのeCommerce APIで説明されている形式を使用してOrder Completedという名前のイベントをトラックすると、リストされた製品が購入として記録されます。

Web Mode ActionsおよびCloud Mode Actions送信先では、Track Purchaseアクションを通じてデフォルトのマッピングをカスタマイズできます。

Page

Pageコールを使用すると、ユーザーがWebサイトのページを表示するたびに、ページに関するオプションのプロパティとともに記録できます。

このイベントタイプは、Web Mode ActionsおよびCloud Actions送信先でトリガーとして使用し、Brazeにカスタムイベントを記録できます。

ステップ 5:統合をテストする

サイドバイサイド（デバイスモード）統合を使用する場合、概要メトリクス（ライフタイムセッション、MAU、DAU、スティッキネス、デイリーセッション、MAUごとのデイリーセッション）を使用して、Brazeがセグメントからデータを受信していることを確認できます。

データはカスタムイベントページまたは収益ページで表示するか、セグメントを作成して確認できます。ダッシュボードのカスタムイベントページでは、カスタムイベント数を時系列で表示できます。サーバー間（クラウドモード）統合を使用している場合、MAUおよびDAU統計を含む数式は使用できないことに注意してください。

購入データをBrazeに送信している場合（ステップ 3のTrackタブの「注文完了」を参照）、収益ページで特定の期間の収益や購入に関するデータ、またはアプリの総収益を表示できます。

セグメントを作成すると、カスタムイベントや属性データに基づいてユーザーをフィルタリングできます。

ユーザーの削除と抑制

ユーザーを削除または抑制する必要がある場合、セグメントのユーザー削除機能はBrazeの/users/deleteエンドポイントにマッピングされています。これらの削除の確認には最大30日かかる場合があることに注意してください。

Brazeとセグメント間で共通のユーザー識別子（external_idなど）を選択する必要があります。セグメントで削除リクエストを開始した後、セグメントダッシュボードの削除リクエストタブでステータスを確認できます。

セグメントリプレイ

セグメントは、すべての過去データを新しいテクノロジーパートナーに「リプレイ」するサービスをクライアントに提供しています。関連する過去のデータをすべてインポートしたい新規Braze顧客は、セグメントを通じてインポートできます。この機能に興味がある場合は、セグメントの担当者にお問い合わせください。

セグメントは/users/trackエンドポイントに接続して、お客様に代わってユーザーデータをBrazeにインポートします。

ベストプラクティス

データ超過料金を避けるためにユースケースを確認してください。

セグメントでは、クライアントが送信するデータ要素の数に制限はありません。セグメントでは、すべてのイベントを送信するか、Brazeに送信するイベントを選択することができます。セグメントを使用してすべてのイベントを送信するのではなく、マーケティングチームや編集チームとユースケースを確認し、データ超過料金を避けるためにBrazeに送信するイベントを決定することをお勧めします。

モバイルデバイスモードの送信先設定における、カスタムAPIエンドポイントとカスタムREST APIエンドポイントの違いを理解してください。
Braze用語 セグメントでの対応
Braze SDKエンドポイント カスタムAPIエンドポイント
Braze RESTエンドポイント カスタムREST APIエンドポイント

Braze APIエンドポイント（セグメントでは「Custom API Endpoint」と呼ばれます）は、BrazeがSDK用にセットアップするSDKエンドポイントです（例：sdk.iad-03.braze.com）。Braze REST APIエンドポイント（セグメントでは「Custom REST API Endpoint」と呼ばれます）は、REST APIエンドポイントです（例：https://rest.iad-03.braze.com）。

カスタムAPIエンドポイントがモバイルデバイスモードの送信先設定に正しく入力されていることを確認してください。
Braze用語 セグメントでの対応
Braze SDKエンドポイント カスタムAPIエンドポイント
Braze RESTエンドポイント カスタムREST APIエンドポイント

Braze SDKエンドポイントを正しく入力するためには、適切なフォーマットに従う必要があります。Braze SDKエンドポイントには https:// を含めないでください（例：sdk.iad-03.braze.com）。含めると、Brazeの統合が機能しなくなります。これは、セグメントがエンドポイントに自動的に https:// を付加するため、Brazeが無効なエンドポイント https://https://sdk.iad-03.braze.com で初期化されてしまうことが原因です。

データマッピングのニュアンス。

データが想定通りに渡されないシナリオ：

  1. 階層化カスタム属性
    • 階層化カスタム属性は技術的にセグメント経由でBrazeに送信できますが、送信のたびにペイロード全体が送信されます。これにより、ペイロードが送信されるたびにネストされたオブジェクトで渡されたキーごとにデータポイントが発生します。

      ペイロード送信時にデータポイントのサブセットのみを消費するには、セグメントが提供するカスタムdestination functions機能を使用できます。セグメントプラットフォームのこの機能により、ダウンストリームの送信先へのデータ送信方法をカスタマイズできます。
  1. サーバー間での匿名データの受け渡し。
    • セグメントのサーバー間ライブラリを使用して、匿名データを他のシステムに送信できます。サーバー間（クラウドモード）統合を通じて external_id なしでBrazeにユーザーを送信する方法の詳細については、マップメソッドのセクションを参照してください。
Braze初期化のカスタマイズ。

Brazeのカスタマイズには、プッシュ、アプリ内メッセージ、Content Cards、初期化などさまざまな方法があります。サイドバイサイド統合では、直接的なBraze統合と同様に、プッシュ、アプリ内メッセージ、Content Cardsをカスタマイズできます。

ただし、Braze SDKが統合されるタイミングのカスタマイズや初期化設定の指定は、困難な場合や不可能な場合があります。これは、セグメントの初期化が行われる際に、セグメントがBraze SDKを初期化するためです。

Brazeへの差分データの送信。

ユーザー属性データを渡す際には、最後の更新以降に変更された属性の値のみを渡していることを確認してください。これにより、不要なデータポイントの記録を防ぐことができます。クライアント側のソースの場合は、セグメントのオープンソースのMiddlewareツールを使用して統合を最適化し、セグメントからの重複する identify() コールをデバウンスしてデータポイント使用量を制限できます。

正しいBrazeデータセンターを使用してください。

セグメントは、サーバー間コールを行うために、Brazeデータセンターを使用して適切なBraze RESTエンドポイント（https://rest.iad-01.braze.com など）を取得します。

セグメントのEvent Tester使用時にカスタムREST APIエンドポイントを削除してください。

セグメントのEvent Testerは、Brazeの /users/track REST APIエンドポイントにイベントを送信しますが、カスタムREST APIエンドポイントが正しく設定されていても、Brazeの送信先設定にカスタムREST APIエンドポイントが設定されていると 401 Invalid API Key エラーをスローします。Event Testerを正しく機能させるには、セグメントでカスタムREST APIエンドポイントの値を削除してください。

新しいソースの設定後は更新に時間をかけてください。

セグメントは設定をキャッシュに長期間保持するため、新しいソースを設定した場合（クラウドモードからデバイスモードへの切り替えなど）、キャッシュが更新されるまでアプリに新しい動作やデータが表示されないことがあります。ソースの追加を計画する際には、この遅延に注意してください。
New Stuff!