Integración de un SDK Singular: Planificación y requisitos previos

Seguir
Avatar
Jared Ornstead
Updated
Documento

Requisitos previos para la integración SDK

Pasos preliminares esenciales necesarios antes de cualquier integración de Singular SDK, que abarcan la planificación, el registro de aplicaciones, la configuración de dominios y la preparación de pruebas.

Pasos preliminares necesarios: Los siguientes pasos son necesarios para cualquier integración de Singular SDK.

Aprenda a planificar la integración de SDK, registrar aplicaciones para el desarrollo, crear dominios para el seguimiento de enlaces y preparar flujos de trabajo de pruebas durante y después de la implementación.

Público objetivo Equipos comerciales, equipos de marketing, equipos de desarrollo
Requisitos previos Acceso a la cuenta de Singular, ID de paquete de aplicaciones, definiciones de KPI de marketing

Visión general de la integración

Colaboración interfuncional

El éxito de la integración de Singular SDK requiere la colaboración entre los equipos de marketing, negocio y desarrollo para definir los requisitos, configurar el seguimiento y validar la implementación.

Responsabilidades del equipo:

Equipo Responsabilidades
Marketing/Negocio
  • Definir los requisitos de seguimiento de eventos y los KPI de marketing
  • Seleccionar el dominio de enlace para el seguimiento de campañas
  • Configurar los ajustes de la aplicación de producción en la plataforma Singular
  • Revisar y aprobar los procedimientos de prueba
Desarrollo
  • Implementar la integración SDK siguiendo las especificaciones técnicas
  • Registrar la aplicación de desarrollo/pruebas en la plataforma Singular
  • Configurar los gestores de enlaces profundos y enlaces de seguimiento
  • Ejecutar los procedimientos de prueba y validación

Paso 1: Planificar la integración del SDK

Antes de iniciar la integración del SDK, los equipos de marketing y de negocio deben responder a preguntas clave que permitan al equipo de desarrollo implementar las características y funcionalidades adecuadas del SDK.

Cumplimiento de la privacidad infantil

Aplicaciones dirigidas a niños

Pregunta: ¿Está esta aplicación dirigida explícitamente a los niños?

Las aplicaciones dirigidas a niños deben cumplir con las políticas de Play Store y App Store que salvaguardan la privacidad de los niños. Singular ofrece SDK especializados para el cumplimiento.

Solución recomendada: Utiliza los SDK para aplicaciones infantiles de Singular, que ayudan a cumplir con las políticas de privacidad al no capturar identificadores de dispositivos.

Configuración de enlaces profundos

Gestión de enlaces profundos

Pregunta: ¿Manejará la aplicación enlaces profundos?

Los enlaces profundos permiten dirigir a los usuarios a contenidos específicos dentro de la aplicación desde fuentes externas como campañas de marketing, notificaciones push o páginas web.

Requisitos de implementación:

  • Requisitos previos: Siga los requisitos previos de Singular Linkspara la configuración del dominio y la plataforma.
  • Gestor de enlaces profundos: Implementa el manejador en código como se explica en la guía SDK relevante (iOS, Android, React Native, etc.)
  • Pruebas: Validar la funcionalidad de deep link mediante Testing Console y procedimientos de prueba manuales

Estrategia de seguimiento de eventos

Planificación de eventos en la aplicación

Pregunta: ¿Rastreará la aplicación los eventos del usuario?

Singular recopila datos de eventos dentro de la aplicación para analizar el rendimiento de la campaña y medir los KPI. La estrategia de eventos debe alinearse con los objetivos de marketing y la medición del valor para el usuario.

Eventos estándar
#

Beneficios de los Eventos Estándar

Singular soporta una variedad de eventos estándarcomúnmente utilizados en todos los verticales y a menudo apoyados por las redes publicitarias para la presentación de informes y optimización.

Ventajas:

  • Reconocimiento automático: Singular reconoce automáticamente los eventos estándar y los añade a la lista de eventos sin necesidad de definición manual.
  • Soporte de socios: Las redes publicitarias admiten eventos estándar para la optimización de campañas y la generación de informes.
  • Alineación con el sector: Nomenclatura coherente entre plataformas y socios
  • Mejores prácticas: Enfoque recomendado siempre que los eventos coincidan con las definiciones estándar

Atributos de eventos estándar

