チュートリアル: トリガーメッセージの延期と復元
このチュートリアルのサンプルコードに従って、Braze SDKを使用してトリガーされたアプリ内メッセージを延期および復元する方法を学びます。
前提条件
この機能を使用する前に、Web Braze SDKを統合する必要がある。 ただし、追加の設定は不要です。
Webのトリガーメッセージの延期と復元
1. automaticallyShowInAppMessages() の呼び出しを削除する {#1-remove-calls-to-automaticallyshowinappmessages}
後で実装するカスタムロジックをオーバーライドしてしまうため、automaticallyShowInAppMessages() のすべての呼び出しを削除します。
2. デバッグを有効にする（オプション） {#2-enable-debugging-optional}
開発中のトラブルシューティングを容易にするために、デバッグを有効にすることを検討してください。
3. アプリ内メッセージコールバックハンドラーにサブスクライブする {#3-subscribe-to-the-in-app-message-callback-handler}
subscribeToInAppMessage(callback) を使用してコールバックを登録し、アプリ内メッセージがトリガーされるたびにメッセージを受信します。
4. message インスタンスを延期する {#4-defer-the-message-instance}
メッセージを延期するには、deferInAppMessage(message) を呼び出します。Brazeはこのメッセージをシリアライズして保存し、将来のページ読み込み時に表示できるようにします。
5. 以前に延期されたメッセージを取得する {#5-retrieve-a-previously-deferred-message}
以前に延期されたメッセージを取得するには、getDeferredInAppMessage() を呼び出します。
6. 延期されたメッセージを表示する {#6-display-the-deferred-message}
延期されたメッセージを取得したら、showInAppMessage(message) にメッセージを渡して表示します。
7. メッセージをすぐに表示する {#7-display-a-message-immediately}
メッセージを延期するのではなくすぐに表示するには、subscribeToInAppMessage コールバックで showInAppMessage(message) を直接呼び出します。
前提条件
この機能を使用する前に、Android Braze SDKを統合する必要がある。 また、Androidのアプリ内メッセージを有効にする必要もあります。
Androidのトリガーメッセージの延期と復元
1. シングルトン Application インスタンスを作成する {#1-create-a-singleton-application-instance}
コンパニオンオブジェクトを使って Application クラスをシングルトンとして公開し、コード内で後からアクセスできるようにします。
2. デバッグを有効にする（オプション）
開発中のトラブルシューティングを容易にするために、デバッグを有効にすることを検討してください。
3. アクティビティライフサイクルコールバックを登録する {#3-register-activity-lifecycle-callbacks}
アプリ内メッセージのライフサイクルを処理するBrazeのデフォルトリスナーを登録します。
4. アプリ内メッセージリスナーを設定する {#4-set-up-an-in-app-message-listener}
BrazeInAppMessageManager を使用して、メッセージが表示される前にインターセプトするカスタムリスナーを設定します。
5. 条件付きロジックを作成する {#5-create-conditional-logic}
タイミングを制御するには showMessage フラグを使用します—メッセージをすぐに表示する場合は DISPLAY_NOW を返し、延期する場合は DISPLAY_LATER を返します。
6. 延期メッセージを表示するメソッドを作成する {#6-create-a-method-for-displaying-deferred-messages}
showDeferredMessage を使って次のアプリ内メッセージをトリガーします。showMessage が true の場合、リスナーは DISPLAY_NOW を返します。
7. UIからメソッドをトリガーする {#7-trigger-the-method-from-your-ui}
以前に延期されたメッセージを表示するには、ボタンやタップなどのUIから showDeferredMessage(true) を呼び出します。
前提条件
この機能を使う前に、Swift Braze SDKを統合する必要がある。 また、Swiftのアプリ内メッセージを有効にする必要もあります。
Swiftのトリガーメッセージの延期と復元
1. BrazeInAppMessageUIDelegate を実装する {#1-implement-the-brazeinappmessageuidelegate}
AppDelegate クラスで BrazeInAppMessageUIDelegate を実装して、後で inAppMessage メソッドをオーバーライドできるようにします。
2. デバッグを有効にする（オプション）
開発中のトラブルシューティングを容易にするために、デバッグを有効にすることを検討してください。
3. Braze UIとデリゲートを設定する {#3-set-up-your-braze-ui-and-delegate}
BrazeInAppMessageUI() はデフォルトでアプリ内メッセージをレンダリングします。self をデリゲートとして割り当てることで、メッセージが表示される前にインターセプトして処理できます。インスタンスは必ず保存してください。後で延期したメッセージを復元するときに必要になります。
4. DisplayChoice を条件付きロジックでオーバーライドする {#4-override-displaychoice-with-conditional-logic}
メッセージを表示するタイミングを決定するには、inAppMessage(_:displayChoiceForMessage:) をオーバーライドします。すぐに表示する場合は .now を返し、後で表示する場合は .reenqueue を返します。
5. 延期メッセージを表示するメソッドを作成する {#5-create-a-method-to-show-deferred-messages}
showDeferredMessage(true) を呼び出してスタック内の次の延期メッセージを表示するメソッドを作成します。呼び出されると showMessage が true に設定され、デリゲートは .now を返します。
6. UIからメソッドをトリガーする {#5-trigger-the-method-from-your-ui}
以前に延期されたメッセージを表示するには、ボタンやタップなどのUIから showDeferredMessage(true) を呼び出します。