Reenvío de atribuciones de sitio web a aplicación móvil para web móvil

Documento

Reenvío de web a aplicación

Visión general

Web-to-App Forwarding tiende un puente entre su sitio web móvil y su aplicación móvil preservando los datos de atribución de campaña cuando los usuarios pasan de la web a la aplicación. En lugar de perder valiosa información de marketing sobre cómo los usuarios descubrieron su aplicación, esta función transfiere automáticamente parámetros UTM o parámetros Singular WP de campañas web al botón o enlace de su sitio web para obtener o abrir su aplicación móvil.

Cuando se implementa, el reenvío de web a aplicación enriquece sus informes de atribución de aplicaciones móviles con la fuente original de la campaña web, ayudándole a comprender el recorrido completo del usuario desde el descubrimiento inicial de la web hasta la instalación de la aplicación o el reenganche.

Cómo funciona:

  1. Un usuario llega a su sitio web para móviles a través de una campaña web (por ejemplo, Google Ads con parámetros UTM).
  2. Singular Web SDK detecta estos parámetros en la URL de la página.
  3. Cuando el usuario hace clic en el botón de instalación/apertura de su aplicación, el SDK añade automáticamente estos parámetros como _web_params a su enlace Singular.
  4. Singular atribuye la instalación móvil o el reenganche a la campaña web original.

Antes y después

Antes del reenvío de la web a la aplicación:

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

Todas las instalaciones móviles desde su sitio web se agrupan bajo una fuente genérica "Mobile Web to App", ocultando el rendimiento real de la campaña.

Después del reenvío de web a aplicación:

Attribution after Web-to-App showing specific campaign sources

Las instalaciones móviles muestran ahora las campañas web reales que llevaron a los usuarios a su sitio web (por ejemplo, "Adwords", "Alguna_fuente"), proporcionando información procesable sobre la atribución.

Requisitos previos

  1. Una aplicación móvil integrada con el SDK de Singular . NOTA: La compatibilidad con enlaces profundos debe configurarse para admitir el reenganche en los flujos de web a aplicación.

  2. Singular Web SDK versión 1.0.8 o superiorintegrado en su sitio web móvil, ya sea utilizando el enfoque Native JSo Google Tag Manager.
  3. Parámetros de campaña Singular aplicados a las URL de destino de su campaña Web.
  4. Un Singular Link configurado como un Web-to-App baselink para su Mobile App.

    Importante: Contacte con su Customer Success Manager para obtener su Web-to-App baselink.


Métodos de implementación

El método de implementación se basa en cómo se implementó Singular WebSDK en su sitio.

Método 1: Implementación del SDK JavaScript nativo
#

Método 1: Opciones de implementación del SDK nativo de JavaScript:

El Singular Web SDK proporciona dos funciones JavaScript para el reenvío de Web a App. Elija el método que mejor se adapte a su implementación:

Opción A: openApp() - Redirección automática

Utilice este método cuando desee redirigir inmediatamente a los usuarios a su aplicación (o App Store si no está instalada).

Descripción Construye el enlace Web-to-App con parámetros capturados y redirige automáticamente al usuario
Firma singularSdk.openApp(baseLink, deeplink, passthrough, deferredDeepLink)
Parámetros
  • baseLink (obligatorio): Su enlace base Singular Web-to-App
  • deeplink (opcional): Ruta de enlace profundo para abrir contenido específico de la app
  • passthrough (opcional): Parámetros personalizados adicionales
  • deferredDeepLink (opcional): Enlace profundo para nuevas instalaciones
Ejemplo

// 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"
);

Opción B: buildWebToAppLink() - Control manual

Utilice este método cuando desee construir el enlace pero controlar cuándo/cómo se activa.

Descripción Devuelve el enlace Web-to-App completo con parámetros; usted decide cómo utilizarlo
Firma singularSdk.buildWebToAppLink(baseLink, deeplink, passthrough, deferredDeepLink)
Parámetros Igual que openApp()
Ejemplo

// 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: Implementación del SDK de Google Tag Manager
#

Método 2: Opciones de implementación del SDK de Google Tag Manager

La implementación de GTM es ideal cuando se desea gestionar enlaces Web-to-App sin modificar directamente el código del sitio web. Existen dos enfoques:

