Objects

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

Privacidad #

La base de datos de Clerk.io está diseñada con la privacidad en mente, permitiendo una gran personalización sin comprometer la seguridad de los datos. Somos cookieless por defecto y totalmente cumplimos con el RGPD.

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.

Capas #

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

1. Capa de datos, que contiene los datos en bruto como 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 el endpoint utilizado.

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 usa Clerk.io para potenciar su IA.

Productos #

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

Los productos tienen varios atributos obligatorios necesarios para que Clerk.io funcione correctamente, pero aparte de eso, puedes enviar cualquier atributo disponible en tu plataforma de eCommerce. Los atributos obligatorios son:

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

A continuación un ejemplo de objeto Producto:

 {
    "id": 135,
    "name": "Lightsaber",
    "description": "Antique Rebel Lightsaber",
    "price": 99995.95,
    "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 Productos aquí.

Categorías #

Estas se utilizan para agrupar productos. Aunque son opcionales, se recomiendan mucho porque ayudan a la IA de Clerk.io a entender cómo se conectan tus productos dentro de tu catálogo.

Por ejemplo, nuestra lógica de Alternativas depende mucho 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 diseño (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 objeto Categoría:

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

Consulta la especificación completa de Categorías aquí.

Pedidos #

Estos son fundamentales para obtener el mejor desempeño con Clerk.io, ya que la IA utiliza los datos de pedidos para entender cómo los clientes interactúan con tus productos.

Todo, desde los resultados de Search hasta las predicciones de Audience, utiliza los datos de pedidos para identificar patrones sobre lo que probablemente hagan los clientes a continuación.

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 la segmentación de Audience.

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

A continuación un ejemplo de objeto Pedido:

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

Consulta la especificación completa de Pedidos aquí.

Paquetes #

Los Paquetes representan el seguimiento de entrega de tus pedidos. Normalmente incluyen un tracking_code, un status de entrega, status_details opcionales y un tracking_link.

Puedes ver los Paquetes 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 Paquetes en la interfaz en la página de Parcels. Para el formato de datos, consulta el recurso API de Parcels.

Páginas #

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

Estas pueden mostrarse en los resultados de Search, tener recomendaciones en sus páginas, y ser incluidas como banner de contenido relevante cuando los clientes navegan por productos o categorías.

Los atributos obligatorios son:

• id
• type
• url
• title
• text

Además de estos, también recomendamos enviar el atributo image para que tus recomendaciones de Páginas sean más atractivas visualmente, lo que a menudo genera más clics.

A continuación un ejemplo de objeto Página:

{
    "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 Páginas aquí.

Clientes #

Estas son opcionales, pero recomendadas ya que te permite usar la herramienta Audience de Clerk.io como un CDP. El objeto Cliente contiene un ID o dirección de email, junto con cualquier cantidad de atributos en los que quieras segmentarlos.

El ID o dirección de email se utiliza para conectar los datos de Cliente 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 estos atributos.

El único atributo obligatorio para Clientes es:

• id o email

Además 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 objeto Cliente:

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

Consulta la especificación completa de Clientes aquí.