Introducción a la API
La API de Tangiblee permite personalizar la UX de Tangiblee y controla el seguimiento de resultados implementado en su sitio web.
Principios de diseño
- Ocupa poco espacio - Minimice el tamaño del script, el tiempo de descarga y el tiempo de ejecución.
- Autónomo - Tangiblee no depende de ninguna dependencia externa como las bibliotecas de javascript.
- Navegador múltiple - La API es compatible con todos los navegadores populares, como Chrome, Safari, Firefox, IE, Edge y Opera, y con todas las plataformas, como iOS, Windows y Android.
- Descarga asincrónica - El script se descarga de forma asincrónica y no bloquea la descarga ni la representación de ningún otro script.
- Carga lenta - Si Tangiblee CDN es lento temporalmente, no bloquea el onLoad el evento desde que se desencadena hasta que nuestro sitio responde.
- Preservación de eventos - Los eventos utilizados no prevalecen sobre ningún evento en el sitio del cliente. Impacto mínimo.
- Sin contaminación del espacio de nombres - Tangiblee no usa variables globales que puedan entrar en conflicto con el javascript existente.
¿Cómo usarlo?
La integración de Tangiblee con un PDP consiste en dos bloques lógicos, la API de Tangiblee y el archivo mapper.js, que adapta la API a la estructura específica de PDP. A continuación encontrará una explicación detallada de cada uno de los bloques.
1. API tangible
Una capa de abstracción para todas las funcionalidades y capacidades de la interfaz de usuario compatibles con la plataforma de Tangiblee que se puede utilizar en una página web. Cada integración de Tangiblee en una página web utiliza la API de Tangiblee para acceder a Tangiblee, cargar la CTA e iniciar la experiencia de Tangiblee. El código que envuelve el API tangible y lo activa se llama Código de mapeo.
En el caso de Integración de autoservicio, el equipo de TI del cliente escribirá el mapper.js que llama API tangible; sin embargo, en el caso de Integración gestionada, el API tangible se llama desde Código de mapeo que proporciona Tangiblee.
2. tangiblee-mapper.js
Esta capa enlaza la página web o PDP a API tangible actuando como un mapeador de la información que existe en la página web y reestructura esa información para que se ajuste API tangible. El tangiblee-mapper.js es único para cada tipo particular de PDP y para el sitio web de cada cliente.
tangiblee-mapper.js puede ser creado, mantenido y hospedado por el cliente o por Tangiblee. Los PDP cambian y evolucionan continuamente con el tiempo, manteniendo así la tangiblee-mapper.js es fundamental para garantizar que la plataforma Tangiblee pueda funcionar sin errores.
Recapitulación:
Los principales datos apuntan a que tangiblee-mapper.js la lógica se une a la API tangible son:
- Código CTA: Manipule la CTA que activa Tangiblee y define la lógica de acciones como crear, mostrar/ocultar, retirar, y hacer.
- Código SKU: Asigne la lista de SKU actual y la información de los SKU activos de la página web a la plataforma Tangiblee. Esta parte es esencial para cargar los recursos visuales correctos desde el back-end de Tangiblee y ofrecer la experiencia correcta al usuario.
Funciones avanzadas: localización, botón de mostrar/ocultar el botón de añadir al carrito, mostrar/ocultar el precio y la moneda, personalización del seguimiento de Google Analytics, seguimiento de pedidos e ingresos.
