Visión general de la API
Fanplayr 360 ofrece muchas integraciones para introducir datos en nuestro sistema, pero si necesita obtener datos de una aplicación que aún no admitimos, como una aplicación de teléfono o un CRM personalizado, también tenemos opciones para ello.
Eventos
Los eventos son la forma principal de introducir datos en Fanplayr 360. Consisten en un nombre de evento y pares clave/valor de atributos.
En general, los atributos serán valores escalares como un número o una cadena, pero cuando se utilizan con Objetos Semánticos pueden ser más complejos.
Un ejemplo para decir que a un usuario se le mostró un producto sorpresa (¡es una tienda de magos!) se vería así (usando la API de JavaScript):
// cualquier cadena puede usarse como nombre del evento
fp360.track('Suprise Product', {
// un atributo personalizado
websiteSection: 'wizard-shop',
// un atributo y objeto semántico
$product: {
id: 'BF203',
name: 'Beautiful Training Staff #1',
price: 12.99,
currency: 'EUR'
}
});
Otras Interacciones
Las otras interacciones que puede utilizar son:
Añadir información de identificación a un usuario. Por ejemplo, "Este usuario se identifica por la dirección de correo electrónico usuario@dominio.com". Si identifica a un usuario de nuevo con la misma dirección de correo electrónico, Fanplayr 360 fusionará los Perfiles y Eventos de este usuario.
Establecer el consentimiento para un usuario. Por ejemplo, "Este usuario ha consentido ser contactado por teléfono, en el número 555-555-5555 con fines de marketing".
API de JavaScript
La forma más sencilla de introducir datos en nuestro sistema es utilizando nuestra API de JavaScript. Tenemos una librería que maneja todas las complejidades por usted para que pueda simplemente añadir fp360.track('EVENT', { data })
a su sitio web para empezar.
Carritos de Compra
Aún más fácil, tenemos instrucciones de integración preconstruidas que utilizan la API de JavaScript internamente.
API Personalizada
Para enviar eventos y establecer atributos de perfil en Fanplayr 360, ya proporcionamos una API de JavaScript, pero es posible que desee obtener datos en Fanplayr 360 de un servicio que aún no admitimos, como su aplicación de teléfono.
Para hacer esto, todo lo que necesita es una WRITE_KEY y un ENDPOINT que puede obtener creando una integración Personalizada.
Entonces puede crear un POST
al ENDPOINT. Fácil (para su desarrollador).
Datos Semánticos
Si utiliza la API de JavaScript o escribe su propia API personalizada, es bueno conocer los Datos Semánticos para aprovechar al máximo el sistema.