Skip to content

Brazeラーニングコースはじめに：統合の概要

この記事では、オンボーディングプロセスの基本的な概要を説明します。

発見、統合、品質保証、保守という4つの円のベン図。中心に「価値実現までの時間」が配置されています。

技術リソースとして、Brazeを技術スタックに統合することでチームを強化できます。オンボーディングは大きく4つのステップに分けられます。

  • 発見と計画：チームと協力してスコープを調整し、データとCampaignの構造を計画し、適切なワークスペース構造を作成します。
  • 統合：SDKとAPIを統合し、メッセージングチャネルを有効にし、データのインポートとエクスポートを設定することで計画を実行します。
  • 品質保証：Brazeプラットフォームとアプリまたはサイト間のデータとメッセージングのループが期待通りに機能していることを確認します。
  • メンテナンス：Brazeをマーケティングチームに引き渡した後も、すべてがスムーズに実行されるよう引き続き確認します。


発見と計画

このフェーズでは、チームと協力してオンボーディングタスクの範囲を設定し、すべての利害関係者が共通の目標に向けて足並みを揃えていることを確認します。

チームはユースケースのエンドツーエンドの計画を行い、すべてが期待通りに構築でき、そのために適切なデータが利用できることを確認します。このフェーズには、プロジェクトリード、CRMリード、フロントエンドとバックエンドのエンジニアリング、プロダクトオーナー、マーケターが含まれます。

発見と計画のフェーズには、平均して約6週間かかります。エンジニアリングリードはこのフェーズで週に2〜4時間を費やすことが予想されます。製品に携わる開発者は、発見と計画のフェーズで週に10〜20時間をBrazeに費やすことが予想されます。

メール、ショッピングカート、画像、ジオロケーションなど、さまざまなチャネルのアイコン。

Campaign計画

CRMチームは、近い将来に立ち上げるメッセージングのユースケースを計画します。これには以下が含まれます。

例えば、新規顧客向けCampaignは、昨日最初のセッションを記録した顧客のSegmentに毎日午前10時にメールを送信するものです。コンバージョンイベント（成功指標）はセッションの記録です。


データ要件の作成

次に、CRMチームは計画したCampaignを実施するために必要なデータを定義し、データ要件を作成します。

名前、メール、生年月日、国など、多くの一般的なユーザー属性は、Braze SDKが統合された後に自動的に追跡されます。その他のタイプのデータはカスタムデータとして定義する必要があります。

開発者として、チームと協力して追跡する価値のある追加のカスタムデータを定義します。カスタムデータは、ユーザー群がどのように分類され、セグメント化されるかに影響します。成長スタック全体でイベント分類法を設定し、データがBrazeに出入りする際にシステムとの互換性を確保するよう構造化します。

自動収集されたデータとカスタムデータの詳細を参照してください。

カスタマイズの計画

マーケティング担当者に、希望するカスタマイズについて相談してください。例えば、デフォルトのBraze Content Cardsを実装しますか？ブランドガイドラインに合うようにルック＆フィールを少し調整しますか？コンポーネントのためにまったく新しいUIを開発し、Brazeにその分析を追跡させますか？カスタマイズのレベルが異なれば、必要なスコープのレベルも異なります。

ダッシュボードへのアクセス

BrazeダッシュボードはウェブUIインターフェイスです。マーケティング担当者はダッシュボードを使って仕事をし、コンテンツを作成します。開発者はダッシュボードを使い、APIキーやプッシュ通知の認証情報など、アプリを統合するための設定を管理します。

チーム管理者は、ダッシュボードであなた（およびBrazeへのアクセスが必要な他のチームメンバー全員）をユーザーとして追加する必要があります。

ワークスペースとAPIキー

チーム管理者はまた、さまざまなワークスペースを作成します。ワークスペースは、ユーザー、Segments、APIキーなどのデータを1つの場所にグループ化します。ベストプラクティスとして、同じアプリやよく似たアプリの異なるバージョンのみを1つのワークスペースにまとめることをお勧めします。

重要なのは、ワークスペースが複数のプラットフォーム（iOSやAndroidなど）用のAPIキーを提供することです。SDKデータを特定のワークスペースに関連付けるには、対応するAPIキーを使用します。ワークスペースに移動して、各アプリのAPIキーにアクセスしてください。各APIキーがスコープした作業を実行するための正しい権限を持っていることを確認してください。詳細はAPIプロビジョニングの記事を参照してください。

統合

データソースからユーザーデバイスへの情報の流れを表す抽象的なピラミッド図形。

