
はじめに
こんにちは、株式会社エブリーでデリッシュキッチンのiOSアプリの開発をしている成田です。 現在は、プレミアムユーザーの登録数の向上やプレミアムユーザーの体験をより良くすることを目的としたチームで開発をしています。
サブスクリプションの解約は、これまで開発者にとってブラックボックスでした。ユーザーが App Store の管理画面で「サブスクリプションをキャンセルする」を押すとき、アプリ側にできることは何もありません。引き止めのメッセージも、オファーの提示も、そもそも解約されようとしていることを知ることさえ、その瞬間にはできませんでした。
WWDC26 で発表された Retention Messaging は、ここに初めて介入手段を与える機能です(セッション309)。解約確認画面に、アプリからのメッセージやオファーを差し込めるようになります。
Appleによれば、この機能を導入したサブスクリプションでは、解約を取りやめて利用を継続するユーザーの割合が改善されているとのことです。解約抑止にも取り組む立場としては、無視できない機能です。
まだ一般提供はされていませんが、具体的に何ができるのか、どう始めればよいのか、現時点で分かっていることを整理します。
何ができるのか
ユーザーが App Store のサブスクリプション管理から解約しようとすると、確認画面が出ます。Retention Messaging を設定しておくと、この画面にアプリからのコンテンツが表示されます。
表示できる形式は3つです。
| 形式 | 内容 |
|---|---|
| メッセージのみ | ローカライズ済みの引き止め文言 |
| メッセージ + 画像 | テキストメッセージに Asset Library 等から設定した画像を添えて訴求 |
| メッセージ + オファー | 割引や無料期間付きなどのオファーを提示する |
ユーザーがオファーの対象である場合、オファーの表示が画像を置き換えます。「解約する前に、3ヶ月無料で続けられるオファーがあります」のような画面を、Apple の解約フローの中に出せるわけです。この画面は App Store 側が描画するもので、公式ドキュメントによれば iOS 15.1 以上で利用できます。アプリの最低対応バージョンと関係なく届くのは、地味に嬉しいところです。 オファーが引き換えられたかどうかはサーバー側で確認できます。署名付きトランザクションに新しいオファー種別が入ります。
{ "offerType": 5, "offerIdentifier": "Yoga_2026_cancel_free_3m", "offerDiscountType": "FREE_TRIAL", "offerPeriod": "P3M" }
offerType はトランザクションに「どの種類のオファーが絡んだか」を刻むフィールドで、これまで4種類あったものに追加で Retention Offer が加わった形です。
| offerType | 種類 |
|---|---|
| 1 | お試し |
| 2 | プロモーション |
| 3 | オファーコード |
| 4 | 再獲得 |
| 5 | Retention Offer |
メッセージを用意する方法は2つある
ここまでが主に「解約確認画面に何が出るか」の話です。次は、その表示をアプリ側がどう用意するかです。 方法は2つあって、手軽さが大きく違います。App Store Connect で設定するだけの方法と、自前のサーバーを立てて顧客ごとにリアルタイムで出し分ける方法です。順に見ていきます。
方法1: App Store Connect 側での設定
App Store Connect 上でメッセージ・画像・オファーを設定し、対象のサブスクリプションにマッピングするだけです。自前のサーバー実装は不要で、Apple 側が表示を担います。
流れはこうです。
- ローカライズ済みのメッセージ文言を作る
- 任意で Asset Library の画像、Retention Offer を添える
- 1つ以上のサブスクリプションにマップする
- Sandbox 環境でテストして公開
方法2: リアルタイム API 型(ユーザーごとの出し分け)
方法1の弱点は、全員に同じものしか出せないことです。
新しく発表された Retention Messaging API を使うと、「誰に・何を出すか」を自社のデータで決められるようになります。
誤解しやすい点を先に書いておくと、解約の理由そのものが Apple から届くわけではありません。リクエストに入っているのは「誰の契約か(originalTransactionId)」までです。ただ、この ID で自社のユーザーデータを引けば、手持ちの情報が使えます。例えば、購読してからどれぐらいか、最後にアプリを開いたのはいつか、月額プランか年額プランか、過去にオファーで引き止めたことがあるかなどがあるでしょう。
理由そのものは分からなくても、こうしたデータから仮説は立てられます。
出し分けのロジックが自前のサーバーにあることで A/B テストでの検証も可能になるはずなので、その仮説を検証することもできそうです。
次に、仕組みを見ていきます。 Retention Messaging API を使うと、解約操作が起きたまさにその瞬間に、App Store から自前のサーバーへ問い合わせが来ます。
// App Store からのリクエスト { "originalTransactionId": "123456789", "appAppleId": 6745974591, "productId": "Yoga_summer_2026", "userLocale": "en-US", "requestIdentifier": "c03248af-dd76-4e9b-9c1e-4489cd19a768", "environment": "Production", "signedDate": 1780920000000 }
これに対して、このユーザーに何を出すかを返します。返せる応答は3種類です。
① メッセージ
{ "message": { "messageIdentifier": "551ee7c0-..." } }
② プラン切替の提案(alternateProduct)
{ "alternateProduct": { "messageIdentifier": "ed7f25fc-...", "productId": "Yoga_summer_2026_annual" } }
同じサブスクリプショングループ内の別プランへの乗り換えを提案できます。「月額×12ヶ月コミット」の新プランタイプとも連動していて、たとえば年額プランを解約しかけた人に「月額の12ヶ月コミットなら続けやすいですよ」という導線が作れたりしそうです。
③ プロモーショナルオファー
{ "promotionalOffer": { "messageIdentifier": "80135e2b-...", "promotionalOfferSignatureV2": "eyJhbGciOiJFUzI…" } }
プロモーショナルオファーは、開発者が特定のユーザーだけに提供できる限定オファーです。 対象ユーザー以外には利用されないように、開発者のサーバーが秘密鍵を使って「このユーザーに、このオファーを適用してよい」という署名を発行します。アプリはこの署名を使って、オファーが正しく発行されたものかを確認します。 promotionalOfferSignatureV2 は、このデジタルな許可証を標準的な形式である JWS(JSON Web Signature) で表現する新しい仕様です。
ところで、ここまでの応答例が messageIdentifier という ID しか返していないことに気づいたでしょうか。メッセージの文言や画像の実体は、あらかじめ Apple に登録しておく設計になっています。解約フローの真っ最中に文言ごと送るのではなく、実体は事前登録しておいて、その場では「どれを出すか」を ID で選ぶだけです。
この事前登録を担うのが、管理用のエンドポイント群です。メッセージや画像の登録のほか、リアルタイム問い合わせの受け口 URL の設定、性能テストの実行もここで行います。
POST /messages // メッセージ登録
GET /messages // 登録済み一覧
DELETE /messages/{messageId} // 削除
POST /images // 画像登録
GET /images
DELETE /images/{imageId}
POST /defaultMessages // デフォルトメッセージ設定
GET /defaultMessages/{productId}/{locale}
DELETE /defaultMessages/{productId}/{locale}
POST /realtimeUrl // 受け口URLの設定
GET /realtimeUrl
DELETE /realtimeUrl
POST /performanceTests // 性能テスト
GET /performanceTests/{testId}
フォールバックは段階的
リアルタイム応答が使えない・不正な場合は App Store Connect で設定されたものに、それも無ければ API で設定したデフォルトメッセージにフォールバックされます。 また、Sandbox には自社サーバーの応答性能を測るためのテスト用エンドポイントが用意されています。解約フローの中で同期的に呼ばれる API なので、応答が遅ければ体験を壊します。本番前にここで確認しておく、という建て付けだと理解しています。
まとめ
- Retention Messaging は、解約確認画面という最後の接点に初めて介入できる機能
- 用意する方法は2つ。サーバー不要の App Store Connect 設定型と、ユーザーごとに出し分けるリアルタイム API。フォールバックも整理されている
- 返せるのはメッセージ、プラン切替提案、プロモオファーの3種
- メッセージや画像の実体は事前登録しておき、リアルタイム応答では ID で選ぶだけ。Sandbox には応答性能のテスト用エンドポイントも用意されている
解約はこれまで、起きてから初めて知るものでしたが、今回からは解約を思いとどまってもらうための施策を、解約のタイミングに合わせて出せるようになります。サブスクリプションを運営しているチームは、サービス提供が始まる前に、どんなメッセージを出すか、どんなオファーを用意するかを検討しておくとよさそうです。