主な機能
MoEngage と Adapty の連携では、モバイルサブスクリプションデータの管理とトラッキングに役立つ次の機能を提供します。- 包括的なサブスクリプションライフサイクルのトラッキング : subscription_started、renewal_cancelled、billing_issue_detected、grace_period など、15 を超えるリアルタイムイベントを同期します。
- 収益と税の検証 : net_revenue、tax_amount、proceeds の詳細な内訳を、USD と現地通貨の両方で確認できます。
- ユーザーとアトリビューションの同期 : カスタムユーザー属性、アトリビューションデータ (AppsFlyer など)、サードパーティ連携 ID を自動的に転送します。
- アクセスレベルの管理 : トライアルのコンバージョン、サブスクリプションの一時停止 (Android の場合)、永続アクセスの更新をきめ細かくトラッキングします。
ユースケース
Adapty を MoEngage と連携すると、次のユースケースに役立ちます。- 解約防止と呼び戻し : Subscription Canceled イベントが検出されたときに MoEngage で自動化されたメールまたはプッシュのシーケンスをトリガーし、アクセスが期限切れになる前にユーザーを取り戻します。
- 支払い回復 : Billing Issue イベントを受信したときに、MoEngage の SMS またはプッシュ通知を介して、支払い方法を更新するようユーザーに自動的に促します。
- トライアルコンバージョンの最適化 : Trial Started イベントをトリガーしたユーザーに対して MoEngage でオンボーディングジャーニーを開始し、トライアル終了前にプレミアムの価値をアピールします。
- プレミアムへのアップセル : Subscription Renewed イベントを通じてロイヤルなサブスクライバーを特定し、より上位の年間プラン向けの限定オファーをトリガーします。
連携
開始する前に、次のものがあることを確認してください。
- Webhook を設定するための Adapty の管理者権限。
- API 認証情報を取得するための MoEngage の管理者アクセス権。
- MoEngage サポートから取得した専用の MoEngage 取り込みエンドポイント。
注 : エンドポイントをリクエストする際は、Adapty と MoEngage の間でユーザープロファイルをリンクするために使用する Customer Identifier (例: profile_id または UUID) を指定してください。
ステップ 1: 認証情報を生成する
Adapty が MoEngage にデータを安全に送信するには、Basic 認証トークンが必要です。 認証情報を生成するには、次の手順を実行します。- MoEngage UI で、Settings > Account > APIs に移動します。
- トークンに使用する次の認証情報をコピーします。
- Username : Workspace ID (earlier app id) の下にある ID をコピーします。
- Password : API keys セクションで、Data タイルから API キーをコピーします。

- オンラインの Basic Auth Header Generator (または Postman などのツール) を使用してトークンを生成します。
- Username :
{Your_Workspace_ID} - Password :
{Your_Data_API_Key}
- Username :
ステップ 2: Adapty で Webhook を設定する
Adapty で Webhook を設定するには、次の手順を実行します。- Adapty UI にログインします。
- 左側のナビゲーションメニューで、Integrations をクリックします。
- Server セクションまでスクロールし、webhooks をクリックします。

- Webhook トグルをオンにします。
- 次の設定を行います。

ステップ 3: データとイベントを選択する
接続の詳細を入力した後、データペイロードを設定するには、次の手順を実行します。- Data Options セクションで、次のチェックボックスを選択します。
- Send attribution: 広告ネットワークのデータ (例: AppsFlyer や Adjust) を転送します。
- Send user attributes : カスタムユーザープロファイルデータを転送します。
- Send Play Store purchase token: Android デバイスでの検証に必要です。
- Event Names セクションで、MoEngage でトラッキングする特定のイベント (subscription_started や trial_converted など) を選択します。
- ペインの上部にある Save をクリックして連携を有効にします。

ステップ 4: MoEngage でデータを確認する
Webhook を設定した後、Adapty アプリケーションでテストイベントを生成し、MoEngage UI 内でデータを検証します。 MoEngage でデータを確認するには、次の手順を実行します。- MoEngage UI にログインします。
- 左側のナビゲーションメニューで、Segments > Search Users に移動します。
- Search Users 検索ボックスで、次のいずれかの識別子を使用してテストユーザーを検索します。
- Customer ID
- メールアドレス
- 電話番号

- プロファイルに次の情報が含まれていることを確認します。
- イベント属性 : サブスクリプションイベントの詳細 (例: subscription_started) がイベントセクションに表示されていることを確認します。
- ユーザー属性 : ステップ 3 でユーザー属性の同期を選択した場合は、これらが属性セクションに反映されていることを確認します。
- 最新のインタラクションのタイムスタンプ : 最新のインタラクションのタイムスタンプを確認し、テストイベントの時刻と一致していることを確認します。

レート制限
プラットフォームの安定性を維持するため、MoEngage は Adapty データの取り込みをワークスペースあたり最大 500 リクエスト/秒 (RPS) に制限しています。ワークスペースがこの制限を超えると、MoEngage は HTTP429 (Too Many Requests) ステータスコードを返します。
レート制限がデータフローにどのように影響するかについては、Adapty のデフォルトの再試行ポリシーを参照してください。
再試行の上限到達: Adapty があるデータバッチのすべての再試行を使い切った場合は、Adapty サポートチームに連絡して、失敗したリクエストを再送してもらう必要があります。