セグメント

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

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

• Braze キャンペーンとキャンバスセグメンテーションで使用するために、Segment Engageを Braze に同期する。
• 2つのプラットフォームの間でデータをインポートする。Android、iOS、および Web アプリケーション用のサイドバイサイド SDK 統合と、Braze の REST API にデータを同期するサーバー間統合を提供しています。
• カレントを介してデータをセグメントに接続する。

前提条件

統合

BrazeとSegmentを統合するには、選択した統合タイプ（接続モード）に従って、Brazeを接続先に設定する必要がある。Brazeの新規顧客であれば、セグメントリプレイを使って過去のデータをBrazeにリレーすることができる。次に、Braze と Segment 間のスムーズなデータフローを確保するために、マッピングを設定し、統合をテストする必要があります。

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

ソースの設定が完了したら、各ソース (iOS、Android、Web など) の宛先として Braze を設定する必要があります。接続設定を使用して、BrazeとSegment間のデータフローをカスタマイズする多くのオプションがある。

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

Segment で、[送信先] > [Braze] > [Braze 設定] > [ソースを選択] > [設定] と移動します。

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

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

サイドバイサイドの SDK 統合

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

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

• android
• ios
• web or javascript
• react native

サーバー間統合

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

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

このデータとこれらの機能を使用したい場合は、サイド・バイ・サイド（デバイスモード）SDK統合の使用を検討すること。

Braze Cloud Mode (Actions) destination のソースコードは Segment によって管理されています。

ステップ3:設定

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

• mobile device-mode
• web device-mode
• cloud-mode

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

Brazeは、Pageメソッド、Identifyメソッド、TrackSegmentメソッドをサポートしている。これらのメソッドで使用される識別子の種類は、データがサーバー間統合 (cloud-mode) で送信されるのか、サイドバイサイド (device-mode) で送信されるのかによって異なります。Braze Web Mode Actions 宛先と Cloud Mode Actions 宛先では、Segment エイリアス呼び出しのマッピングを設定することもできます。

Cloud Mode (Actions) 宛先にある Create Alias アクションを使用して、エイリアスのみのユーザーを作成したり、既存の external_id プロファイルにエイリアスを追加したりできます。ユーザーの識別（Identify User）アクションは、エイリアスの作成（Create Alias）アクションと並行して使用することができ、そのユーザーが使用可能になった後、エイリアスのみのユーザーをexternal_id 。

回避策を考案しbraze_id を使用して cloud-mode で匿名ユーザーのデータを送信することもできます。そのため、すべてのSegment APIコールにユーザーのbraze_id を手動で含める必要がある。この回避策の設定方法については、Segmentのドキュメントを参照されたい。

Braze に送信される宛先データは、Cloud Mode Actions 内でバッチ処理できます。バッチサイズの上限は75イベントであり、これらのバッチはフラッシュされる前に30秒間蓄積される。リクエストのバッチ処理はアクションごとに実行されます。たとえば、Identify Calls (属性) が1つのリクエストでバッチ処理され、Track Calls (カスタムイベント) が2番目のリクエストでバッチ処理されます。SegmentからBrazeに送信されるリクエストの数を減らすことができるため、Brazeはこの機能を有効にすることを推奨している。その結果、宛先が Braze のレート制限に達してリクエストを再試行するリスクが減少します。

[Braze Destination] > [Mappings] に移動して、アクションのバッチ処理をオンにできます。そこから、マッピングの右側にある3つのドットのアイコンをクリックし、[Edit Mapping] を選択します。Select mappingsセクションの一番下までスクロールし、Batch Data to Brazeが Yesに設定されていることを確認する。

• identify
• track
• page

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"
      }
    ]
  }
)

ステップ 5: 連携のテスト

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

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

Braze に購入データを送信する場合 (ステップ3 の「Track」タブの「Ｏｒｄｅｒ Completed」を参照)、収益ページで特定の期間の収益や購入に関するデータ、またはアプリの総収益を確認できます。

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

ユーザーの削除と抑制

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

(external_id と同様に) Braze と Segment の間で共通のユーザー識別子を選択する必要があります。Segment で削除リクエストを開始した後は、Segment ダッシュボードの削除リクエストのタブでステータスを確認できます。

Segment のリプレイ機能

Segment は、新しいテクノロジーパートナーに対してすべての履歴データを「再生」するサービスをクライアントに提供しています。関連するすべての履歴データをインポートすることを望む Braze の新しいお客様は、Segment を介してインポートできます。この機能に興味がある場合は Segment の担当者にお問い合わせください。

Segmentが当社の/users/track エンドポイントに接続し、ユーザーに代わってBrazeにユーザーデータをインポートする。

ベストプラクティス