Skip to main content
このガイドでは、OneSignal HTMLエディターで作成されたHTMLアプリ内メッセージのJavaScript APIについて説明します。 トリガーの設定、アプリ内クリックイベントの処理、またはアプリ内ライフサイクルの管理のためのSDKメソッドをお探しの場合は、モバイルSDKリファレンスを参照してください。

要件

1. クリック追跡にdata-onesignal-unique-labelを使用する

すべてのクリック可能な要素には、一意の値を持つdata-onesignal-unique-label属性が必要です。これにより、OneSignalは次のことができます:
  • クリック分析を追跡する
  • 関連するアクションを正しくトリガーする
HTML
2つの要素が同じdata-onesignal-unique-labelを共有している場合、クリックが正しくログに記録されないか、アクションが発火しない可能性があります。

2. イベントリスナーをアタッチする

OneSignalアプリ内アクションをトリガーするには、JavaScriptイベントリスナーを明示的にアタッチする必要があります。
JavaScript
例:
HTML

利用可能な関数

ブロックエディターのすべてのクリックアクションは、HTMLアプリ内メッセージでも利用できます。

プッシュ権限プロンプト

ネイティブのプッシュ通知権限プロンプトを表示します。クリックイベントは自動的に追跡されます。 プッシュ権限のプロンプトを参照してください。
HTML

位置情報権限プロンプト

ネイティブの位置情報権限プロンプトを表示します。クリックイベントは自動的に追跡されます。 位置情報権限プロンプトを参照してください。
HTML

アプリ内メッセージを閉じる

現在のアプリ内メッセージを閉じます。クリックイベントは自動的に追跡されます。
html

ユーザーをタグ付けする

タグを設定します。クリックイベントは自動的に追跡されます。
HTML

URLを開く

デバイスのブラウザでURLを開き、アプリ内メッセージを閉じます。クリックイベントは自動的に追跡されます。 ディープリンクをサポートしています。
HTML

クリック名

アプリ内メッセージクリックリスナーで読み取ることができるクリック名を割り当てます。クリックイベントは自動的に追跡されます。 ディープリンクをサポートしています。
HTML

クリックを追跡する

他のクリック可能なAPIメソッドを使用していないときにクリックイベントを追跡します。
html

アウトカムを送信する

未帰属のカスタムアウトカムを追跡し、アウトカム名 : trueの形式でユーザーにタグを設定します。クリックイベントは自動的に追跡されます。
html

HTMLアプリ内メッセージをパーソナライズする

ブロックエディターと同じように、HTMLアプリ内メッセージでタグ置換を使用できます。
タグ置換は<script>タグ内では機能しません
タグ置換が機能する場所:
  • インラインテキスト(<h1><p><li>など)
  • <style>ルール:
    CSS
  • URLを含む属性:
    • href
    • src
    • <form action>
    • <object data>

openUrl()addClickName()でタグを使用する

<script>タグは置換をサポートしていないため、次のいずれかの方法を使用します: 1. liquidPlayerTagsですべてのタグにアクセスする このグローバルオブジェクトはDOMContentLoaded後に利用可能になります。
HTML
2. href属性にタグを保存する
HTML

次のステップ