Data

Objects

Los datos utilizados por la IA de Clerk.io para mostrar resultados.
Data Foundation

Foundation #

La verdadera personalización solo es posible cuando es consistente en cada punto de contacto.

La plataforma de datos unificada de Clerk.io garantiza que todas las herramientas compartan los mismos datos, ofreciendo una experiencia fluida y personalizada, ya sea que tus clientes estén chateando, buscando, navegando o recibiendo emails.

Privacidad #

La base de datos de Clerk.io está construida con la privacidad en mente, permitiendo una gran personalización sin comprometer la seguridad de los datos. Por defecto, somos cookieless y totalmente cumplimos con GDPR.

El núcleo de la IA de Clerk.io funciona con datos de pedidos y productos. Literalmente solo necesita saber qué fue comprado, en qué momento, para mostrar la gran mayoría de los resultados.

Al enviar también la dirección de email de los clientes, permites una verdadera personalización basada en el historial de compras individual. Esto es recomendable, pero no obligatorio.

Capas #

Cuando la IA muestra resultados, ocurre a través de 4 capas:

  1. Capa de datos, que contiene los datos en bruto como los atributos de productos y pedidos.

  2. Capa de IA, donde la IA de Clerk.io usa las conexiones en todos los datos para predecir resultados, en función de qué endpoint se utilice.

  3. Capa de merchandising, donde las Campañas pueden influir en los resultados.

  4. Capa de producto, donde la API de Clerk entrega los resultados finales.

A continuación, puedes leer sobre los diferentes puntos de datos que Clerk.io utiliza para potenciar su IA.

Productos #

Estos son el núcleo de la IA de Clerk.io. Se utilizan para comprender la estructura de tu catálogo y son la principal fuerza impulsora detrás de las conversiones adicionales que Clerk.io te ayuda a lograr.

Los productos tienen una serie de atributos obligatorios que son necesarios para que Clerk.io funcione correctamente, pero además de eso, puedes enviar todos los atributos que tengas disponibles en tu plataforma de eCommerce. Los atributos obligatorios son:

  • id
  • name
  • description
  • price
  • image
  • url
  • categories
  • created_at

A continuación, un ejemplo de un objeto Product:

 {
    "id": 135,
    "name": "Lightsaber",
    "description": "Antique Rebel Lightsaber",
    "price": 99995.95,
    "profit": 39998.38,
    "image": "https://galactic-empire-merch.com/images/a-r-lightsaber.jpg",
    "url": "https://galactic-empire-merch.com/antique-rebel-lightsaber",
    "created_at": 1622548800,
    "brand": "Je’daii",
    "categories": [987, 654],
    "sizes": ["M", "L", "XL"],
    "material": "Kyber Crystal",
    "color": {
      "name": "Emerald",
      "converted_name": "Green",
      "image": "https://galactic-empire-merch.com/images/a-r-lightsaber-emerald.jpg",
      "color_code": "#7CFC00"
    }
  }

Consulta la especificación completa de Products aquí.

También puedes proporcionar un atributo numérico opcional profit por producto en tu feed, o crearlo con AI Modifiers usando un margen estimado. El valor es un monto monetario por unidad. Consulta Profit para el cálculo y comportamiento histórico.

Categorías #

Estas se usan para agrupar productos juntos. Aunque son opcionales, se recomiendan altamente ya que ayudan a la IA de Clerk.io a entender cómo están conectados tus productos dentro de tu catálogo.

Por ejemplo, nuestra lógica de Alternativas depende en gran medida de las categorías para entender cuáles son los artículos más similares y todas las lógicas relacionadas con Categoría requieren que estén presentes.

Las categorías se envían a Clerk.io de la misma manera que los productos, pero tienen un conjunto diferente de atributos.

Puedes enviar tantos atributos de categoría como desees para fines de estilo (por ejemplo, una imagen, una descripción, etc.), pero solo los atributos obligatorios son usados por Clerk.io para mostrar resultados.

Los atributos obligatorios son:

  • id
  • name
  • subcategories
  • url

A continuación, un ejemplo de un objeto Category:

{
    "id": 123,
    "name": "Lightsabers",
    "subcategories": [456, 789],
    "url": "https://galactic-empire-merch.com/lightsabers"
}