Para cada evento estándar, pase los atributos estándar recomendados para una completa captura de datos y compatibilidad de socios.

Ejemplo: sng_content_view event (user views product) should include:

  • sng_attr_content_type - Tipo de contenido visualizado
  • sng_attr_content_id - Identificador único del contenido
  • sng_attr_content - Descripción o nombre del contenido

Recursos de estrategia de eventos

Los equipos de UA/marketing/negocios deben compilar una lista de eventos basada en los KPI de marketing utilizando los siguientes recursos:

Nombres de eventos específicos de la plataforma

Nota para desarrolladores: la integración del SDK puede requerir formatos de nombre de evento/atributo ligeramente diferentes (todo en mayúsculas, sin guiones bajos, etc.) en función de la plataforma de desarrollo.

Listas específicasde plataforma:

Eventos personalizados
#

Definición de Eventos Personalizados

Si los eventos no coinciden con los eventos estándar de Singular, defina eventos personalizados con nombres personalizados para requisitos de seguimiento específicos.

Directricespara eventospersonalizados:

  • Límite de caracteres: Máximo 32 caracteres
  • Idioma: Se recomiendan nombres en inglés para que sean compatibles con los socios de la red publicitaria que reciben eventos de Singular
  • Convención de nomenclatura: Utilice una nomenclatura descriptiva y coherente para mayor claridad y mantenimiento
  • Documentación: Mantener un catálogo de eventos que documente los nombres y propósitos de los eventos personalizados.

Alcance del seguimiento de eventos

Práctica recomendada: Envíe eventos a Singular sólo si es necesario para fines relacionados con el marketing. Si el evento no es significativo como KPI de rendimiento de campaña o indicador de valor del usuario, Singular no debe realizar el seguimiento del evento.

Criterios de selección de eventos:

  • Relevancia para el marketing: El evento proporciona información para la optimización de la campaña
  • Medición de KPI: El evento contribuye a los indicadores clave de rendimiento
  • Valor para el usuario: El evento indica el compromiso del usuario o la monetización
  • Optimización de socios: Evento utilizado por redes publicitarias para la segmentación de campañas

Configuración específica de iOS

Implementación de SKAdNetwork

Pregunta (iOS): ¿Implementará la aplicación SKAdNetwork?

SKAdNetwork permite la atribución preservando la privacidad en iOS sin requerir permiso de seguimiento a nivel de usuario. Singular admite dos modos de implementación.

Modos de SKAdNetwork:

  • Modo gestionado: Singular actualiza automáticamente los valores de conversión basándose en reglas predefinidas.
  • Modo Manual: Tu app actualiza los valores de conversión directamente usando métodos del SDK

Transparencia del seguimiento de la aplicación

Pregunta (iOS): ¿Pedirá la app permiso al usuario para compartir información de seguimiento (ATT)?

Singular recomienda mostrar la solicitud de ATT porque el opt-in del usuario permite compartir el ID del dispositivo (IDFA), mejorando la precisión de la atribución de la instalación.

Requisitos de configuración: Si se muestra la solicitud de ATT, configure el SDK para retrasar la inicialización de Singular hasta que el usuario responda a la solicitud. Esto asegura que la atribución captura el estado correcto de autorización de seguimiento.

Implementaciónde ATT:

  • Tiempo de aviso: Mostrar aviso ATT antes de inicializar Singular SDK.
  • Configuración de SDK: Utilice las opciones de configuración del SDK para esperar la respuesta de la ATT.
  • Captura IDFA: Si el usuario concede permiso, se recopila IDFA para la atribución determinista
  • Atribución Fallback: Si el usuario deniega el permiso, la atribución utiliza huellas dactilares e IDFV

Paso 2: Registro de la aplicación de desarrollo

Registre la aplicación de desarrollo/pruebas en la plataforma Singular utilizando un ID de paquete distinto al de la aplicación de producción para mantener la separación de datos durante las pruebas.

Estrategia de ID de paquete

Desarrollo frente a producción

Se utiliza la misma clave SDK y clave secreta para las aplicaciones de producción y de prueba. Una vez guardados los datos en Singular, no se pueden eliminar.

Enfoque recomendado: Utilice un identificador de paquete diferente para la aplicación de prueba a fin de mantener los datos separados de los de la aplicación de producción. Cambie el identificador de paquete a la versión de producción antes de lanzar la aplicación a las tiendas.

