Singular SDK Sitio Web: Integración de Google Tag Manager

Seguir
Avatar
Eyal Rabinovich
Updated

El SDK de Singular Website es una función empresarial. Si está interesado en utilizar esta función, póngase en contacto con su Customer Success Manager.

Singular Website SDK (Integración GTM)
Compatibilidad con navegadores
  • Chrome: 15+
  • Safari 5.1+
  • Edge: 15+
  • Firefox 6+
  • Internet Explorer: 10+
  • Opera: 15+

 

Introducción

Singular Website SDK le permite atribuir las actividades del sitio web a los puntos de contacto de marketing y realizar un seguimiento de los eventos de usuario dentro de su sitio web. También es un componente clave en la solución de atribución entre dispositivos de Singular, que permite analizar los viajes de los usuarios y calcular el LTV y el ROAS entre plataformas. Para su comodidad, el SDK de Singular Website está integrado con Google Tag Manager.

Ver también: Integración de Singular Website SDK sin Google Tag Manager

Requisitos previos

Antes de integrar Singular Website SDK, asegúrese de que:

  • Se ha configurado Google Tag Manager en su sitio.
  • Ha configurado los disparadores de Google Tag Manager necesarios para los eventos que desea enviar a Singular (su evento de conversión y cualquier evento personalizado). Consulte Acerca de los activadoresen la documentación de Google.
  • Ha configurado las variables de Google Tag Manager necesarias para los eventos que desea enviar a Singular. Por ejemplo, si desea enviar eventos de transacción e incluir los ingresos de la transacción, debe configurar variables para la suma de la transacción y la moneda. Consulte Acerca de las variables en la documentación de Google.

Integración del SDK de Singular

Inicialización del SDK

Para utilizar Singular Web SDK en su sitio web, debe añadir la etiqueta de inicialización de Singular. Le recomendamos que configure este evento para que se active en cuanto se cargue su sitio web (por ejemplo, al ver la página).

Para añadir una etiqueta de inicialización de Singular

  1. En su cuenta de Google Tag Manager, haga clic en Etiquetas > Nuevo.
  2. En la ventana Configuración de etiquetas, haga clic en Configuración de etiquetas y, en el menú Tipo de etiqueta, seleccione "Seguimiento web singular".
  3. En Tipo de etiqueta, seleccione "Inicialización".
  4. Rellene los demás parámetros necesarios:
    • SDK Key y SDK Secret: Puede recuperarlas accediendo a su cuenta de Singular y yendo a "Developer Tools > SDK Integration > SDK Keys".
    • Id. de producto: Un nombre para su sitio web. Le recomendamos que utilice la notación DNS inversa de su dominio web principal, por ejemplo, "com.example", que se utilizará para identificar su sitio web en toda la plataforma Singular. Este valor también debe coincidir con el ID del paquete de aplicaciones en la página de aplicaciones de la plataforma Singular.
    • Opcional:
      • Nivel de registro: La configuración del registro de depuración del SDK en la consola.El valorpredeterminado es ninguno.
      • Tiempo de espera de sesión: Cuánto tiempo tiene que estar inactivo el usuario antes de que el SDK cree una nueva sesión. Singular envía las sesiones de usuario para calcular la retención de usuarios y permitir la atribución de reenganche.El valor por defecto es 30 minutos.
      • Seguimiento entre subdominios
  5. Haga clic en Triggering y añada el trigger "Page View".
  6. Haga clic en Guardar.

mceclip0.png

Nota: Para SPAs (Single Page Applications), debe activar el trackType PageVisit cada vez que se dirija a una página diferente. No llame a PageVisit en la primera página que se carga ya que la Inicialización ya informa de una visita a la página.

image5.png

Opcional: Establecer el ID de usuario

Mientras el usuario realice acciones en su sitio web sin haber iniciado sesión, los eventos se envían a Singular con un ID de usuario generado por Singular. Pero después de que el usuario se registre o inicie sesión, puede hacer que los eventos se envíen a Singular junto con el ID de usuario que se utiliza en su sitio web, por ejemplo, una dirección de correo electrónico.

