Braze

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

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

Adaptyは、サブスクリプションイベント、ユーザープロパティ、購入情報をBrazeに送信します。以下の簡単な手順でインテグレーションを設定すると、Brazeのプッシュ通知を活用してターゲットを絞ったユーザーコミュニケーションを構築できます。

Braze インテグレーションの設定方法

Adapty と Braze を連携するには、Adapty ダッシュボードで Integrations → Braze を開き、トグルをオンにして認証情報を入力します。

REST API key と Braze Instance ID は必須です。
iOS App ID と Android App ID は任意です。

REST API キーを作成するには、Braze ダッシュボードで Settings → APIs and Identifiers に移動し、Create API Key をクリックします。ユーザーデータのパーミッションで users.track を選択してください。Braze では、作成後にキーのパーミッションを変更できないため、users.track のないキーは新しいキーに置き換える必要があります。詳細については、Braze ドキュメントの Creating REST API keys を参照してください。
Braze インスタンス ID を確認するには、Braze ダッシュボードの URL を Braze ドキュメントの instance table と照合してください。インスタンス ID は US-03 や EU-01 のような地域形式です。たとえば、dashboard-03.braze.com は US-03 です。
iOS App ID と Android App ID を確認するには、Braze ダッシュボードで Settings → APIs and Identifiers → App Identifiers に移動します。各アプリの Identifier 列の値をコピーしてください。詳細については、Braze ドキュメントの App identifier を参照してください。

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

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

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

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

Warning

Adapty は収益をBrazeにレガシー購入イベントとしてのみ送信します。Brazeはレガシー購入イベントをメンテナンスモードに移行しており、新規顧客に対しては有効化していません。ご利用のBrazeワークスペースがレガシー購入イベントを受け付けない場合、Brazeは収益を含むすべてのイベントをHTTP 400およびLegacy purchase ingestion is disabledというメッセージで拒否します。初回購入、更新、トライアルコンバージョン、返金などのイベントは、収益だけでなくイベント自体がBrazeに届きません。

インテグレーションを有効にする前に、Braze ワークスペースがレガシー購入イベントを受け入れるように設定されていることを確認してください。詳細については、Braze ドキュメントの購入イベントを参照してください。

こちらで、Braze に送信されるイベントプロパティの完全な仕様を確認できます。

Note

便利なユーザー属性

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

トラブルシューティング

`access_level_updated` がイベントフィードで失敗として表示される

access_level_updated は webhook 専用イベントです。Adapty はこのインテグレーションにこのイベントを送信しません。ただし、Adapty は有効なすべてのインテグレーションに対して結果を記録するため、サポートされていないイベントは失敗として表示されます。