Ejemplo de ID de paquete:

Entorno ID de paquete
Producción com.myapp
Desarrollo/Pruebas com.myapp.dev

Pasos para el registro de aplicaciones

Configuración de la plataforma

Cómo registrar una aplicación de desarrollo
#

Procedimiento de registro

  1. Navegue hasta Apps: En la plataforma Singular, vaya a Configuración → Apps y haga clic en Añadir nueva App .
  2. Introduzca el nombre de la App: Introduzca el nombre de la app para la app de desarrollo (se recomienda utilizar Bundle ID para mayor claridad)
  3. Seleccionar Plataforma: Selecciona el SO correspondiente a la plataforma de la app (iOS o Android)
  4. Configure Bund le ID: Seleccione la opción Bundle ID e introduzca la versión de desarrollo de Bundle Identifier, después guarde la app
  5. Sólo iOS - Configuración avanzada: Después de guardar la aplicación, haga clic en la flecha junto al nombre de la aplicación para ver los detalles.
    • Activar la opción Mostrar ajustes avanzados
    • Añadir ID de equipo (necesario para enlaces universales)
    • Añadir esquema (necesario para enlaces profundos)

Actualizaciones posteriores al desarrollo

Tras finalizar el desarrollo y las pruebas

  1. Actualizar el ID del paquete: Cambiar el ID del paquete a la versión de producción en la configuración de la aplicación.
  2. Configuración de la aplicación de producción: El equipo de marketing añade la aplicación de producción siguiendo las instrucciones de las preguntas frecuentes sobre configuración de aplicaciones.

Importante: Asegúrese de que el ID del paquete se actualiza al valor de producción antes de publicar la aplicación en App Store o Play Store. Los Bundle ID no coincidentes impiden la atribución y el seguimiento adecuados.

Paso 3: Crear dominio de enlace

Establezca un dominio personalizado para los enlaces de seguimiento de Singular que permita URL de campaña de marca y funcionalidad de enlace profundo.

Estructura del dominio de enlace

Formato de enlace singular

Los enlaces singulares (enlaces de seguimiento singulares) siguen una estructura estandarizada con un subdominio personalizado: 

https://[SUBDOMAIN].sng.link/[PARAMETERS]

Ejemplo: Para la aplicación llamada "Jewel Rush", cree el dominio jewelrush.sng.linkpermitiendo enlaces de seguimiento con estructura: 

https://jewelrush.sng.link/[PARAMETERS]

Estrategia de dominio

Dominio único frente a múltiples dominios

Las organizaciones pueden utilizar un único dominio para todos los enlaces o crear múltiples dominios para diferentes propósitos (aplicaciones, marcas, campañas, etc.).

Requisito: Se requiere al menos un dominio antes de utilizar Enlaces de Seguimiento Singulares. El equipo de marketing debe participar en la selección del dominio, ya que aparece en las campañas de marketing y en los materiales de cara al usuario.

Casos de uso del dominio:

  • Dominio único: Un dominio para todos los enlaces de seguimiento en todas las aplicaciones y campañas.
  • Específico de la aplicación: dominio independiente por aplicación para mayor claridad de la marca.
  • Específico de campaña: Diferentes dominios para diferentes tipos de campaña
  • Dominios geográficos: Dominios regionales para campañas localizadas

Configuración de dominios iOS

Configuración de dominios asociados

Al integrar Singular SDK en aplicaciones iOS, añada el dominio de enlace en la configuración de dominios asociados de Xcode para la compatibilidad con enlaces universales.

Formato de dominio asociado: 

applinks:[DOMAIN].sng.link

Ejemplo: 

applinks:jewelrush.sng.link

Recursos adicionales: Para obtener instrucciones completas sobre la instalación y configuración de dominios, consulte Requisitos previos de Singular Links.

Paso 4: Planificar las pruebas de integración

Valide la funcionalidad de integración SDK/S2S antes de lanzar la aplicación utilizando las herramientas de prueba y los procedimientos de verificación de Singular.

Estrategia de pruebas

Fases de las pruebas

Las pruebas integrales se realizan en dos fases: durante la implementación para la validación en tiempo real y después de la implementación para la verificación completa de la integración.

Pruebas durante la implementación
#

Herramientas de validación en tiempo real

Pruebe las funciones a medida que se implementan mediante herramientas de validación en tiempo real que proporcionan información inmediata.

