Hightouch es una plataforma de integración de datos que permite a las empresas sincronizar datos entre sus almacenes de datos y otras herramientas o plataformas que utilizan para análisis, marketing y operaciones. Permite a los usuarios conectar fácilmente su almacén de datos con herramientas como CRM, plataformas de automatización de marketing, sistemas de atención al cliente, etc., sin necesidad de complejos procesos ETL (Extract, Transform, Load) ni de codificación personalizada.
La integración de Hightouch con Singular envía datos de eventos móviles (iOS/Android) desde su fuente (almacén) de Hightouch mediante la API REST de servidor a servidor (S2S) de Singular. Esto se conoce como "Destino" en la plataforma Hightouch. Las siguientes instrucciones ilustran cómo configurar Singular Destination en Hightouch.
| Guía de requisitos para equipos de ingeniería |
|
Para utilizar esta integración, debe utilizar una fuente de Hightouch con todos los puntos de datos de Singular necesarios que coincidan con el último evento conocido del SDK de Singular Mobile.
Esta integración NO es compatible con datos de eventos no móviles. Los eventos de servidor o web no son compatibles.
-
Tipo de sincronización compatible con Hightouch: Eventos
Hightouch admite la sincronización de eventos de la aplicación con Singular
MODOS DE SINCRONIZACIÓN SOPORTADOS: Sólo inserción
- Eventos de sesión
- Eventos Web
- Eventos del lado del servidor sin puntos de datos móviles
La integración con Hightouch no sustituye al SDK de Singular. Debe utilizar el SDK de Singular en paralelo con Hightouch. Se trata de una integración híbrida en la que la recopilación de datos se produce tanto desde dentro del cliente a través de un SDK emitido por Singular como a través del punto final de la API REST para el mismo dispositivo/usuario. Cualquier evento enviado desde Hightouch a Singular se asociará al último dispositivo móvil conocido del usuario y se asociará a los últimos datos de campaña conocidos de dicho dispositivo.
Cómo empezar
Empiece creando una instancia de un destino Singular en Hightouch. Al crear su instancia, debe introducir la clave del SDK de Singular para la autenticación.
- En el menú de navegación de Hightouch, haga clic en: "Configuración > Destinos".
- Haga clic en el botón "Añadir destino".
- Busque "Singular" y haga clic en Continuar.
- Introduzca la clave SDK de Singular en el campo "Clave API". Y haga clic en Continuar.
Obtenga su "SDK KEY" de Singular, que encontrará en el panel de control de Singular en "Developer Tools > SDK Integration > SDK Keys".
- Asigne un nombre al destino y haga clic en "Finalizar".
Importante: Si hace clic en el botón "Probar conexión", es posible que aparezca el siguiente error:
Esto se debe únicamente a que la API requiere puntos de datos adicionales que se configurarán en los siguientes pasos.
Configuración adicional
Configurar un modelo
- Desde el menú de navegación de Hightouch seleccione "Modelos" y Añadir un Nuevo Modelo.
- Seleccione la Fuente de datos y haga clic en "Continuar".
- Proporcione un Nombre para el Modelo, y seleccione una Clave Primaria del desplegable.
Para garantizar que la sincronización envíe cada evento, su modelo de eventos debe utilizar una clave primaria realmente única. Consulte la documentación de sincronización de eventos para obtener más información.
Configurar una sincronización
- En el menú de navegación de Hightouch, seleccione "Sincronizar" y "Añadir sincronización".
- Seleccione el Modelo configurado para Singular.
- Seleccione el Destino Singular.
- Obligatorio: Seleccione la Columna de Nombre de Evento en el menú desplegable, que se utilizará como Nombre de Evento Singular.
- Obligatorio: Seleccione la columna de fecha y hora en el menú desplegable, que se utilizará como hora del evento singular.
- Seleccione las demás columnas que desea sincronizar con Singular.
Configure cómo asignar las columnas de los resultados de la consulta a los campos del destino. Tenga en cuenta que el destino Singular tiene algunos campos requeridos condicionalmente basados en el campo "plataforma".
Asignación de parámetros adicionales requeridos:
Consulte los Parámetros de evento requeridos en la Referencia de Singular S2S AQUÍ para obtener detalles sobre qué parámetros deben asignarse para un evento.
Si no mapea el campo IP, será mapeado por defecto con uno de los servidores de Hightouch.
Acerca de los Identificadores de Dispositivo
Para la correcta atribución de un Evento enviado desde Hightouch a un dispositivo existente en Singular, debe utilizarse un identificador de dispositivo coincidente. Si la opción de punto final de BI interno se configuró para capturar datos de un evento de inicio de sesión en el almacén, se debe utilizar el mismo identificador en esta solicitud de evento.
En el caso de iOS, sería el IDFA o el IDFV. No proporcione valores "NULL" ni identificadores a cero. Si el IDFA no estaba disponible en el dispositivo cuando se inicializó Singular SDK, Singular utilizará el valor IDFV.
Para Android, sería el AIFA (también conocido como GAID) o el ASID. No proporcione valores "NULL" ni identificadores a cero. Si el AIFA no estaba disponible en el dispositivo cuando se inicializó Singular SDK, Singular utilizará el valor ASID. Si ni los valores AIFA ni ASID están disponibles en el dispositivo, sólo entonces debe proporcionar el ID de Android (ANDI).
- Una vez asignados los parámetros, puede probar el evento utilizando el botón "Probar".
Capture el identificador de los datos de origen que se utilizan en la prueba y utilice la consola de pruebas de Singular para ver el evento que se recibe en tiempo real. Más información sobre cómo probar eventos AQUÍ.
Ejemplo:
El Mapeo
La Prueba
La Consola de Pruebas Singular - Una vez que la prueba se haya realizado con éxito, haga clic en Continuar y establezca su Tipo de Programación, y haga clic en "Finalizar".
Soporte SkAdNetwork
Para utilizar los eventos enviados desde Hightouch en los modelos de conversión SkAdNetwork(SKAN) de Singular, debe tener activada la función "Hybrid SKAN" en su cuenta de Singular. Póngase en contacto con su CSM o envíe una solicitud de soporte de Singular para activarla.
Eventos
Todos los registros añadidos a su fuente se tratan como nuevos eventos y se envían a Singular cuando se ejecuta la sincronización.
Puede utilizar asignaciones personalizadas para adjuntar datos personalizados relevantes para su aplicación.
Las asignaciones personalizadas se incluyen como parámetro "e" de la carga útil de la solicitud de API.
Consejos y solución de problemas
Discrepancias
Se producirán discrepancias si los identificadores de dispositivo utilizados en las solicitudes de eventos de servidor a servidor no tienen un identificador de dispositivo coincidente en Singular. Tenga en cuenta las siguientes posibilidades:
- Si se recibe una solicitud de evento "antes" de que Singular SDK haya registrado el identificador de dispositivo, desde una App Session, entonces la solicitud de evento se considerará la "primera sesión" para el dispositivo desconocido y Singular atribuirá el dispositivo como una atribución orgánica.
- Si Singular SDK registró un identificador de dispositivo, pero el identificador de Singular SDK difiere del identificador de dispositivo especificado en la solicitud de evento de servidor a servidor, entonces el evento se atribuirá incorrectamente.
Errores comunes
Si recibe errores, asegúrese de que está incluyendo todos los campos obligatorios de Singular: "Plataforma", "Nombre del paquete", "Versión del sistema operativo" e identificadores de dispositivo para la plataforma correspondiente.
Depurador en vivo
Hightouch proporciona una visibilidad completa de las llamadas a la API realizadas durante cada una de las ejecuciones de sincronización. Te recomendamos que leas nuestro artículo sobre consejos y trucos de depuración para obtener más información.
Alertas de sincronización
Hightouch puede avisarte de problemas de sincronización a través de Slack, PagerDuty, SMS o correo electrónico. Para más detalles, visita nuestro artículo sobre alertas.