Singular utiliza el ID de usuario en las exportaciones de datos a nivel de usuario (consulte Exportación de registros de atribución), así como en los postbacks de BI internos, si los tiene configurados (consulte Configuración de postbacks de BI internos).

Hay dos formas de enviar el ID de usuario a Singular:

  • Recomendado: Si conoce el ID de usuario cuando se abre el sitio web, configure el ID de usuario en el tipo de pista Inicialización al inicializar el SDK. De este modo, el ID de usuario estará disponible para Singular desde la primera visita a la página.
  • También puede llamar al método de inicio de sesión en cualquier momento de la ejecución. Recomendamos llamarlo en cuanto el ID de usuario esté disponible.

Para compartir el ID de usuario con Singular, añada una etiqueta Singular con el tipo de seguimiento "Inicio de sesión":

  1. En su cuenta de Google Tag Manager, haga clic en Etiquetas > Nueva.
  2. En la ventana Configuración de etiquetas, haga clic en Configuración de etiquetas y, en el menú Tipo de etiqueta, seleccione "Seguimiento web de Singular".
  3. En Tipo de seguimiento, seleccione "Inicio de sesión".
  4. En ID de usuario personalizado, introduzca la variable de Google Tag Manager que contiene el ID de usuario.
  5. Haga clic en Activación y añada el evento de activación: inicio de sesión o registro del usuario.
  6. Haga clic en Guardar.

image4.png

Para desactivar el ID de usuario, añada una etiqueta con el tipo de seguimiento "Cierre de sesión":

  1. En su cuenta de Google Tag Manager, haga clic en Etiquetas > Nuevo.
  2. En la ventana Configuración de etiquetas, haz clic en Configuración de etiquetas y, en el menú Tipo de etiqueta, selecciona "Seguimiento web singular".
  3. En Tipo de seguimiento, seleccione "Cierre de sesión".
  4. Haga clic en Activación y añada el evento de activación: cierre de sesión de usuario.
  5. Haga clic en Guardar.

image1.png

Notas:

  • El ID de usuario persiste hasta que lo desactive utilizando el tipo de seguimiento de cierre de sesión o hasta que el usuario elimine su almacenamientolocal.
  • Cerrar/reiniciar el sitio web no desactiva el ID de usuario.
  • Navegar en modo privado, como incógnito, impedirá que Singular conserve el ID de usuario, ya que el almacenamiento local se elimina automáticamente al cerrar el navegador.

Opcional: Seguimiento de eventos e ingresos

Seguimiento de eventos (no ingresos)

Singular puede recopilar datos sobre los eventos de los usuarios dentro del sitio para ayudar a analizar el rendimiento de sus campañas y medir los KPI. Por ejemplo, es posible que su organización desee recopilar datos sobre inicios de sesión, registros o finalización de tutoriales por parte de los usuarios.

Puede enviar eventos a Singular utilizando el método de eventos.

Notas:

  • Recomendamos encarecidamente pasar los nombres y atributos de los eventos en inglés para garantizar la compatibilidad con socios y soluciones de análisis de terceros si tiene previsto utilizarlos.
  • Los nombres de eventos están limitados a 32 caracteres ASCII. Las cadenas en caracteres no ASCII deben tener menos de 32 bytes una vez convertidas a UTF-8.
  • Los atributos y valores están limitados a 500 caracteres ASCII.

Para realizar el seguimiento de un evento personalizado

  1. En su cuenta de Google Tag Manager, haga clic en Etiquetas > Nuevo.
  2. En la ventana Configuración de etiquetas, haz clic en Configuración de etiquetas y, en el menú Tipo de etiqueta, selecciona "Seguimiento web singular".
  3. En Tipo de seguimiento, selecciona "Evento personalizado".
  4. En Nombre del evento, introduzca un nombre para el evento o introduzca una variable de Google Tag Manager que haya definido previamente.
  5. Haga clic en Activación y añada el evento de activación.
  6. Haga clic en Guardar.

image3.png

Seguimiento de ingresos

