Pular para o conteúdo principal

​
Visão geral

Você pode incluir URLs e deep links em Push, Email, Mensagens In-App e SMS. Este guia explica como configurar esses links corretamente, como o rastreamento de links funciona e quando usar deep links.
Para links mais avançados como esquemas personalizados ou roteamento de aplicativo, consulte nosso guia de Deep Linking.
  • Notificações Push
  • Email
  • Mensagens In-App
  • SMS

​
URL de Inicialização

Use a URL de Inicialização para abrir um link quando a notificação for clicada. Isso normalmente abre no navegador padrão e deve começar com https://.
Para usar URLs http:// com dispositivos Apple, você deve configurar a propriedade NSAppTransportSecurity no arquivo Info.plist do seu aplicativo.
Se você estiver usando um deep link mobile como your-custom-scheme://, os resultados podem variar. Consulte Deep Linking.

​
Direcionamento para múltiplas plataformas

Se você enviar uma única mensagem para usuários web e mobile, use:
  • url — para direcionamento geral em todas as plataformas.
  • web_url — para Assinaturas de push web.
  • app_url — para Assinaturas mobile.

Painel OneSignal – Campo URL de Inicialização

​
Dados adicionais

Em vez da URL de Inicialização, você pode usar o campo Dados Adicionais (data na API) para enviar dados personalizados com seu push e manipular esses dados em seu aplicativo usando o Notification Click Listener do SDK através da propriedade additionalData. Esta pode ser uma opção melhor do que a URL de Inicialização para fornecer mais flexibilidade.

Envie uma URL para ler dentro do seu aplicativo através do campo Dados Adicionais.

​
URLs Dinâmicas

Você pode criar URLs personalizadas e específicas do usuário com Sintaxe Liquid e dados de:
  • Propriedades do Usuário (por exemplo, external_id, email)
  • Tags armazenadas no OneSignal
  • custom_data enviado através da API
Isso permite links personalizados em suas mensagens que levam usuários a conteúdo adaptado especificamente para eles.
  • Propriedades do Usuário
  • Tags de Dados
  • custom_data
Injete valores como external_id ou email diretamente em URLs.Exemplo:
  https://yourdomain.com/profile/user={{subscription.external_id}}
Se o external_id do usuário for 12345, a URL final será:
https://yourdomain.com/profile/user=12345
De forma similar:
https://yourdomain.com/profile/email={{subscription.email}}
Se o usuário tiver um endereço de email john@example.com, a URL final será:
https://yourdomain.com/profile/email=john@example.com
Melhores práticas:
  • Defina apenas tags de dados ou custom_data para partes da URL. Não inclua o protocolo (https:// ou your-app-scheme://) e domínio na URL.
  • Use o filtro default para definir um valor padrão se a tag não estiver definida.
Para mais detalhes, consulte:

​
Parâmetros UTM

Parâmetros UTM ajudam a rastrear o desempenho de campanhas de mensagens anexando detalhes de source, medium e campaign a URLs. Simplesmente adicione seus parâmetros UTM diretamente nas URLs de suas mensagens. Você pode fazer o OneSignal adicionar automaticamente UTMs a URLs de Inicialização de notificação push enviadas do Painel.
Navegue até Settings > Push & In-app > UTM Settings e Ative a marcação UTM automatizada.Uma vez habilitado, o OneSignal anexa os valores fornecidos que você pode editar:
  • Source = utm_source padrão para onesignal
  • Medium = utm_medium padrão para push
  • Campaign = utm_campaign padrão para {{ 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 do painel não funciona com:
  • Emails, SMS, Mensagens in-app
  • Journeys, Templates, Mensagens automatizadas
  • Requisições da API
  • O botão “Enviar Mensagem de Teste”
  • Campos de dados adicionais
Para esses casos, você deve adicionar manualmente parâmetros UTM em seus templates ou payloads da API.

​
Manipulação e substituições de URL

Se você adicionar UTMs diferentes às suas URLs de inicialização de push com este recurso habilitado, esses novos UTMs definidos manualmente substituirão os Parâmetros UTM definidos no recurso automático do painel.

​
FAQ

Você pode inserir o link da loja como a URL de inicialização. Exemplos: Android - https://developer.android.com/distribute/marketing-tools/linking-to-google-play.html iOS - obtenha o link para a página da app store, mas substitua https:// por itms-apps://. Para push e mensagens in-app, na maioria dos casos, você pode configurar um URL Scheme e fazer deep link usando o protocolo x://. Por exemplo, deep linking para o Whatsapp, você pode usar: whatsapp://wa.me/15551234567 Para email e sms, você precisará usar o link https:// da app store. Atualmente em aplicativos mobile, sempre que o usuário clica no push ele abrirá o aplicativo. Push Web: Se você não quiser criar link para nenhuma página ou url, você pode adicionar ?_osp=do_not_open ao final de uma URL assim https://yoursite.com/page?_osp=do_not_open como a url de inicialização, isso impedirá que o push vá para qualquer url ao clicar e apenas dispensará o push.