Opción A: Sustitución dinámica de enlaces (recomendada)

Actualiza automáticamente todos los Enlaces Singulares de su página después de que el SDK Web se inicialice.

  1. En GTM, cree una nueva etiqueta HTML personalizada
  2. Configúrela para que se active después de la etiqueta de inicialización de enlaces singulares mediante la secuencia de etiquetas.
  3. Pegue el siguiente 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>

Configuración:

  • Actualice baseLink con el enlace Singular Web-to-App proporcionado.
  • El código busca los parámetros _dl (enlace profundo) y _ddl(enlace profundo diferido) en la URL de su página y los incluye automáticamente.
  • Todos los enlaces sng.link existentes en su página se actualizarán con parámetros web

Opción B: Activación por clic de botón

Activa la redirección de Web a App sólo cuando se hace clic en un botón específico.

  1. Cree una etiqueta HTML personalizada en GTM
  2. Configure el activador para que se active al hacer clic en el botón específico
  3. Utilice la siguiente estructura 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>

Mejore la precisión de la atribución de Web a aplicación móvil con este consejo:

CONSEJO Un desafío común en la atribución de publicidad móvil ocurre con los navegadores in-app. Las vistas web del navegador de la aplicación móvil (como las utilizadas por Facebook, Instagram y TikTok) pueden causar pérdidas de atribución debido al cambio de contexto del navegador, desde el momento en que se hace clic en un anuncio hasta que se hace clic en el enlace de descarga de la aplicación, o si un usuario cambia al navegador nativo del dispositivo móvil antes de hacer clic en el enlace.

Para ayudar a minimizar la pérdida de atribución, utilice el formato de enlace de seguimiento Singular adecuado para cada una de estas redes publicitarias. El enlace puede crearse para redirigir al usuario a la página de destino de su sitio web o directamente a la tienda de aplicaciones. Este método permite capturar un clic móvil antes de la redirección al navegador de la aplicación. Fluya las guías aquí:


Prioridad y asignación de parámetros

Prioridad de captura de parámetros

El SDK Web captura automáticamente los parámetros de la URL de su página en este orden de prioridad:

  1. Parámetros WP singulares (prioridad más alta) - Parámetros personalizados prefijados con wp_
  2. Parámetros UTM - Parámetros de marketing estándar como utm_source, utm_campaign

Mapeo de UTM a Dimensión Singular

Los parámetros UTM de sus campañas web se asignan automáticamente a dimensiones de informes Singular:

Parámetro UTM Dimensión Singular
utm_source Fuente
utm_campaign Nombre de la campaña
utm_content Nombre creativo
utm_term Palabra clave
utm_medium Disponible en las exportaciones a nivel de usuario

Nota: Todos los parámetros capturados también se conservan en la columna passthrough de las exportacionesa nivel deusuario para un análisis granular.

Informes

Reporting dashboard showing Web-to-App attribution

Tras la implementación, las instalaciones de aplicaciones móviles y los reenganches originados desde su sitio web aparecerán en los informes de Singular con:

  • Tracker Name: "Web móvil a aplicación"
  • Tipo de enlace: "Mobile Web to App" (nueva dimensión)
  • Fuente/Campaña/Creativo: Parámetros de la campaña web original (si había parámetros UTM)

Esto le permite medir el verdadero ROI de las campañas web que impulsan el crecimiento de la aplicación móvil, no sólo las conversiones web inmediatas.

Solución de problemas

Los enlaces no se actualizan

  • Compruebe que Singular Web SDK está cargado antes de que se ejecute el código Web-to-App.
  • Compruebe si hay errores de JavaScript en la consola del navegador
  • Confirme que su enlace base está formateado correctamente (debe incluir sng.link)

Los parámetros web no aparecen en los informes

  • Asegúrese de que la URL de su sitio web contiene parámetros UTM o parámetros Singular WP
  • Compruebe que la versión del Web SDK es 1.0.8 o superior
  • Compruebe que la cadena de consulta _web_params está presente en el enlace generado

¿Necesita más ayuda?

Póngase en contacto con su Customer Success Manager de Singular para obtener ayuda sobre la implementación y el suministro de enlaces de base.