BrazeはiOSアプリ、Androidアプリ、ウェブアプリなどをサポートしています。また、React NativeやUnityのようなクロスプラットフォームのラッパーSDKを使うこともできます。通常、顧客は1〜6週間で統合を完了します。多くの顧客は、技術スキルと帯域幅の広さにもよりますが、たった1人のエンジニアでBrazeを統合しています。これは具体的な統合の範囲と、チームがBrazeプロジェクトに費やす時間に完全に依存します。

以下に精通した開発者が必要です。

  • アプリやサイトのネイティブレイヤーでの作業
  • REST APIにアクセスするプロセスの作成
  • 統合テスト
  • JSONウェブトークン認証
  • 一般的なデータ管理スキル
  • DNSレコードの設定

CDP統合パートナー

多くの顧客は、Brazeのオンボーディングを、統合パートナーとして顧客データプラットフォーム（CDP）とも統合する機会として利用しています。Brazeはデータの追跡と分析を提供し、CDPは追加のデータルーティングとオーケストレーションを提供できます。Brazeは、mParticleやSegmentなど多くのCDPとシームレスに統合できます。

CDPとサイドバイサイドの統合を行う場合は、CDPのSDKからの呼び出しをBraze SDKにマッピングします。基本的に、以下を実行します。

  • 識別呼び出しをchangeUser（Android、iOS、web）にマッピングし、属性を設定します。
  • データフラッシュ呼び出しをrequestImmediateDataFlush（Android、iOS、web）にマッピングします。
  • カスタムイベントや購入を記録します。

選択したプラットフォームによっては、Braze SDKと選択したCDP間の統合例を利用できる場合があります。詳細はCDPテクノロジーパートナーのリストを参照してください。

Braze SDKの統合

Braze SDKは2つの重要な機能を提供します。ユーザーデータを収集し統合されたユーザープロファイルに同期することと、プッシュ通知、アプリ内メッセージ、Content Cardsなどのメッセージングチャネルを強化することです。

SDKの実装では、以下を行います。

  • サポートしたいプラットフォームごとにSDK統合コードを記述します。
  • 各プラットフォームのメッセージングチャネルを有効にし、Braze SDKがメール、SMS、プッシュ通知、その他のチャネルにわたる顧客とのインタラクションのデータを追跡するようにします。
  • 予定されているUIコンポーネントのカスタマイズ（例：カスタムContent Cards）を作成します。完全にカスタム化されたコンテンツの場合、SDKの自動データ収集では新しいコンポーネントを認識できないため、分析のログを取る必要があります。この実装はデフォルトのコンポーネントをパターンとして利用できます。

Braze APIの使用

Brazeを使用している間、さまざまな場面でさまざまなタスクにREST APIを使用します。Braze APIは次のような用途に役立ちます。

  1. 過去のデータをインポートする。
  2. Brazeではトリガーされない継続的な更新。例えば、アプリにログインせずにユーザープロファイルがVIPにアップグレードされる場合、APIはこの情報をBrazeに伝える必要があります。

Braze APIを使い始めましょう。

製品分析の設定

Brazeはデータがすべてです。Brazeのデータはユーザープロファイルに保存されます。

データポイントとは、マーケティング担当者にとって適切なデータを確実に取得するための仕組みであり、単に「どんな」データでも集めればいいというものではありません。データポイントについて理解を深めてください。

レガシーユーザーデータの移行

Brazeの/users/trackエンドポイントを使用して、Brazeの外部で記録された履歴データを移行できます。よくインポートされるデータの例としては、プッシュトークンや過去の購入履歴などがあります。このエンドポイントは、単発のインポートや定期的なバッチ更新に使用できます。

また、ダッシュボードに一度だけCSVをアップロードすることで、ユーザーをインポートし、顧客の属性値を更新することもできます。CSVのアップロードはマーケティング担当者にとって便利ですが、REST APIを使えばより柔軟に対応できます。

セッショントラッキングの設定

Braze SDKは「セッション開始」と「セッション終了」のデータポイントを生成します。また、Braze SDKは定期的にデータをフラッシュします。セッショントラッキングのデフォルト値（いずれもカスタマイズ可能）については、以下のリンクを参照してください（Android、iOS、web）。

カスタムイベント、属性、購入イベントの追跡

カスタムイベント、ユーザー属性、購入イベントなど、計画したデータスキーマを設定するためにチームと調整してください。カスタムデータスキームはダッシュボードを使用して入力され、SDK統合中に実装したものと完全に一致しなければなりません。

その他のツール

ユースケースによっては、他にも設定が必要なツールがある場合があります。例えば、ユーザーストーリーを実現するためにジオフェンスのようなツールを設定する必要がある場合があります。重要な統合ステップを完了した後にこれらの追加ツールをセットアップできる顧客が最も成功していることが明らかになっています。

品質保証