Consola de pruebas

Utilice la Consola de Pruebaspara probar manualmente diferentes funciones del SDK en tiempo real tal y como se implementan.

Ventajas de la consola de pruebas:

  • Feedback en tiempo real: Validación inmediata de las llamadas al SDK y de la transmisión de datos.
  • Característica por característica: Pruebe características individuales de forma incremental durante el desarrollo
  • Soporte de depuración: Identificación inmediata de problemas de configuración y datos
  • Seguimiento de sesiones: Verifique la inicialización de la sesión y el seguimiento de eventos

Herramientas de depuración de terceros

Enfoque de pruebas alternativo que utiliza herramientas de proxy para la inspección y validación del tráfico.

Configuración de Charles Proxy:

  • Instale Charles Proxyo una herramienta de inspección de red similar
  • Habilite el proxy SSL para la inspección del tráfico HTTPS
  • Verificación de datos singulares activados en el momento correcto con los parámetros correctos
  • Validar las llamadas al punto final de la API y los códigos de respuesta
Pruebas después de la implementación
#

Herramientas de validación completas

Tras completar la implantación, utilice herramientas automatizadas y manuales para la verificación completa de la integración.

Informe de auditoría del SDK

Ejecuteel informe de auditoría del SDKpara identificar automáticamente los problemas de integración y recibir las soluciones recomendadas.

Características del informe de auditoría:

  • Detección automática: Identifica las funciones del SDK que faltan o están mal configuradas.
  • Validación de mejores prácticas: Verifica la implementación según las recomendaciones de Singular
  • Recomendaciones prácticas: Proporciona soluciones específicas para los problemas identificados
  • Cobertura exhaustiva: Comprueba todas las funciones y configuraciones del SDK

Verificación de registros de exportación

Descargue datos a nivel de usuario utilizando la página Export Logspara revisar todos los datos transmitidos correctamente desde la aplicación a Singular.

Detalles de los registros de exportación:

  • Formato de datos: Archivo CSV con datos completos a nivel de usuario
  • Plazos: Aproximadamente 30 minutos antes de que los datos estén disponibles
  • Validación: Verificación de eventos, sesiones y datos de atribución
  • Depuración: Identificar eventos omitidos o datos incorrectos

Pruebas de enlaces profundos

Pruebe los enlaces profundossiguiendo las instrucciones de Cómo probar la integración de Singular SDK.

Casos de prueba de enlaces profundos:

  • Universal Links: Pruebe los enlaces universales de iOS y los enlaces de aplicaciones de Android
  • Esquemas personalizados: Verifique el manejo de esquemas de URL personalizados
  • Enlaces profundos diferidos: Pruebe los enlaces en los que se hace clic antes de la instalación de la aplicación
  • Parámetros de campaña: Validar el paso de parámetros y la atribución

Verificación de la atribución

Utilice la API de detalles de atribución para consultar los detalles de atribución del dispositivo después de la prueba. Los datos de atribución están disponibles aproximadamente 4-6 minutos después del evento.

Aprenda a verificar la atribución utilizando el punto final de detalles de atribución.

Pasos de la verificación de atribución:

  1. Ejecutar la prueba: Instale la aplicación y complete el recorrido del usuario de prueba.
  2. Espere a que se procese: Espere entre 4 y 6 minutos a que se procese la atribución
  3. Consultar API: Utilice la API de detalles de atribución con el identificador de dispositivo
  4. Verificar resultados: Confirme la atribución a la campaña y fuente correctas

Recursos adicionales para las pruebas

Guía completa de pruebas

Para conocer los procedimientos de prueba completos, las mejores prácticas y la resolución de problemas, consulte Cómo probar la integración de Singular SDK.

Lista de comprobaciónde pruebas:

  • La consola de pruebas valida las llamadas al SDK en tiempo real
  • El informe de auditoría SDK confirma la integración completa
  • Los registros de exportación verifican la transmisión de datos
  • Los enlaces profundos funcionan correctamente en todos los escenarios
  • La atribución coincide con la fuente de campaña esperada
  • Los eventos se rastrean con los nombres y atributos correctos
  • Los eventos de ingresos capturan el importe y la divisa

Pasos siguientes

Una vez completados los requisitos previos, proceda a la integración del SDK específico de la plataforma o a la implementación de S2S.

Guías de integración SDK

Recursos adicionales