Apple Pay
Apple Payは、顧客がRokt配置内で直接Apple Payを使用してShoppable Ads購入を完了できるようにします。Rokt SDKはApple Payセッションの作成、支払いシートの表示、および支払い処理を担当します。Rokt Catalogブランドが記録上の販売者（MoR）です。
Apple PayはWebおよびiOSでサポートされており、追加のプラットフォームサポートが計画されています。
シーケンス概要シーケンス概要 への直接リンク
- 配置が読み込まれます。 顧客が取引を完了した後、Rokt Shoppable Ads配置が確認ページに表示されます。
- 適格性チェック。 Rokt SDKは、Apple Payが顧客のデバイスで利用可能かどうかを判断します。サポートされていない場合、配置は他の適格な支払い方法（例：カード転送）にフォールバックします。
- オファーが表示されます。 配置は、利用可能な支払い方法に基づいて適切な支払いCTAを含むオファーを表示します。
- 顧客が「Apple Payで支払う」をタップします。 Apple Pay支払いシートが表示され、アイテムの詳細、価格（税金と送料を含む）、およびブランドの販売者名が示されます。
- 顧客が承認します。 顧客はFace ID、Touch ID、またはデバイスのパスコードで認証します。
- 支払いが処理されます。 Roktは、ブランドをMoRとして支払いを処理します。配置内に確認画面が表示されます。
- 配置が閉じます。 パートナーの標準的な確認後のフローが続行されます。
注: 適格なオファーが利用できない場合、またはサポートされている支払い方法が検出されない場合、配置はオファーを表示せずに閉じます。
必須属性必須属性 への直接リンク
Apple Payは、SDK初期化時に渡される標準属性を使用します。完全なリストについては、SDK統合ガイドの推奨属性を参照してください。
Apple Pay支払い方法の選択には、次の属性が使用されます：
| 属性 | タイプ | 必須 | 説明 |
|---|---|---|---|
| payment_type | string | Yes | 顧客が元の取引で使用した支払い方法（例：visa, mastercard, amex, apple_pay, paypal）。Roktはこれを使用して支払い方法の優先順位を決定します。顧客がApple Payで支払った場合、それが主要なCTAとして表示されます。 |
注: プラットフォームに配送先住所の詳細が利用できない場合（例：チケットまたはデジタル商品購入）、代わりに請求先住所の詳細を渡してください。Roktは、購入を完了する前に顧客が配送先住所を確認または編集するためのUIを提供します。
Web setupWeb setup への直接リンク
Roktは、Apple Payのドメイン登録、マーチャント設定、および支払い処理をエンドツーエンドで管理します。SDK+を使用するパートナーは追加の設定は不要です。レガシーSDKを使用しているパートナーは、以下に説明されているようにApple Pay拡張機能を有効にする必要があります。
SDK拡張機能（レガシーSDKのみ）SDK拡張機能（レガシーSDKのみ） への直接リンク
レガシーRokt Web SDK (launcher.js)を使用している場合は、SDKスクリプトを読み込む際にpayments-stripe-applepayをextensionsクエリパラメータに追加してください。また、カード転送を使用している場合は、両方の拡張機能を含めてください：
script.src = "https://apps.rokt.com/wsdk/integrations/launcher.js?extensions=instant-purchase,payments-stripe-applepay";
payments-stripe-applepay- Shoppable Ads配置でApple Payを支払い方法として有効にします。instant-purchase- Shoppable Ads配置でカード転送を支払い方法として有効にします。
注意: SDK+（バージョン2.5926.0以降）を使用している場合、拡張機能は自動的に有効になり、スクリプトの変更は必要ありません。
ブラウザとデバイスの互換性ブラウザとデバイスの互換性 への直接リンク
| ブラウザ | プラットフォーム | Apple Payサポート | 備考 |
|---|---|---|---|
| Safari 17+ | iOS 17+, macOS 12+ | サポート済み | ネイティブApple Pay。 |
| Safari (古いバージョン) | iOS, macOS | 制限あり | 同一オリジンのみ。 |
| Chrome | iOS | サポート済み | Apple PayはiOS上でデバイスベースです。Safariと同様に動作します。 |
| Chrome | デスクトップ (macOS) | サポートされていません | Roktは他の支払い方法にフォールバックします。 |
| Chrome / Firefox | Windows, Android | サポートされていません | Roktは他の支払い方法にフォールバックします。 |
Roktはブラウザとデバイスの互換性を自動的に検出し、Apple Payボタンをサポートされている場所にのみ表示します。パートナーからの追加のゲーティングロジックは必要ありません。
注意: Shoppable Ads配置は通常、ページ上に直接レンダリングされ、iframe内ではありません。これはApple Payが正しく機能するために必要です。統合がRokt配置をiframe内にレンダリングする場合は、追加の設定要件についてRoktのアカウントマネージャーにお問い合わせください。
iOS設定iOS設定 への直接リンク
以下の手順は、iOSベースの統合（ネイティブiOS、React Native、Flutterなど）でApple Payを設定します。これらの手順を完了した後、SDK統合ガイドに戻り、支払い拡張機能を登録してください。
マーチャントIDの作成マーチャントIDの作成 への直接リンク
- Apple Developer Portalにサインインします。
- Identifiersの下で、ドロップダウンからMerchant IDsを選択します。
- 新しいマーチャント識別子を登録するために**+**ボタンをクリックします。
- 説明（例："Rokt Apple Pay"）とRoktに専用のユニークな識別子（例：
merchant.com.yourapp.rokt）を入力します。 - Continueをクリックし、その後Registerをクリックします。
Rokt専用の新しいマーチャントIDを作成してください。アプリがすでに独自のチェックアウトでApple Payを使用している場合、そのマーチャントIDを再利用しないでください。各マーチャントIDは1つの支払い処理証明書のみをサポートしており、RoktのCSRをアップロードすると既存の証明書が上書きされます。
詳細については、AppleのApple Payの設定ガイドを参照してください。
XcodeでApple Payを有効にするXcodeでApple Payを有効にする への直接リンク
- Xcodeでプロジェクトを開き、アプリのターゲットを選択します。
- Signing & Capabilities タブに移動します。
- + Capability をクリックし、Apple Pay を追加します。
- 作成したマーチャントID（例:
merchant.com.yourapp.rokt）をリストから選択します。
マーチャントIDが表示されない場合は、Apple DeveloperアカウントがXcodeのSettings > Accountsでリンクされていることを確認してください。
支払い処理証明書を生成する支払い処理証明書を生成する への直接リンク
- Roktから証明書署名要求（CSR）をリクエストします — RoktアカウントマネージャーがStripeから生成されたCSRを提供します。
- Apple Developer Portalで、マーチャントIDを選択します。
- Apple Pay Payment Processing Certificate の下で、Create Certificate をクリックします。
- Roktから提供されたCSRファイルをアップロードします。
- 生成された
.cerファイルをダウンロードし、Roktアカウントマネージャーと共有します。
支払い処理証明書は25ヶ月ごとに期限が切れます。Appleは期限切れのリマインダーをApple Developerアカウントのメールに送信します。更新時には、新しいCSRをRoktアカウントマネージャーにリクエストし、上記の手順を繰り返してください。
チェックリストチェックリスト への直接リンク
WebWeb への直接リンク
- レガシーSDKを使用している場合:
payments-stripe-applepayをextensionsクエリパラメータに追加 -
payment_type属性がすべてのRoktエクスペリエンス起動時に渡される - Safari 17+（iOSまたはmacOS）でのエンドツーエンドテストが完了
iOSiOS への直接リンク
- Apple Developer PortalでマーチャントIDが作成されている
- Xcodeで正しいマーチャントIDを使用してApple Pay機能が追加されている
- 支払い処理証明書が生成され、Roktと共有されている
- SDK統合で支払い拡張が登録されている（SDKガイドを参照：iOS | React Native）
- 物理的なiOSデバイスでのエンドツーエンドテストが完了