Consulta la especificación completa de Categories aquí.

Pedidos #

Estos son cruciales para obtener el mejor rendimiento con Clerk.io, ya que la IA utiliza los datos de pedidos para comprender cómo los clientes interactúan con tus productos.

Todo, desde los resultados de búsqueda hasta las predicciones de Audience, utiliza los datos de pedidos para identificar patrones en las acciones futuras de los clientes.

Los atributos obligatorios son:

  • id
  • products
  • time

Además, recomendamos enviar el atributo email, que contiene la dirección de email del cliente, permitiendo la personalización y segmentación en Audience.

También es posible enviar el status de un pedido, incluida información sobre Parcels, permitiendo que tus clientes pregunten sobre sus paquetes cuando usan Clerk.io Chat.

A continuación, un ejemplo de un objeto Order:

{
    "id": 5434,
    "products": [123, 456],
    "time": 1622548800,
    "email": "luke@skywalker.com",
    "status": "DELIVERED"
}

Consulta la especificación completa de Orders aquí.

Paquetes #

Parcels representan el seguimiento de entregas para tus pedidos. Normalmente incluyen un tracking_code, un status de entrega, status_details opcionales y un tracking_link.

Puedes navegar Parcels en Data > Parcels y verlos en la página de detalles de cada pedido en el panel “Parcel Tracking Information”. Esto facilita la verificación de los mismos datos sobre los que tus clientes pueden preguntar vía Chat.

Aprende más sobre el uso de Parcels en la interfaz en la página de Parcels. Para el formato de los datos, consulta la API resource de Parcels.

Páginas #

Aunque estas son opcionales, se recomiendan altamente ya que permiten a Clerk.io trabajar con tus blogs, artículos y otras páginas de contenido.

Estas pueden mostrarse en los resultados de búsqueda, tener recomendaciones en sus propias páginas e incluirse como banners de contenido relevante cuando los clientes navegan productos o categorías.

Los atributos obligatorios son:

  • id
  • type
  • url
  • title
  • text

Aparte de estos, también recomendamos enviar un atributo image para que tus recomendaciones de Pages sean más atractivas visualmente, lo que a menudo lleva a más clics.

Puedes gestionar las páginas directamente en Data > Pages.

Las páginas pueden ser:

  • Páginas sincronizadas: páginas importadas a través de tu sincronización de datos.
  • Páginas subidas manualmente: páginas subidas directamente en my.clerk.io.

Si editas o eliminas una página sincronizada en my.clerk.io, esos cambios serán sobrescritos la próxima vez que corra la sincronización de datos para páginas.

Las páginas subidas manualmente se tratan como protegidas y no son sobrescritas (o eliminadas) por la sincronización de datos.

Formatos de archivo soportados para subir:

  • .docx
  • .pdf
  • .html
  • .htm
  • .md
  • .txt

A continuación, un ejemplo de un objeto Page:

{
    "id": 123,
    "type": "blog",
    "url": "https://galactic-empire-merch.com/blog/lightsaber-history",
    "title": "The History of Lightsabers",
    "text": "Lightsabers have been around for centuries, learn about their history here."
}

Consulta la especificación completa de Pages aquí.

Clientes #

Estos son opcionales, pero recomendados ya que te permite usar la herramienta Audience de Clerk.io como un CDP. El objeto Customer contiene un ID o una dirección de email, junto con cualquier cantidad de atributos que desees para segmentarlos.

El ID o email se utilizan para conectar los datos del Customer con cualquier dato de pedido existente que ya incluya su ID o email.

Al enviar los objetos, Audience obtendrá automáticamente una nueva opción llamada Customer Data en la que puedes segmentar según estos atributos.

El único atributo obligatorio para Customers es:

  • id o email

Aparte de esto, recomendamos enviar cualquier punto de datos relevante para tu marketing, como gender, age, interests y más.

A continuación, un ejemplo de un objeto Customer:

{
    "id": 255,
    "email": "leia@royalty.com",
    "name": "Leia Organa",
    "gender": "Female",
    "age": 28,
    "interests": ["Rebellion", "Politics", "Leadership"]
}

Consulta la especificación completa de Customers aquí.

Esta página ha sido traducida por una IA útil, por lo que puede contener errores de idioma. Muchas gracias por su comprensión.