トリガー:タイミングはアプリが決める \
トリガーとは、アプリが設定するキーと値です。それに一致するよう設定されたアプリ内メッセージが表示されます。Clean Beansのすべての画面にはヘッダーにヘルプボタンがあり、画面名を値としてトリガーを1つ設定します。src/components/HelpButton.tsx
app/(tabs)/_layout.tsx

ダッシュボードのヘルプボタンをタップするとヘルプオーバーレイが表示されます。
help_topic is dashboardのメッセージを作成し、画面ごとに繰り返します。複数ステップのウォークスルーは、同じトリガーとカルーセルレイアウトを使います。

カードのカルーセルとして作成した複数ステップのウォークスルー。
カスタムHTMLメッセージ \
ヘルプオーバーレイはHTMLで作成しているため、アプリのデザインと完全に一致します。HTMLのアプリ内メッセージは、OneSignalIamApiオブジェクトを通じてSDKと通信します。クリック可能なすべての要素には、2つのルールが適用されます。
- クリックが正しく追跡されるよう、一意の
data-onesignal-unique-labelを付けます。 OneSignalIamApiのメソッドを呼び出すリスナーを設定します。通常のリンクは追跡されません。
docs/iam-html/help-dashboard.html
プッシュ許可の事前プロンプト \
システムの許可ダイアログは一度しか表示できません。先にアプリ内メッセージを表示すれば、ユーザーが何を受け取れるかを説明でき、Enable notificationsをタップした人だけがシステムダイアログを目にします。
システムダイアログの前に、事前プロンプトがメリットを説明します。
docs/iam-html/push-permission-prompt.html
事前プロンプトを使う場合は、アプリ起動時の
requestPermission()呼び出しを削除してください。そうしないとシステムダイアログが先に表示され、事前プロンプトで尋ねることがなくなります。アプリ更新のプロンプト \
新しいバージョンがリリースされると、古いバージョンのユーザーに更新を促すプロンプトが表示されます。このメッセージにはアプリ側のコードは一切不要です。オーディエンスは、古いアプリバージョンを使っているユーザーのセグメントです。
古いバージョンのユーザーにだけ表示される更新プロンプト。
openUrlがクリックを追跡してストアを開き、メッセージを閉じます。
docs/iam-html/app-update-prompt.html
docs/iam-html/app-update-prompt.html
タグの置換は、HTMLアプリ内メッセージのテキストと属性では機能しますが、
scriptタグ内では機能しません。レビューのプロンプト:クリックをアプリに渡す \
アプリストアでの評価を依頼するのに適したタイミングは、何かがうまくいった直後です。Clean Beansは、掃除セッションによって連続記録が7日の倍数に達したときに依頼します。 ネイティブの評価シートはアプリ自身にしか開けないため、これはタップでアプリ内のコードを実行する必要がある唯一のアプリ内メッセージです。1
アプリが連続記録の節目でトリガーを設定する
掃除の邪魔にならないようセッション画面が閉じるまで待ち、最後に依頼した節目を記憶しておきます。
src/lib/reviewPrompt.ts
2
メッセージがクリック名をアプリに返す
addClickNameはアプリのクリックリスナーに名前を渡します。メッセージは閉じないため、その後スクリプトで閉じます。docs/iam-html/review-prompt.html
3
アプリがネイティブの評価シートを開く
クリックリスナーが名前を確認し、シートの表示をシステムに要求します。
src/lib/reviewPrompt.ts
app/_layout.tsx

レビューを依頼するアプリ内メッセージ。
ask_for_review is showのHTMLアプリ内メッセージを作成します。表示頻度は17週間に最大1回になるようスケジュールします。
アプリ内トリガー
トリガーの種類と組み合わせ方。
HTMLアプリ内メッセージ
独自のHTMLでメッセージをデザインする。
アプリ内JavaScript API
すべての
OneSignalIamApiメソッド。