Pular para o conteúdo principal
Cada mensagem do OneSignal — push, email, no aplicativo, SMS ou RCS — pode incluir uma URL que leva o User a um destino ao ser clicado. Esse destino pode ser uma página web que abre no navegador ou um deep link que abre diretamente no seu aplicativo. A forma de definir a URL depende do canal:
  • Push: Use o campo Launch URL no painel ou o parâmetro url na API.
  • Email: Adicione links usando o editor de email ou HTML. O OneSignal rastreia cliques automaticamente.
  • No aplicativo: Configure Click Actions em botões, imagens ou planos de fundo.
  • SMS/RCS: Adicione links inline. Use Insert Trackable Link no painel para encurtamento e rastreamento automáticos. Consulte links rastreáveis de SMS/RCS.
Para abrir conteúdo dentro do seu aplicativo em vez de um navegador, use um deep link. O suporte a deep links varia por canal:
  • Push e no aplicativo: Suportam esquemas de URL personalizados como your-app://product/123 e links universais https:// / App Links.
  • Email e SMS: Apenas links universais https:// / App Links são suportados. Esquemas de URL personalizados não funcionam porque clientes de email e aplicativos de SMS não os tratam.

Deep Linking

Guia completo de configuração para esquemas de URL personalizados, links universais e roteamento específico do aplicativo.

​
Push

​
Launch URL

A Launch URL abre quando o User clica em uma notificação push. Ela deve começar com https://.
Para usar URLs http:// em dispositivos Apple, configure a propriedade NSAppTransportSecurity no arquivo Info.plist do seu aplicativo.
Se você enviar uma única mensagem para Users web e mobile, use campos de URL específicos por plataforma:
  • url — direciona todas as plataformas
  • web_url — direciona apenas Subscriptions de push web
  • app_url — direciona apenas Subscriptions mobile
Painel do OneSignal exibindo o campo de entrada de Launch URL para notificações push
Para dispensar uma notificação push web sem abrir nenhuma página, adicione ?_osp=do_not_open à launch URL, por exemplo, https://yoursite.com/page?_osp=do_not_open. Isso funciona apenas para push web.

​
Additional data

Em vez de uma Launch URL, você pode enviar pares de chave-valor personalizados usando o campo Additional Data (data na API). Seu aplicativo lê esses dados por meio do Notification Click Listener do SDK via propriedade additionalData — útil quando você precisa de mais flexibilidade do que uma única URL.
Painel do OneSignal exibindo o campo Additional Data com um par de chave-valor personalizado
O OneSignal rastreia automaticamente cliques em links dentro de emails quando Track link clicks está habilitado para o email ou template (ativado por padrão). O OneSignal rastreia cliques totais e únicos por email e por link individual (até 30 links por email). Veja essas estatísticas nos Relatórios de Mensagens de Email.
Para links de cancelamento de assinatura, consulte Unsubscribe Links & Email Subscriptions.
Relatório de mensagem de email do OneSignal exibindo atividade de cliques com contagens de cliques totais e únicos por link
O rastreamento funciona reescrevendo URLs para capturar o evento de clique e, em seguida, redirecionando o User para o destino original. Isso acontece quase instantaneamente, mas pode causar comportamento inesperado com deep links. Por exemplo:https://some-domain.com/the-pagetorna-se algo como:https://some-domain/c/eJxU0D2uGzEMBODTrDoZJPW3...O User é imediatamente redirecionado para a URL pretendida.
Se você construir links com sintaxe Liquid, o OneSignal pode não detectá-los automaticamente. Marque explicitamente um link como rastreável: 
{{ 'https://some-domain.com/the-page' | track_link }}
Para desabilitar o rastreamento para um email inteiro, desmarque Track link clicks no editor de email do painel ou defina disable_email_click_tracking: true na API.
Configurações de email do painel do OneSignal com Track link clicks desmarcado
Para desabilitar o rastreamento para um link específico enquanto mantém o rastreamento habilitado para os demais: 
{{ 'https://some-domain.com/the-page' | do_not_track_link }}
Desabilitar o rastreamento para um email inteiro significa que nenhum dado de clique é coletado — o CTR exibe “N/A” nos Relatórios de Mensagens de Email.
O OneSignal fornece links encurtados rastreáveis para mensagens SMS/RCS usando o domínio 1sgnl.co. Basta envolver sua URL em {{ "https://your-url.com" | track_link }} e o link será substituído por um link rastreável quando a mensagem for enviada. Para uso via API, consulte a referência da API de criação de mensagem SMS/RCS. Apenas 1 link rastreável é permitido por mensagem SMS/RCS. Ao usar o painel, você também pode clicar no botão Insert Trackable Link abaixo da caixa de entrada de mensagem e inserir sua URL:
Modal do painel do OneSignal para inserir um link encurtado rastreável em uma mensagem SMS
Clique em Insert trackable link para adicionar o link curto à sua mensagem: 
Your order is on its way!
Track it here: {{ "https://your-url.com" | track_link }}
Quando a mensagem for enviada, as chaves duplas e tudo dentro delas serão substituídas por um link rastreável 1sgnl.co/XXXX:
Notificação SMS em um dispositivo mobile exibindo um link encurtado rastreável

