Braze

トップクラスのカスタマーエンゲージメントソリューションのひとつである Braze は、プッシュ通知、メール、SMS、アプリ内メッセージングなど幅広いツールを提供しています。AdaptyとBrazeを統合することで、すべてのサブスクリプションイベントを一箇所で確認でき、それらのイベントをもとに自動コミュニケーションをトリガーできます。

Adaptyは、すべてのストアからのサブスクリプションイベントを一元管理できる完全なデータセットを提供しており、Brazeのユーザープロファイルの更新に活用できます。Adaptyを使えば、サブスクライバーの行動を把握し、好みを把握して、ターゲットを絞った効果的なコミュニケーションに役立てることができます。この統合により、Brazeダッシュボードでサブスクリプションイベントを追跡し、獲得キャンペーンと紐付けることが可能になります。

Adaptyはサブスクリプションイベントやユーザープロパティ、購入情報をBrazeに送信するため、以下に説明する簡単な統合を行うだけで、Brazeのプッシュ通知を使った顧客向けターゲットコミュニケーションを構築できます。

Braze統合のセットアップ方法

Brazeを統合するには、Integrations → Braze に移動してトグルをオンにし、各フィールドを入力してください。

統合の最初のステップは、BrazeとAdaptyのプロファイルを接続するために必要な認証情報を提供することです。統合を正しく動作させるには、REST API Key、Braze Instance ID、そしてiOSとAndroidのApp IDが必要です：

REST API Key は Braze Dashboard → Settings → API Keys で作成できます。作成時にキーに users.track 権限が付与されていることを確認してください：

Braze Instance ID を取得するには、BrazeダッシュボードのURLを確認し、インスタンスIDが記載されている Braze Docs のセクションを参照してください。US-03、EU-01などの地域形式になっています。
iOSおよびAndroidのApp IDは、Braze Dashboard → Settings → API Keys でも確認できます。こちらからコピーしてください：

イベント、ユーザー属性、購入

認証情報の下には、AdaptyからBrazeに送信できるイベントが3つのグループで表示されています。必要なものをオンにするだけです。Brazeへの送信に合わせてイベント名を変更することもできます。Adaptyが提供するイベントの完全なリストはこちらで確認できます：

Adaptyはサブスクリプションイベントとユーザー属性をサーバー間統合でBrazeに送信するため、Brazeダッシュボードで確認してキャンペーンを設定できます。

トライアル転換や更新など収益が発生するイベントについては、Adaptyはその情報を購入としてBrazeに送信します。

Brazeに送信されるイベントプロパティの完全な仕様はこちらをご覧ください。

便利なユーザー属性

AdaptyはBraze統合のためにデフォルトでいくつかのユーザー属性を送信します。ニーズに最適なものを判断するために、以下のリストを参照してください。

ユーザー属性	型	値
`adapty_customer_user_id`	String	お客様が定義したユーザーの一意識別子の値を含みます。AdaptyのダッシュボードとBrazeの両方で確認できます。
`adapty_profile_id`	String	Adaptyのユーザープロファイルの一意識別子（Adapty User Profile ID）の値を含みます。Adaptyのダッシュボードで確認できます。
`environment`	String	ユーザーがサンドボックス環境または本番環境のどちらで操作しているかを示します。値は `Sandbox` または `Production` のいずれかです。
`store`	String	購入に使用したストアの名前を含みます。設定可能な値： `app_store` または `play_store`
`vendor_product_id`	String	Apple/GoogleストアのプロダクトIDの値を含みます。例：org.locals.12345
`subscription_expires_at`	String	最新のサブスクリプションの有効期限を含みます。値のフォーマット： YYYY-MM-DDTHH:mm:ss.SSS+TZ 例：2023-02-15T17:22:03.000+0000
`active_subscription`	String	購入・更新イベント時に `true`、サブスクリプションが期限切れの場合は `false` に設定されます。
`period_type`	String	購入または更新の最新の期間タイプを示します。設定可能な値：トライアル期間の場合は `trial`、それ以外は `normal`

すべてのfloat値はintに丸められます。文字列はそのまま維持されます。

定義済みのタグリストに加えて、タグを使ってカスタム属性を送信することも可能です。これにより、タグに含めるデータの種類の柔軟性が高まり、プロダクトやサービスに関連する特定の情報の追跡に役立ちます。すべてのカスタムユーザー属性は、ユーザーが統合ページの Send user attributes チェックボックスをオンにすることで、自動的にBrazeに送信されます。

SDK設定

AdaptyとBrazeのユーザープロファイルを紐付けるには、Braze SDKをAdaptyと同じカスタマーユーザーIDで設定するか、.changeUser() メソッドを使用する必要があります：

let braze = Braze(configuration: configuration)
braze.changeUser(userId: "adapty_customer_user_id")

Braze.getInstance(context).changeUser("adapty_customer_user_id")