Integración del SDK de Singular: planificación y requisitos previos

Seguir
Avatar
Jared Ornstead
Updated

Requisitos previos para la integración del SDK

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

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

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

Público objetivo Equipos de negocio, equipos de marketing, equipos de desarrollo
Requisitos previos Acceso a la cuenta de Singular, Bundle ID de la aplicación, definiciones de KPIs de marketing

Descripción general de la integración

Colaboración interfuncional

Una integración exitosa del SDK de Singular requiere la colaboración entre los equipos de marketing, negocio y desarrollo para definir 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 KPIs de marketing
  • Seleccionar el dominio del 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 del SDK siguiendo las especificaciones técnicas
  • Registrar la aplicación de desarrollo/pruebas en la plataforma Singular
  • Configurar el deep linking y los manejadores de enlaces de seguimiento
  • Ejecutar los procedimientos de prueba y validación

Paso 1: Planificar la integración del SDK

Antes de comenzar la integración del SDK, los equipos de marketing y negocio deben responder 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: ¿Esta aplicación está dirigida explícitamente a niños?

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

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

Configuración de deep linking

Manejo de deep links

Pregunta: ¿La aplicación manejará deep links?

El deep linking permite dirigir a los usuarios a contenido específico 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 Links para la configuración del dominio y la plataforma.
  • Manejador de deep links: Implemente el manejador en el código según se explica en la guía del SDK correspondiente (iOS, Android, React Native, etc.).
  • Pruebas: Valide la funcionalidad de deep linking usando la Testing Console y los procedimientos de prueba manual.

Estrategia de seguimiento de eventos

Planificación de eventos en la aplicación

Pregunta: ¿La aplicación realizará seguimiento de eventos de usuario?

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

Eventos estándar

Beneficios de los eventos estándar

Singular admite una variedad de eventos estándar comúnmente utilizados en diferentes verticales y que frecuentemente son compatibles con las redes publicitarias para informes y optimización.

Ventajas:

  • Reconocimiento automático: Singular reconoce los eventos estándar automáticamente y los agrega a la lista de eventos sin necesidad de definición manual.
  • Soporte de partners: Las redes publicitarias admiten eventos estándar para la optimización e informes de campañas.
  • Alineación con la industria: Nomenclatura consistente entre plataformas y partners
  • Mejores prácticas: Enfoque recomendado cuando los eventos coinciden con las definiciones estándar

Atributos de eventos estándar

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

Ejemplo: El evento sng_content_view (el usuario visualiza un producto) debe incluir:

  • 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/negocio deben compilar la lista de eventos basándose en los KPIs de marketing utilizando los siguientes recursos:

Nombres de eventos específicos por plataforma

Nota para desarrolladores: La integración del SDK puede requerir formatos de nombres de eventos/atributos ligeramente diferentes (todo en mayúsculas, sin guiones bajos, etc.) según la plataforma de desarrollo.

Listas por 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 propios para requisitos de seguimiento específicos.

Pautas para eventos personalizados:

  • Límite de caracteres: Máximo 32 caracteres
  • Idioma: Se recomienda usar nombres en inglés para compatibilidad con los partners de redes publicitarias que reciben eventos de Singular.
  • Convención de nombres: Use nombres descriptivos y consistentes para mayor claridad y mantenimiento.
  • Documentación: Mantenga un catálogo de eventos que documente los nombres y propósitos de los eventos personalizados.

Alcance del seguimiento de eventos

Mejor práctica: Envíe eventos a Singular solo si son necesarios para fines relacionados con el marketing. Si un evento no es significativo como KPI de rendimiento de campaña o indicador de valor del usuario, ese evento no debería ser rastreado por Singular.

Criterios de selección de eventos:

  • Relevancia para el marketing: El evento proporciona información para la optimización de campañas.
  • Medición de KPIs: El evento contribuye a los indicadores clave de rendimiento.
  • Valor del usuario: El evento indica el engagement o la monetización del usuario.
  • Optimización de partners: El evento es utilizado por las redes publicitarias para la orientación de campañas.

Configuración específica de iOS

Implementación de SKAdNetwork

Pregunta (iOS): ¿La aplicación implementará SKAdNetwork?

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

