SDK no seu prelanding

Normalmente um visitante chega ao prelanding e a partir dele vai ao card da loja PWA, onde fica o botão de instalação. Mas a instalação e a inscrição em push podem ser iniciadas diretamente no seu próprio prelanding: você conecta o Browser SDK e chama seus métodos a partir dos seus próprios botões. Assim o visitante instala o aplicativo e se inscreve em push sem sair para o card da loja.

O visitante não precisa instalar o aplicativo para isso: a inscrição em push funciona sem ele.

O que você precisa primeiro

• Um prelanding enviado ao Qubix. Esta é a sua página na seção Sites — envie-a da mesma forma que um site comum (veja Enviando um site).
• Um domínio configurado e ativo. O prelanding deve ser servido em um domínio configurado no Qubix e ativo (veja Domínios). Isso é obrigatório: instalação e push funcionam apenas quando a página e os endereços de serviço do SDK estão no mesmo domínio.
• Um PWA criado — você precisará do seu identificador (pwaId) do card na seção PWA Apps.

Como conectar

1. No código do prelanding, defina a configuração e carregue o script do SDK. A configuração fica antes do script:

   index.htmlHTML

   <script>
     window.pwaConfig = {
       pwaId: 'YOUR-PWA-ID',
       domain: 'your-domain.com',
     }
   </script>
   <script src="https://your-domain.com/sdk.js" defer></script>

   A chave de push é inserida em /sdk.js automaticamente — você não precisa adicioná-la manualmente. Um detalhamento completo dos campos está na referência do Browser SDK.

2. Prepare o SDK para a instalação — uma vez, ao carregar a página. Esta chamada registra a parte de serviço e anexa o manifest do aplicativo:

   JavaScript

   sdk.pwa.init()

3. Associe a instalação ao seu próprio botão:

   HTML

   <button id="install">Instalar o aplicativo</button>
   <script>
     document.getElementById('install').addEventListener('click', () => {
       sdk.pwa.install()
     })
   </script>

4. Associe a inscrição em push ao seu próprio botão (ou chame-a em um momento oportuno):

   JavaScript

   await sdk.subscribePush()

Pronto — a instalação e a inscrição acontecem na sua página. Nada envia o visitante ao card da loja.

Dica

Se algum cenário precisar do card da loja, sdk.showStore() o abre. Não chame este método — o visitante permanece no seu prelanding.

O navegador exibe a instalação

Mostre o botão de instalação apenas quando a instalação estiver realmente disponível — verifique sdk.pwa.canInstall(). Os navegadores nem sempre permitem o prompt de instalação: uma conexão segura (HTTPS) é obrigatória e, normalmente, uma ação do visitante na página. Por isso tanto a instalação quanto a inscrição são normalmente associadas a um toque explícito em vez de serem disparadas ao carregar.

Verificar

Abra o prelanding em um celular e toque nos seus botões — o navegador exibirá o prompt de instalação e o prompt de notificação. O resultado é visível nos relatórios: os eventos install_accepted, push_allow e outros chegam ao fluxo de eventos.

O que vem a seguir

Referência do Browser SDK

Todos os métodos e eventos do Browser SDK.

Enviando um site

Como enviar um prelanding ao Qubix.

Campanhas de push

Enviando notificações aos que se inscreveram.