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 | ユーザーがサンドボックス環境または本番環境のどちらで操作しているかを示します。 値は |
store | String | 購入に使用したストアの名前を含みます。 設定可能な値：
|
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 | 購入または更新の最新の期間タイプを示します。 設定可能な値： トライアル期間の場合は |
すべてのfloat値はintに丸められます。文字列はそのまま維持されます。
定義済みのタグリストに加えて、タグを使ってカスタム属性を送信することも可能です。これにより、タグに含めるデータの種類の柔軟性が高まり、プロダクトやサービスに関連する特定の情報の追跡に役立ちます。すべてのカスタムユーザー属性は、ユーザーが統合ページの Send user attributes チェックボックスをオンにすることで、自動的にBrazeに送信されます。
SDK の設定
Adapty と Braze のユーザープロファイルを連携するには、Braze SDK を Adapty と同じカスタマーユーザー ID で設定するか、.changeUser() メソッドを使用します。
トラブルシューティング
access_level_updated がイベントフィードで失敗として表示される
access_level_updated は webhook 専用イベントです。Adapty はこのインテグレーションにこのイベントを送信しません。ただし、Adapty は有効なすべてのインテグレーションに対して結果を記録するため、サポートされていないイベントは失敗として表示されます。