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.

Privacy #

La base de datos de Clerk.io está construida pensando en la privacidad, permitiendo una excelente personalización sin comprometer la seguridad de los datos. Somos cookieless por defecto y totalmente compatibles 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 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, lo hace a través de 4 capas:

1. Capa de datos, que contiene los datos sin procesar 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, según el endpoint que se utilice.

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

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

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

Products #

Estos están en 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 extra que Clerk.io te ayuda a lograr.

Los productos tienen varios atributos obligatorios requeridos para que Clerk.io funcione correctamente, pero además puedes enviar cualquier atributo que esté 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 un objeto Product:

 {
    "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 Products aquí.

Categories #

Estos 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 mucho 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 estén presentes.

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

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

Orders #

Estos son cruciales para obtener el mejor rendimiento 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 búsqueda hasta las predicciones de Audience, utiliza los datos de pedidos para identificar patrones sobre lo que los clientes podrían hacer a continuación.

Los atributos obligatorios son:

• id
• products
• time

Además, recomendamos encarecidamente enviar el atributo email, que contiene la dirección email del cliente y permite la personalización y 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 cuando utilicen 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 entregas para tus pedidos. Normalmente incluyen un tracking_code, un status de entrega, un status_details opcional y un tracking_link.

Puedes navegar por 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 a través de Chat.

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

Pages #

Aunque son opcionales, son altamente recomendadas, ya que permiten que Clerk.io funcione con tus blogs, artículos u otras páginas de contenido.

Estas pueden mostrarse en los resultados de búsqueda, tener recomendaciones en sus páginas y ser incluidas como banners de contenido relevante cuando los clientes naveguen 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 generar más clics.

Puedes gestionar páginas directamente en Data > Pages.

Las páginas pueden ser:

• Páginas sincronizadas: Páginas importadas mediante la 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 tratan como protegidas y no se sobrescriben (ni eliminan) con la sincronización de datos.

Formatos de archivo soportados para la subida:

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

Son opcionales, pero recomendados ya que permiten el uso de la herramienta Audience de Clerk.io como un CDP. El objeto Customer contiene un ID o dirección email, junto con cualquier cantidad de atributos por los que desees segmentar.

El ID o dirección email se usa para conectar los datos de Customer con los datos de pedidos existentes que ya incluyen su ID o email.

Al enviar los objetos, Audience obtendrá automáticamente una nueva opción llamada Customer Data donde puedes segmentar por estos atributos.

El único atributo obligatorio para Customers es:

• id o email

Además, 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í.