Modos de SKAdNetwork:

  • Modo administrado: Singular actualiza automáticamente los valores de conversión según reglas predefinidas.
  • Modo manual: La aplicación actualiza los valores de conversión directamente usando los métodos del SDK.

App Tracking Transparency (ATT)

Pregunta (iOS): ¿La aplicación solicitará permiso al usuario para compartir información de seguimiento (ATT)?

Singular recomienda mostrar el mensaje de ATT porque el consentimiento del usuario permite compartir el ID del dispositivo (IDFA), mejorando la precisión de la atribución de instalaciones.

Requisito de configuración: Si se muestra el mensaje de ATT, configure el SDK para retrasar la inicialización de Singular hasta que el usuario responda al mensaje. Esto garantiza que la atribución capture el estado correcto de autorización de seguimiento.

Implementación de ATT:

  • Momento del mensaje: Muestre el mensaje de ATT antes de inicializar el SDK de Singular.
  • Configuración del SDK: Use las opciones de configuración del SDK para esperar la respuesta de ATT.
  • Captura del IDFA: Si el usuario otorga permiso, se recopila el IDFA para la atribución determinista.
  • Atribución alternativa: Si el usuario deniega el permiso, la atribución utiliza fingerprinting e IDFV.

Paso 2: Registrar la aplicación de desarrollo

Registre la aplicación de desarrollo/pruebas en la plataforma Singular usando un Bundle ID separado de la aplicación de producción para mantener la separación de datos durante las pruebas.

Estrategia de Bundle ID

Desarrollo vs. Producción

Se usa el mismo SDK Key y Secret Key tanto para las aplicaciones de producción como de pruebas. Una vez que los datos se guardan en Singular, no se pueden eliminar.

Enfoque recomendado: Use un Bundle Identifier diferente para la aplicación de pruebas para mantener los datos separados de la aplicación de producción. Cambie el Bundle ID a la versión de producción antes de publicar la aplicación en las tiendas.

Ejemplo de Bundle ID:

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

Pasos para el registro de la aplicación

Configuración de la plataforma

Cómo registrar la aplicación de desarrollo

Procedimiento de registro

  1. Navegar a Apps: En la plataforma Singular, vaya a Settings → Apps y haga clic en Add New App.
  2. Ingresar el nombre de la aplicación: Ingrese el nombre de la aplicación de desarrollo (se recomienda usar el Bundle ID para mayor claridad).
  3. Seleccionar la plataforma: Seleccione el sistema operativo correspondiente a la plataforma de la aplicación (iOS o Android).
  4. Configurar el Bundle ID: Seleccione la opción Bundle ID e ingrese la versión de desarrollo del Bundle Identifier y luego guarde la aplicación.
  5. Solo 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.
    • Active la opción Show Advanced Settings.
    • Agregue el Team ID (necesario para Universal Links).
    • Agregue el Scheme (necesario para el deep linking).

Actualizaciones posteriores al desarrollo

Después de finalizar el desarrollo y las pruebas:

  1. Actualizar el Bundle ID: Cambie el Bundle ID 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 agrega la aplicación de producción siguiendo las instrucciones del FAQ de configuración de aplicaciones.

Importante: Asegúrese de que el Bundle ID se haya actualizado al valor de producción antes de publicar la aplicación en App Store o Play Store. Los Bundle IDs que no coincidan impedirán la correcta atribución y el seguimiento.

Paso 3: Crear el dominio del enlace

Establezca un dominio personalizado para los enlaces de seguimiento de Singular que permita URLs de campaña con marca propia y funcionalidad de deep linking.

Estructura del dominio del enlace

Formato de los Singular Links

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

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

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

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

Estrategia de dominio

Dominio único vs. múltiples dominios

Las organizaciones pueden usar un dominio único 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 usar Singular Tracking Links. El equipo de marketing debe participar en la selección del dominio ya que aparecerá en las campañas de marketing y los materiales dirigidos 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 por aplicación: Dominio separado por aplicación para claridad de marca
  • Específico por campaña: Diferentes dominios para diferentes tipos de campaña
  • Geográfico: Dominios regionales para campañas localizadas

