Reencaminhamento da Web para aplicações
Visão geral
O reencaminhamento da Web para a aplicação preenche a lacuna entre o seu Web site móvel e a aplicação móvel, preservando os dados de atribuição da campanha quando os utilizadores fazem a transição da Web para a aplicação. Em vez de perder informações de marketing valiosas sobre como os utilizadores descobriram a sua aplicação, esta funcionalidade transfere automaticamente parâmetros UTM ou parâmetros WP singulares de campanhas Web para o botão ou ligação do seu Web site para obter ou abrir a sua aplicação móvel.
Quando implementado, o Web-to-App Forwarding enriquece os relatórios de atribuição do seu aplicativo móvel com a fonte original da campanha da web, ajudando você a entender a jornada completa do usuário, desde a descoberta inicial na web até a instalação ou reengajamento do aplicativo.
Como funciona:
- Um utilizador chega ao seu website móvel através de uma campanha web (por exemplo, Google Ads com parâmetros UTM)
- O Singular Web SDK detecta esses parâmetros no URL da página
-
Quando o utilizador clica no botão de instalação/abertura da sua aplicação, o SDK anexa automaticamente estes parâmetros como
_web_paramsao seu Singular Link - A Singular atribui a instalação móvel ou o reengajamento à campanha web original
Antes e depois
Antes do encaminhamento da Web para o aplicativo:
Todas as instalações móveis do seu site são agrupadas em uma fonte genérica "Mobile Web to App", ocultando o desempenho real da campanha.
Depois do encaminhamento da Web para aplicativo:
As instalações móveis agora mostram as campanhas da Web reais que levaram os usuários ao seu site (por exemplo, "Adwords", "Some_source"), fornecendo insights de atribuição acionáveis.
Pré-requisitos
-
Um aplicativo móvel integrado com o Singular SDK. OBSERVAÇÃO: O suporte a links profundos deve ser configurado para oferecer suporte ao reengajamento em fluxos web-to-app.
- Singular Web SDK versão 1.0.8 ou superiorintegrado em seu site móvel usando a abordagem Native JSou Google Tag Manager.
- Parâmetros de campanha Singular aplicados aos URLs de destino da Campanha Web.
-
Um Singular Link configurado como um baselink Web-to-App para a sua aplicação móvel.
Importante: Contacte o seu Gestor de Sucesso do Cliente para obter o seu link de base Web-to-App.
Métodos de implementação
O método de implementação é baseado em como o Singular WebSDK foi implementado em seu site.
Método 1: Opções de Implementação do SDK JavaScript Nativo:
O Singular Web SDK disponibiliza duas funções JavaScript para o encaminhamento Web-to-App. Escolha o método que melhor se adapta à sua implementação:
Opção A: openApp() - Redireccionamento Automático
Utilize este método quando pretender redirecionar imediatamente os utilizadores para a sua aplicação (ou para a App Store, se não estiver instalada).
| Descrição | Cria a ligação Web-to-App com parâmetros capturados e redirecciona automaticamente o utilizador |
| Assinatura |
singularSdk.openApp(baseLink, deeplink, passthrough, deferredDeepLink)
|
| Parâmetros |
|
| Exemplo |
|
Opção B: buildWebToAppLink() - Controlo manual
Utilize este método quando pretender construir a ligação mas controlar quando/como é acionada.
| Descrição | Devolve a ligação Web-to-App completa com parâmetros; o utilizador decide como a utilizar |
| Assinatura |
singularSdk.buildWebToAppLink(baseLink, deeplink, passthrough, deferredDeepLink)
|
| Parâmetros |
Igual a openApp() acima |
| Exemplo |
|
Método 2: Opções de implementação do SDK do Google Tag Manager
A implementação do GTM é ideal quando se pretende gerir ligações Web-to-App sem modificar diretamente o código do website. Há duas abordagens:
Opção A: Substituição de links dinâmicos (recomendada)
Atualiza automaticamente todos os links singulares em sua página após a inicialização do Web SDK.
- No GTM, crie uma nova tag HTML personalizada
- Configure-a para ser acionada após a tag de inicialização do Singular usando a Sequência de tags
- Cole o seguinte código:
<script>
(function() {
// Replace with your Web-to-App baselink
var baseLink = "https://mydomain.sng.link/Auour/55ba";
// Extract optional parameters from URL
var urlParams = new URLSearchParams(window.location.search);
var deeplink = urlParams.has('_dl') ? decodeURIComponent(urlParams.get('_dl')) : '';
var deferredDeepLink = urlParams.has('_ddl') ? decodeURIComponent(urlParams.get('_ddl')) : '';
var passthrough = '';
function replaceSngLinks() {
if (window.singularSdk && typeof window.singularSdk.buildWebToAppLink === 'function') {
var webToAppLink = window.singularSdk.buildWebToAppLink(
baseLink,
deeplink,
passthrough,
deferredDeepLink
);
if (webToAppLink) {
// Update all Singular Links on the page
var links = document.querySelectorAll('a[href*="sng.link"]');
links.forEach(function(link) {
link.href = webToAppLink;
});
}
}
}
// Run immediately and after 1 second (for dynamically loaded content)
replaceSngLinks();
setTimeout(replaceSngLinks, 1000);
})();
</script>
Configuração:
-
Atualizar
baseLinkcom seu link Singular Web-to-App fornecido -
O código verifica os parâmetros
_dl(deep link) e_ddl(deferred deep link) no URL da página e inclui-os automaticamente -
Todas as ligações
sng.linkexistentes na sua página serão actualizadas com parâmetros Web
Opção B: Acionador de clique de botão
Dispara o redireccionamento Web-to-App apenas quando um botão específico é clicado.
- Crie uma tag HTML personalizada no GTM
- Defina o gatilho para disparar no evento de clique do botão específico
- Use a seguinte estrutura de código:
<script>
(function() {
if (window.singularSdk && typeof window.singularSdk.openApp === 'function') {
var baseLink = "https://mydomain.sng.link/Auour/55ba";
var deeplink = '';
var passthrough = '';
var deferredDeepLink = '';
singularSdk.openApp(baseLink, deeplink, passthrough, deferredDeepLink);
}
})();
</script>
Melhore a precisão da Atribuição Web-to-App para dispositivos móveis com esta dica:
DICA! Um desafio comum na atribuição de publicidade móvel ocorre com navegadores in-app. As visualizações da Web do navegador in-app móvel (como as usadas pelo Facebook, Instagram e TikTok) podem causar perda de atribuição devido à troca de contexto do navegador - desde o momento em que um anúncio é clicado até que o link de download do aplicativo seja clicado, ou se um usuário mudar para o navegador nativo do dispositivo móvel antes de clicar no link.
Para ajudar a minimizar a perda de atribuição, use o formato de link de rastreamento Singular adequado para cada uma dessas redes de anúncios. O link pode ser criado para redirecionar um utilizador para a página de destino do seu Web site ou diretamente para a loja de aplicações. Este método permite que um clique móvel seja capturado antes do redireccionamento para o browser in-app. Veja os guias aqui:
Prioridade e mapeamento de parâmetros
Prioridade de captura de parâmetros
O Web SDK captura automaticamente os parâmetros do URL da sua página nesta ordem de prioridade:
-
Parâmetros WP singulares (prioridade máxima) - Parâmetros personalizados com o prefixo
wp_ -
Parâmetros UTM - Parâmetros de marketing padrão como
utm_source,utm_campaign
Mapeamento de dimensão UTM para Singular
Os parâmetros UTM das suas campanhas web são automaticamente mapeados para as dimensões de relatório Singular:
| Parâmetro UTM | Dimensão Singular |
|---|---|
utm_source
|
Fonte |
utm_campaign
|
Nome da campanha |
utm_content
|
Nome do criativo |
utm_term
|
Palavra-chave |
utm_medium
|
Disponível em exportações ao nível do utilizador |
Nota: Todos os parâmetros capturados são também preservados na coluna passthrough das exportações a nível do utilizadorpara análise granular.
Relatórios
Após a implementação, as instalações de aplicativos móveis e os reengajamentos originários do seu site aparecerão nos relatórios do Singular com:
- Nome do rastreador: "Web móvel para aplicativo"
- Tipo de ligação: "Mobile Web to App" (nova dimensão)
- Fonte/Campanha/Criativo: Parâmetros originais da campanha web (se os parâmetros UTM estiverem presentes)
Isto permite-lhe medir o verdadeiro ROI das campanhas web que impulsionam o crescimento da aplicação móvel, e não apenas as conversões web imediatas.
Resolução de problemas
Os links não estão a ser actualizados
- Verifique se o Singular Web SDK está carregado antes da execução do seu código Web-to-App
- Verifique se há erros de JavaScript no console do navegador
-
Confirme se o seu link de base está formatado corretamente (deve incluir
sng.link)
Os parâmetros da Web não estão a aparecer nos relatórios
- Certifique-se de que o URL do seu site contém parâmetros UTM ou parâmetros WP Singular
- Verifique se a versão do Web SDK é 1.0.8 ou superior
-
Verifique se a cadeia de consulta
_web_paramsestá presente no link gerado
Precisa de ajuda adicional?
Contacte o seu Gestor de Sucesso do Cliente Singular para obter assistência na implementação e fornecimento de baselink.