Singular puede recopilar datos sobre los ingresos obtenidos a través del sitio web para ayudar a analizar el rendimiento y el ROI de sus campañas. Singular pondrá los datos a su disposición en informes, exportaciones de registros y postbacks.

Utilice el método de ingresos para informar de los eventos. Ingresos le permite pasar un nombre de evento personalizado para que pueda ver los ingresos en los informes de Singular desglosados por los diferentes tipos de eventos de ingresos.

Notas: Cualquier ingreso notificado en una moneda diferente se convertirá automáticamente a la moneda preferida de su organización, según lo establecido en su cuenta de Singular.

Para realizar un seguimiento de los eventos de ingresos:

  1. En su cuenta de Google Tag Manager, haga clic en Etiquetas > Nuevo.
  2. En la ventana Configuración de etiquetas, haz clic en Configuración de etiquetas y, en el menú Tipo de etiqueta, selecciona "Seguimiento web de Singular".
  3. En Tipo de seguimiento, seleccione "Evento de ingresos".
  4. En Nombre del evento, introduzca un nombre para el evento o introduzca una variable de Google Tag Manager que haya definido previamente.
  5. En Moneda, introduzca una variable que represente un código de moneda ISO 4217 de tres letras, como "USD", "EUR" o "INR".
  6. En Ingresos, introduzca una variable que contenga el importe de la transacción (puede pasarse como un valor decimal, por ejemplo, 1,99).
  7. Haga clic en Activación y añada el evento de activación.
  8. Haga clic en Guardar.

image2.png

Opcional: Seguimiento entre subdominios

Por defecto, el SDK de Singular Website genera un ID de dispositivo Singular y lo guarda utilizando el almacenamiento del navegador. Dado que este almacenamiento no puede compartirse entre subdominios, el SDK termina generando un nuevo ID para cada subdominio.

Si desea mantener el ID de dispositivo singular en todos los subdominios, puede utilizar una de las siguientes opciones:

Método A: Autopersistencia mediante cookies

Puede hacer que Singular SDK mantenga el ID de dispositivo singular utilizando una cookie personalizada de origen. Elija la siguiente opción y establezca el dominio principal que desea rastrear.

mceclip1.png

Método B (Avanzado): Leer ID de dispositivo singular para variable GTM

Si no desea que Singular SDK persista el ID de dispositivo automáticamente, puede persistir el ID manualmente entre dominios, por ejemplo, utilizando una cookie de dominio de nivel superior o una cookie del lado del servidor. El valor debe ser un ID generado previamente por Singular en formato uuid4 válido.

Nota: Puede leer el ID de dispositivo de Singular definiendo una variable JavaScript personalizada y llamando a singularSdk.getSingularDeviceId() después de llamar a la etiqueta Init track-type.

mceclip2.png

Asignación personalizada de Id de usuarioa dispositivo

Importante: Se trata de una función avanzada. Consulte con uno de los ingenieros de soluciones de Singular antes de implementarla.

Singular puede recibir datos de seguimiento web adicionales a través de la integración de servidor a servidor. Para utilizar esta función, necesitamos asignar el identificador de usuario personalizado al identificador de seguimiento web de Singular.

Nota: Llame a este tipo de seguimiento tan pronto como sea posible después de inicializar el SDK o una vez que tenga elidentificador de usuario personalizado.

Para asignarel identificador de usuario personalizado al identificador de seguimiento web de Singular:

  1. En su cuenta de Google Tag Manager, haga clic en Etiquetas > Nuevo.
  2. En la ventana Configuración de etiquetas, haga clic enConfiguración de etiquetas y, en el menúTipo de etiqueta, seleccione "Seguimientoweb de Singular".
  3. En Tipode seguimiento, seleccione "Establecer Id. de usuario personalizado del dispositivo".
  4. En ID de usuario personalizado, introduzca la variable de Google Tag Manager que contiene el ID de usuario.
  5. Haga clic en Activación y añada el evento de activación.
  6. Haga clic en Guardar.

Screen_Shot_2020-04-13_at_18.14.29.png