Configuración del dominio en iOS

Configuración de dominios asociados

Al integrar el SDK de Singular en aplicaciones iOS, agregue el dominio del enlace en la configuración de dominios asociados de Xcode para la compatibilidad con Universal Links.

Formato del dominio asociado:

applinks:[DOMAIN].sng.link

Ejemplo:

applinks:jewelrush.sng.link

Recursos adicionales: Para obtener instrucciones completas de configuración del dominio, consulte los requisitos previos de Singular Links.

Paso 4: Planificar las pruebas de integración

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

Estrategia de pruebas

Fases de prueba

Las pruebas exhaustivas 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 usando herramientas de validación en tiempo real que proporcionan retroalimentación inmediata.

Testing Console

Use la Testing Console para probar manualmente diferentes funciones del SDK en tiempo real a medida que se implementan.

Beneficios de la Testing Console:

  • Retroalimentación en tiempo real: Validación inmediata de las llamadas al SDK y la transmisión de datos
  • Función por función: Pruebe funciones individuales de forma incremental durante el desarrollo
  • Soporte de depuración: Identifique problemas de configuración y datos de inmediato
  • Seguimiento de sesiones: Verifique la inicialización de sesiones y el seguimiento de eventos

Herramientas de depuración de terceros

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

Configuración de Charles Proxy:

  • Instale Charles Proxy o una herramienta de inspección de red similar.
  • Habilite el proxy SSL para la inspección del tráfico HTTPS.
  • Verifique que los datos de Singular se activen en el momento correcto con los parámetros correctos.
  • Valide las llamadas al endpoint de la API y los códigos de respuesta.
Pruebas después de la implementación

Herramientas de validación exhaustiva

Después de completar la implementación, use herramientas automatizadas y manuales para la verificación completa de la integración.

Informe de auditoría del SDK

Ejecute el informe de auditoría del SDK para identificar automáticamente los problemas de integración y recibir soluciones recomendadas.

Características del informe de auditoría:

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

Verificación con Export Logs

Descargue datos a nivel de usuario usando la página Export Logs para revisar todos los datos transmitidos exitosamente desde la aplicación a Singular.

Detalles de Export Logs:

  • Formato de datos: Archivo CSV con datos completos a nivel de usuario
  • Tiempo: Aproximadamente 30 minutos antes de que los datos estén disponibles
  • Validación: Verifique los datos de eventos, sesiones y atribución.
  • Depuración: Identifique eventos faltantes o datos incorrectos.

Pruebas de deep linking

Pruebe los deep links siguiendo las instrucciones en "Cómo probar su integración del SDK de Singular".

Casos de prueba para deep links:

  • Universal Links: Pruebe iOS Universal Links y Android App Links.
  • Esquemas personalizados: Verifique el manejo del esquema de URL personalizado.
  • Deferred deep links: Pruebe los enlaces que se hicieron clic antes de la instalación de la aplicación.
  • Parámetros de campaña: Valide el paso de parámetros y la atribución.

Verificación de atribución

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

Aprenda a verificar la atribución usando el endpoint de detalles de atribución.

Pasos de verificación de atribución:

  1. Ejecutar la prueba: Instale la aplicación y complete el recorrido de usuario de prueba.
  2. Esperar el procesamiento: Aguarde 4-6 minutos para el procesamiento de atribución.
  3. Consultar la API: Use la API de detalles de atribución con el identificador del dispositivo.
  4. Verificar los resultados: Confirme la atribución a la campaña y la fuente correctas.

Recursos adicionales de pruebas

Guía de pruebas completa

Para procedimientos de prueba exhaustivos, mejores prácticas y resolución de problemas, consulte Cómo probar su integración del SDK de Singular.

Lista de verificación de pruebas:

  • La Testing Console valida las llamadas al SDK en tiempo real.
  • El informe de auditoría del SDK confirma la integración completa.
  • Export Logs verifica la transmisión de datos.
  • Los deep links 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 monto y la moneda.

Próximos pasos

Después de completar los requisitos previos, proceda con la integración del SDK específico de la plataforma o la implementación S2S.

Guías de integración del SDK

Recursos adicionales