​
URLs dinâmicas

Você pode criar URLs personalizadas e específicas do usuário com sintaxe Liquid. Por exemplo, inclua o ID de um User na URL para que cada pessoa acesse sua própria página de perfil, ou insira um ID de produto de um evento recente para vincular diretamente a um item relevante. URLs dinâmicas podem extrair dados de:
  • Propriedades do User (por exemplo, external_id, email)
  • Tags armazenadas no OneSignal
  • custom_data enviado via API
  • Custom Events (em Journeys)
Injete valores como external_id ou email diretamente em URLs.
https://yourdomain.com/profile/user={{subscription.external_id}}
Se o external_id do User for 12345, a URL final será:
https://yourdomain.com/profile/user=12345
Da mesma forma:
https://yourdomain.com/profile/email={{subscription.email}}
Se o email do User for john@example.com, a URL final será:
https://yourdomain.com/profile/email=john@example.com
Substitua dados apenas em partes da URL — mantenha o protocolo (https://) e o domínio como texto estático. Use o filtro default para definir um valor padrão se um valor não estiver presente.

​
Parâmetros UTM

Parâmetros UTM rastreiam o desempenho de campanhas adicionando detalhes de source, medium e campaign às URLs. Adicione parâmetros UTM diretamente nas URLs de suas mensagens. Para notificações push enviadas pelo painel, o OneSignal pode adicionar UTMs automaticamente.
Navegue até Settings > Push & In-app > UTM Settings e habilite Turn on automated UTM tagging.Uma vez habilitado, o OneSignal adiciona estes valores (editáveis):
  • Source = utm_source — padrão onesignal
  • Medium = utm_medium — padrão push
  • Campaign = utm_campaign — padrão {{ sendDate }}-{{ title }}
    • sendDate: Data de envio
    • title: Primeiros 15 caracteres alfanuméricos, sublinhados ou hífens do título da mensagem
Exemplo:
https://test.com?utm_source=onesignal&utm_medium=push&utm_campaign=2020-06-03-sale-today
A marcação UTM automática só se aplica a notificações push enviadas pelo painel. Ela não funciona com:
  • Emails, SMS ou mensagens no aplicativo
  • Journeys, Templates ou mensagens automatizadas
  • Requisições da API
  • O botão “Send Test Message”
  • Campos de additional data
Para esses casos, adicione parâmetros UTM manualmente nos seus templates ou payloads da API.

​
Tratamento de URL e substituições

Se você adicionar parâmetros UTM manualmente a uma launch URL enquanto a marcação automática estiver habilitada, seus UTMs manuais substituirão os valores automáticos.

​
FAQ

Use o link da loja como a launch URL:
  • Android: Use o link do Google Play, por exemplo, https://play.google.com/store/apps/details?id=com.example.app. Consulte Linking to Google Play.
  • iOS: Use o link da App Store, mas substitua https:// por itms-apps:// para abrir o aplicativo da App Store diretamente, por exemplo, itms-apps://apps.apple.com/app/id123456789.
Para mensagens push e no aplicativo, você pode usar um esquema de URL para fazer deep link em outro aplicativo. Por exemplo, para fazer deep link no WhatsApp: whatsapp://wa.me/15551234567. Para email e SMS, use links https:// — esquemas de URL personalizados não são suportados.

​
Por que minha launch URL não está funcionando?

Causas comuns:
  • URL incorreta: A URL deve começar com https://. Se você estiver usando http:// em dispositivos Apple, é necessário configurar o NSAppTransportSecurity.
  • Esquemas personalizados em mobile: Deep links como your-app://path podem não funcionar como launch URL em todas as plataformas. Use o campo Additional Data ou consulte Deep Linking para roteamento confiável no aplicativo.
  • Padrão para push web: Se nenhuma launch URL for definida, o push web abre sua página inicial. Defina uma launch URL explicitamente para controlar o destino.
  • Interferência do rastreamento de cliques: No email, a reescrita de links para rastreamento de cliques pode quebrar deep links. Tente desabilitar o rastreamento de cliques para esse link específico.

​
Os parâmetros UTM funcionam com email e SMS?

Não. A marcação UTM automática se aplica apenas a notificações push enviadas pelo painel. Para email e SMS, adicione parâmetros UTM manualmente nas URLs dos seus templates ou payloads da API. Consulte Parâmetros UTM para a lista completa de limitações.

​
Posso impedir que uma notificação push abra uma URL?

Em mobile, clicar em uma notificação push sempre abre o aplicativo. Na web, adicione ?_osp=do_not_open à launch URL para dispensar a notificação sem abrir nenhuma página. Consulte a dica de Launch URL para um exemplo.

Deep Linking

Configure esquemas de URL personalizados e roteamento específico do aplicativo para mensagens push e no aplicativo.

Personalização

Insira dados dinâmicos de usuários em mensagens usando sintaxe Liquid e tags.

Usando sintaxe Liquid

Guia de referência para filtros, tags e variáveis Liquid em templates do OneSignal.

Relatórios de mensagens de email

Veja métricas de entrega, abertura e taxa de cliques para campanhas de email.

Botões de ação

Adicione botões de chamada para ação a notificações push com URLs personalizadas.