要件
1. クリック追跡にdata-onesignal-unique-labelを使用する
すべてのクリック可能な要素には、一意の値を持つdata-onesignal-unique-label属性が必要です。これにより、OneSignalは次のことができます:
- クリック分析を追跡する
- 関連するアクションを正しくトリガーする
HTML
2. イベントリスナーをアタッチする
OneSignalアプリ内アクションをトリガーするには、JavaScriptイベントリスナーを明示的にアタッチする必要があります。JavaScript
HTML
利用可能な関数
ブロックエディターのすべてのクリックアクションは、HTMLアプリ内メッセージでも利用できます。プッシュ権限プロンプト
ネイティブのプッシュ通知権限プロンプトを表示します。クリックイベントは自動的に追跡されます。 プッシュ権限のプロンプトを参照してください。HTML
位置情報権限プロンプト
ネイティブの位置情報権限プロンプトを表示します。クリックイベントは自動的に追跡されます。 位置情報権限プロンプトを参照してください。HTML
アプリ内メッセージを閉じる
現在のアプリ内メッセージを閉じます。クリックイベントは自動的に追跡されます。html
ユーザーをタグ付けする
タグを設定します。クリックイベントは自動的に追跡されます。HTML
URLを開く
デバイスのブラウザでURLを開き、アプリ内メッセージを閉じます。クリックイベントは自動的に追跡されます。 ディープリンクをサポートしています。HTML
クリック名
アプリ内メッセージクリックリスナーで読み取ることができるクリック名を割り当てます。クリックイベントは自動的に追跡されます。 ディープリンクをサポートしています。HTML
クリックを追跡する
他のクリック可能なAPIメソッドを使用していないときにクリックイベントを追跡します。html
アウトカムを送信する
未帰属のカスタムアウトカムを追跡し、アウトカム名 : trueの形式でユーザーにタグを設定します。クリックイベントは自動的に追跡されます。
html
HTMLアプリ内メッセージをパーソナライズする
ブロックエディターと同じように、HTMLアプリ内メッセージでタグ置換を使用できます。 タグ置換が機能する場所:- インラインテキスト(
<h1>、<p>、<li>など) <style>ルール:CSS- URLを含む属性:
hrefsrc<form action><object data>
openUrl()とaddClickName()でタグを使用する
<script>タグは置換をサポートしていないため、次のいずれかの方法を使用します:
1. liquidPlayerTagsですべてのタグにアクセスする
このグローバルオブジェクトはDOMContentLoaded後に利用可能になります。
HTML
href属性にタグを保存する
HTML
次のステップ
- タグ置換のためのLiquid構文の使用について詳しく学ぶ
- URL処理のためのディープリンクを探索する
- HTMLでアプリ内メッセージを設計する