はじめに：統合の概要

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

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

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

発見と計画

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

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

ディスカバリーとプランニングの段階には、平均して約6週間かかる。このフェーズでは、開発リードは週に2～4時間を費やすことが予想されます。この製品に携わる開発者は、発見と計画の段階では、週に10〜20時間をBrazeに費やすと予想される。

キャンペーン計画

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

• チャンネル（例えば、プッシュ通知やアプリ内メッセージなど）
• 配信方法(例えば、スケジュールされた配信やアクションベースの配信など)
• ターゲットオーディエンス
• 成功の指標

例えば、新規顧客キャンペーンは、毎日午前10時に昨日最初のセッションを記録した顧客のセグメントにメールを送信します。コンバージョンイベント（成功指標）はセッションを記録している。

データ要件を作成する

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

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

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

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

カスタマイズの計画

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

ダッシュボードにアクセスする

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

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

ワークスペースとAPIキー

チーム管理者はまた、さまざまなワークスペースを作成します。ワークスペースは、ユーザー、セグメント、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 はデータの追跡と分析を提供し、顧客データプラットフォームは追加のデータルーティングとオーケストレーションを提供できます。Braze は、mParticle や Segment など多くの顧客データプラットフォームとシームレスに統合できます。

顧客データプラットフォームとサイドバイサイドの統合を行う場合は、顧客データプラットフォームの SDK からの呼び出しを Braze SDK にマッピングします。基本的に、次を実行します。

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

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

Braze SDKの統合

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

SDKの実装では、以下のことを行う：

• サポートしたいプラットフォームごとにSDK統合コードを書く。
• 各プラットフォームのメッセージングチャネルを有効にし、Braze SDKがEメール、SMS、プッシュ通知、その他のチャネルにわたる顧客とのインタラクションのデータを追跡するようにする。
• 予定されている UI コンポーネントのカスタマイズ (例えば、カスタムコンテンツカード) を作成します。完全にカスタム化されたコンテンツの場合、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つに大別されます。

QA データの取り込み	QA メッセージング
データのインジェスト、保存、エクスポートの方法について品質保証を行います。	メッセージがユーザーに正しく送信され、すべてが素晴らしく見えることを確認できるだろう。
データが正しく保存されていることを確認するためにテストを実行する。	ユーザーのセグメントを作成する。
セッションデータがBraze内の意図したワークスペースに正しく帰属していることを確認する。	キャンペーンとキャンバスを正常に起動します。
セッションの開始と終了が記録されていることを確認する。	正しいキャンペーンが正しいユーザーセグメントに表示されていることを確認する。
ユーザー属性情報がユーザープロファイルに対して正しく記録されていることを確認する。	プッシュトークンが正しく登録されていることを確認する。
ユーザープロファイルに対してカスタムデータが正しく記録されていることをテストする。	プッシュトークンが正しく取り除かれていることを確認する。
匿名ユーザープロファイルを作成する。	プッシュキャンペーンがデバイスに正しく送信され、エンゲージメントが記録されているかテストする。
changeUser() メソッドが呼び出されたときに、匿名ユーザープロファイルが既知のユーザープロファイルになることを確認します。	アプリ内メッセージが配信され、メトリクスが記録されることをテストする。
	コンテンツカードが配信され、メトリクスが記録されていることをテストする。
	コネクテッド・コンテンツを促進する（例えば、AccuWeather）。
	すべてのメッセージチャネルの統合が正しく機能していることを確認する。

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

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

• 複雑な Liquid ロジックを構成する
• メールの IP ウォームアップを容易にする
• 他の利害関係者に追跡されるデータの種類を理解させる

未来のために開発する

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

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

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

メンテナンス

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

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