Pular para o conteúdo principal
Este guia cobre a API JavaScript para mensagens HTML no aplicativo criadas com o Editor HTML do OneSignal. Se você está procurando métodos SDK para definir gatilhos, lidar com eventos de clique no aplicativo ou gerenciar o ciclo de vida no aplicativo, veja a Referência do SDK Móvel.

Requisitos

1. Use data-onesignal-unique-label para rastreamento de cliques

Todos os elementos clicáveis devem ter um atributo data-onesignal-unique-label com um valor único. Isso permite que o OneSignal:
  • Rastreie análises de clique
  • Acione corretamente as ações associadas
HTML
Se dois elementos compartilharem o mesmo data-onesignal-unique-label, os cliques podem ser registrados incorretamente ou as ações podem não ser acionadas.

2. Anexar event listeners

Você deve anexar explicitamente event listeners JavaScript para acionar ações no aplicativo do OneSignal.
JavaScript
Exemplo:
HTML

Funções disponíveis

Todas as ações de clique do Editor de Blocos também estão disponíveis para mensagens HTML no aplicativo.

Prompt de permissão push

Mostra o prompt de permissão de notificação push nativo. Eventos de clique são rastreados automaticamente. Veja Prompt para permissões push.
HTML

Prompt de permissão de localização

Mostra o prompt de permissão de localização nativo. Eventos de clique são rastreados automaticamente. Veja Prompts de permissão de localização.
HTML

Fechar mensagem no aplicativo

Dispensa a mensagem no aplicativo atual. Eventos de clique são rastreados automaticamente.
html

Marcar usuário com tag

Define uma Tag. Eventos de clique são rastreados automaticamente.
HTML

Abrir URL

Abre uma URL no navegador do dispositivo e fecha a mensagem no aplicativo. Eventos de clique são rastreados automaticamente. Suporta Deep Linking.
HTML

Nome do clique

Atribui um nome de clique que pode ser lido no listener de clique de mensagem no aplicativo. Eventos de clique são rastreados automaticamente. Suporta Deep Linking.
HTML

Rastrear clique

Rastreia um evento de clique quando você não está usando outros métodos de API clicáveis.
html

Enviar Outcome

Rastreia um Custom Outcome não atribuído e define uma Tag no usuário no formato outcome name : true. Eventos de clique são rastreados automaticamente.
html

Personalizar mensagens HTML no aplicativo

Você pode usar substituição de tags em mensagens HTML no aplicativo assim como no Editor de Blocos.
A substituição de tags não funciona dentro de tags <script>.
A substituição de tags funciona para:
  • Texto inline (<h1>, <p>, <li>, etc.)
  • Regras <style>:
    CSS
  • Atributos com URLs:
    • href
    • src
    • <form action>
    • <object data>

Usando tags em openUrl() e addClickName()

Como tags <script> não suportam substituição, use um destes métodos: 1. Acesse todas as tags com liquidPlayerTags Este objeto global fica disponível após DOMContentLoaded.
HTML
2. Armazene uma tag no atributo href
HTML

Próximos passos