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 personalizada y sin fisuras, ya sea que tus clientes estén chateando, buscando, navegando o recibiendo emails.

Privacy #

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

El núcleo de la IA de Clerk.io funciona con datos de pedidos y productos. Literalmente solo necesita saber qué se compró, 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.

Layers #

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 utiliza las conexiones en todos los datos para predecir resultados, según se use el endpoint.

  3. Capa de Merchandising, donde las Campaigns pueden influir en los resultados.

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

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

Attributes #

Cada objeto debe incluir los atributos obligatorios que se enumeran para su tipo a continuación. También puedes enviar cualquier atributo personalizado que necesites. Los otros atributos que se muestran en este artículo son ejemplos recomendados, no una lista completa de lo que se puede enviar.

Clerk.io admite enteros, flotantes, cadenas, booleanos, listas (arreglos JSON) y diccionarios (objetos JSON) como valores de atributo.

Las listas y diccionarios personalizados deben ser planos: no pueden contener otras listas o diccionarios. Por ejemplo, {"material": "cotton", "weight": 0.5} es compatible, pero {"details": {"material": "cotton"}} no lo es.

Products #

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

Los productos tienen una serie de atributos obligatorios que se requieren para que Clerk.io funcione correctamente:

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

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

 {
    "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 una cantidad monetaria por unidad. Consulta Profit para el cálculo y comportamiento histórico.

Categories #

Estas se utilizan para agrupar productos. Aunque son opcionales, se recomiendan mucho ya que ayuda a la IA de Clerk.io a entender cómo están conectados tus productos dentro del catálogo.

Por ejemplo, nuestra lógica de Alternatives 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ías requieren que estas 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 quieras con fines de estilización (por ejemplo, una imagen, una descripción, etc.), pero solo los atributos obligatorios son utilizados 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í.

Orders #

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

Todo, desde los resultados de búsqueda hasta las predicciones de Audience, utiliza los datos de pedidos para identificar patrones en lo que es probable que hagan los clientes a continuación.

Los atributos obligatorios son:

  • id
  • products
  • time

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

También es posible enviar el status de un pedido, incluyendo información sobre Parcels, lo que permite a tus clientes preguntar sobre sus paquetes al usar 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í.

Parcels #

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

Puedes ver los Parcels en Data > Parcels y verlos en la página de detalles de cada pedido en el panel “Parcel Tracking Information”. Esto facilita verificar los mismos datos que tus clientes pueden consultar a través de Chat.

Aprende más sobre cómo utilizar Parcels en la interfaz en la página de Parcels. Para el formato de datos, consulta el recurso API de Parcels.

Pages #

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

Estos pueden mostrarse en los resultados de búsqueda, tener recomendaciones mostradas en sus páginas y ser incluidos como banners de contenido relevante cuando los clientes navegan productos o categorías.

Los atributos obligatorios son:

  • id
  • type
  • url
  • title
  • text

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

Puedes gestionar páginas directamente en Data > Pages.

Las páginas pueden ser:

  • Páginas sincronizadas: Páginas importadas mediante 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 se sobrescribirán la próxima vez que se ejecute una sincronización de datos para páginas.

Las páginas subidas manualmente se consideran protegidas y no se sobrescriben (ni eliminan) por la sincronización de datos.

Formatos de archivo soportados para la carga:

  • .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í.

Customers #

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 dirección de email, junto con cualquier número de atributos sobre los que quieras segmentarlos.

El ID o la dirección de 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 donde puedes segmentar en base a estos atributos.

El único atributo obligatorio para Customers es:

  • id o email

Aparte de esto, recomendamos enviar cualquier dato 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.