統合を実行する際には、設定したすべてが期待通りに機能していることを確認するため、品質保証を行います。このQAは、データインジェストとメッセージチャネルの2つに大別されます。

Brazeをマーケターに引き継ぐ

プラットフォームやサイトを統合したら、マーケティングチームを関与させてプラットフォームの所有権を引き渡しましょう。このプロセスは企業によって異なりますが、以下のようなものが含まれる場合があります。

未来のために開発する

コードベースを受け継いだが、最初の開発者が何を考えていたのかまったく分からなかったことはありませんか？さらに悪いことに、コードを書いて完全に理解したのに、1年後にそのコードに戻ってきたときにまったく不可解に感じたことはありませんか？

Brazeのオンボーディング時には、データ、ユーザープロファイル、対象となる統合と対象外の統合、カスタマイズの動作方法などに関して下した決断の積み重ねが新鮮に感じられ、それゆえに明白なものとなります。チームがBrazeを拡張したいとき、または他の技術リソースがBrazeプロジェクトに割り当てられたとき、この情報は不明瞭になります。

技術概要セッションで学んだ情報を定着させるためのリソースを作成してください。このリソースは、チームに加わる新しい開発者をオンボードする時間を短縮するのに役立ちます（あるいは、現在のBraze実装を拡張する必要があるときに自分自身へのリマインダーとして役立ちます）。

メンテナンス

マーケターに引き継がれた後も、メンテナンスのためのリソースとしての役割を果たし続けます。Braze SDKに影響を与える可能性のあるiOSとAndroidのアップデートに注意を払い、サードパーティベンダーが最新であることを確認してください。

BrazeのGitHubを使用して、Brazeプラットフォームへの更新を追跡します。時折、緊急アップデートやバグフィックスに関するメールがBrazeから管理者に直接届くこともあります。

SDKレート制限

月間アクティブユーザー数（CY 24-25）、ユニバーサルMAU、Web MAU、モバイルMAU

月間アクティブユーザー数（CY 24-25）、ユニバーサルMAU、Web MAU、モバイルMAUを購入した顧客に対して、Brazeはセッション、ユーザー属性、イベント、その他のユーザープロファイルデータを更新するためにSDKが使用するAPIリクエストに対し、サーバーサイドのレート制限を適用します。これはプラットフォームの安定性を確保し、高速で信頼性の高いサービスを維持するためです。

  • 時間単位のレート制限は、購入した月間アクティブユーザー数（MAU）、業界、季節性、またはその他の要因に対応する、アカウントで予想されるSDKトラフィックに応じて設定されます。時間あたりのレート制限に達すると、Brazeは次の時間までリクエストをスロットルします。
  • すべてのレート制限されたリクエストはSDKによって自動的に再試行されます。
  • SDKリクエストは、実装で収集されるカスタムデータの量と相関します。常に時間あたりのレート制限に近いか、制限に達している場合は、以下を検討してください。
    • SDKの統合を見直し、過剰なデータ収集を減らす。
    • マーケティングのユースケースに不可欠でないカスタムデータをブロックリスト化する。
  • バーストレート制限とは、非常に短時間（つまり数秒以内）に大量のリクエストが到着した場合に適用される、短時間のレート制限です。バースト制限が発生してもアクションを起こす必要はなく、SDKは直後に再試行します。
  • 定常レート制限は、バーストウィンドウよりも長いローリングウィンドウ（例えば数分間）における持続的なリクエスト量をコントロールし、バースト制限と時間単位のレート制限の間で継続的なトラフィックを平滑化するのに役立ちます。

レート制限の確認

予想されるSDKスループットに基づく現在の制限を確認するには、設定 > APIキー > APIとSDKの制限に進みます。

過去の使用状況については、設定 > APIキー > APIとSDKのダッシュボードを参照してください。

より高いレート制限のリクエスト

より高いBrazeレート制限が必要な場合は、Brazeサポートまたはカスタマーサクセスマネージャーに連絡し、以下の詳細を記載してください。

  • 一時的な増加か恒久的な増加か。
  • 増加が必要な理由。
  • 影響を受けるエンドポイントと環境。
  • おおよそのトラフィック量とスケジュール（開始日、期間、ピーク時間帯を含む）。
  • 呼び出しをバッチ処理できるか、またはトラフィックを時間をかけて分散できるか。

リクエストを送信した後、Brazeが確認し、結果をお知らせします。

変更とサポート

Brazeは、システムの安定性を保護するため、またはアカウントのデータスループットを向上させるために、レート制限を変更することがあります。レート制限に関するご質問やご不明な点、レート制限がビジネスに与える影響については、Brazeサポートまたはカスタマーサクセスマネージャーまでお問い合わせください。
New Stuff!