Integrando un SDK singular: planificación y requisitos previos

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

Aprenda a planificar su integración SDK, registrar una aplicación para el desarrollo, crear un dominio para el seguimiento de enlaces y planificar cómo probar su integración durante y después del desarrollo.

Guía para Equipos comerciales/de marketing
1

Planifique su integración SDK

Antes de empezar a integrar el SDK de Singular, el equipo de marketing/negocios debe responder a las siguientes preguntas. Esto permitirá al equipo de desarrollo saber qué características y funcionalidades del SDK deben habilitarse.

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

Las aplicaciones para niños deben cumplir con las políticas de Play Store y App Store para salvaguardar la privacidad de los niños. Recomendamos utilizar los SDK para aplicaciones infantiles de Singular, que ayudan a cumplir estas políticas al no capturar identificadores de dispositivos.

¿Manejará la aplicación enlaces profundos?

Siga las instrucciones en Singular Links Prerequisitesy luego implemente un controlador de enlaces profundos en su código como se explica en la guía SDK correspondiente.

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

Singular puede recopilar datos sobre eventos dentro de la aplicación 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, finalización de tutoriales o subidas de nivel en una aplicación de juegos.

Eventos estándar

Singular admite una serie de eventos estándar, que las redes publicitarias suelen utilizar para la generación de informes y la optimización. Otra ventaja es que cuando utiliza nombres de eventos estándar, Singular los reconoce automáticamente y los añade a la lista de eventos sin que tenga que definirlos manualmente. Recomendamos utilizar eventos estándar siempre que sea posible.

Para cada evento estándar, debe pasar los atributos estándar recomendados. Por ejemplo, para un evento sng_content_view(el cliente ve un producto), debe pasar los atributos sng_attr_content_type, sng_attr_content_id y sng_attr_content.

La lista de eventos enviados a Singular (con los atributos correspondientes) debe ser recopilada por el equipo de UA/marketing/negociobasándose en sus KPI de marketing. Las siguientes guías son útiles para crear una estrategia de eventos:

Importante: Al integrar un SDK de Singular en su aplicación, es posible que su equipo de desarrolladores deba utilizar una versión ligeramente diferente de los nombres de eventos/atributos(todo en mayúsculas, sin subrayar, etc.) en función de la plataforma de desarrollo. Consulte las listas de nombres de eventos y atributos para iOS, Android, Unity, React y Flutter.

Eventos personalizados

Si desea medir eventos que no coinciden con ninguno de los eventos estándar de Singular, puede definir sus propios eventos personalizados con nombres personalizados.

El equipo de desarrollo puede utilizar cualquier nombre personalizado (con un máximo de 32 caracteres). Recomendamos utilizar nombres en inglés para que sean compatibles con cualquier socio de red publicitaria que pueda recibir el evento de Singular con fines de optimización.

Consejo: Envíe eventos a Singular sólo si necesita que sean rastreados con fines relacionados con el marketing. Si un evento no es significativo como KPI para el rendimiento de la campaña o el valor del usuario, Singular no debe realizar un seguimiento de ese evento.

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

Puede utilizar los métodos del SDK para habilitar SKAN en Modo Gestionado (donde el valor de conversión es actualizado por Singular) o en Modo Manual (donde usted mismo actualiza el valor de conversión).

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

Recomendamos mostrar la solicitud de ATT porque si el usuario opta por compartir su ID de dispositivo, esto ayuda a atribuir la instalación correctamente.

Si muestra el mensaje ATT, debe configurar el SDK para retrasar la inicialización de Singular en su aplicación hasta que el usuario responda.

2

Registro de una aplicación de desarrollo/prueba

Identificador del paquete de aplicaciones

Se utiliza la misma clave SDK y clave secreta para las aplicaciones de producción y de prueba. Una vez que los datos de prueba/producción se han guardado en Singular, no se pueden borrar.

Teniendo esto en cuenta, recomendamos utilizar un identificador de paquete diferente para su aplicación de prueba para mantener los datos separados de la eventual aplicación de producción.

Por ejemplo, si tu aplicación de producción utiliza el identificador de paquete com.myapp, puedes utilizar com.myapp. dev para la fase de desarrollo. A continuación, puede volver a cambiar el identificador de paquete a la versión de producción antes de publicar su aplicación en las tiendas de aplicaciones.

Pasos para registrar una aplicación

  1. En la plataforma Singular, vaya a Configuración > Aplicacionesy haga clic en Añadir nueva aplicación.
  2. Introduzca un nombre para la aplicación de desarrollo. Recomendamos utilizar el Bundle ID.
  3. Seleccione el sistema operativo correspondiente a la plataforma de la aplicación.
  4. Identifique la app utilizando la opción Bundle ID, e introduzca la versión de desarrollo de su bundle Identifier. Guarde la app.
  5. Para aplicaciones iOS: después de guardar la aplicación, haga clic en la flecha situada junto al nombre de la aplicación para ver los detalles de la aplicación y active la opción Mostrar configuración avanzada. Añada su TeamID y Scheme. Esto es necesario para Universal Links y deep linking.

Cuando termine de desarrollar y probar la aplicación, actualice el ID del paquete a la versión de producción y deje que el equipo de marketing añada la aplicación de producciónsiguiendo las instrucciones de las Preguntas frecuentes sobre configuración de aplicaciones.

3

Cree un dominio de enlace (si aún no tiene uno)

Los enlaces singulares (enlaces de seguimiento singulares) tienen la siguiente estructura, donde [SUBDOMINIO] lo elige usted:

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

Por ejemplo, para una campaña que comercializa una aplicación llamada Jewel Rush, puede crear el dominio "jewelrush.sng.link". A continuación, puede utilizarlo para crear enlaces de seguimiento con la siguiente estructura:

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

Puedes utilizar un único dominio para todos tus enlaces, o puedes crear varios para utilizarlos con distintos fines. En cualquier caso, se requiere al menos un dominio para poder utilizar los enlaces de seguimiento singulares.

El equipo de marketing de la organización debe participar en la decisión sobre el dominio del enlace, ya que se expondrá en las campañas de marketing.

Al integrar Singular SDK en aplicaciones iOS, debe añadir el dominio de enlace en la configuración de dominios asociados de Xcode en forma de:

applinks:[DOMAIN].sng.link

Ver también: Singular Links Requisitos previos.

4

Aprenda a probar su integración

Al integrar Singular SDK/S2S en su aplicación, es importante asegurarse de que funciona correctamente antes de lanzar la nueva versión de laaplicación.

Singular ofrece una selección de herramientas para probar la integración:

Pruebas durante la implementación:

  • Utiliza la Consola de Pruebas, que te permite probar manualmente las diferentes funcionalidades que implementas, a medida que las implementas en tiempo real.
  • O utilice una herramienta de terceros como Charles Proxycon el proxy SSL activado para verificar que los datos de Singular se activan en el momento correcto con los puntos de datos correctos.

Pruebas después de la implementación:

Para obtener más consejos sobre las pruebas, consulte Cómo probar la integración de Singular SDK.