Encaminhamento de atribuição de site para aplicativo móvel para a Web móvel

Documento

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:

  1. Um utilizador chega ao seu website móvel através de uma campanha web (por exemplo, Google Ads com parâmetros UTM)
  2. O Singular Web SDK detecta esses parâmetros no URL da página
  3. Quando o utilizador clica no botão de instalação/abertura da sua aplicação, o SDK anexa automaticamente estes parâmetros como _web_params ao seu Singular Link
  4. 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:

Attribution before Web-to-App showing generic Mobile Web to App source

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:

Attribution after Web-to-App showing specific campaign sources

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

  1. 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.

  2. Singular Web SDK versão 1.0.8 ou superiorintegrado em seu site móvel usando a abordagem Native JSou Google Tag Manager.
  3. Parâmetros de campanha Singular aplicados aos URLs de destino da Campanha Web.
  4. 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: Implementação do SDK JavaScript nativo
#

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
  • baseLink (obrigatório): O seu link de base Singular Web-to-App
  • deeplink (opcional): Caminho de link profundo para abrir conteúdo específico do aplicativo
  • passthrough (opcional): Parâmetros personalizados adicionais
  • deferredDeepLink (opcional): Deep link para novas instalações
Exemplo

// Basic usage - redirect to app with web parameters
singularSdk.openApp("https://mydomain.sng.link/Buour/55cx");

// With deep link to specific content
singularSdk.openApp(
  "https://mydomain.sng.link/Auour/55ba", 
  "product/12345",
  null,
  "product/12345"
);

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

// Build link and assign to button
const webToAppLink = singularSdk.buildWebToAppLink(
  "https://mydomain.sng.link/Buour/55cx"
);

document.getElementById("download-btn").href = webToAppLink;

// Or redirect programmatically
window.location.href = webToAppLink;
Método 2: Implementação do SDK do Google Tag Manager
#

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.

  1. No GTM, crie uma nova tag HTML personalizada
  2. Configure-a para ser acionada após a tag de inicialização do Singular usando a Sequência de tags
  3. 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 baseLink com 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.link existentes 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.

  1. Crie uma tag HTML personalizada no GTM
  2. Defina o gatilho para disparar no evento de clique do botão específico
  3. 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:

  1. Parâmetros WP singulares (prioridade máxima) - Parâmetros personalizados com o prefixo wp_
  2. 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

Reporting dashboard showing Web-to-App attribution

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_params está 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.