Data

Objects

I dati utilizzati dall'IA di Clerk.io per mostrare i risultati.
Data Foundation

Foundation #

La vera personalizzazione è possibile solo quando è coerente su ogni punto di contatto.

La piattaforma dati unificata di Clerk.io garantisce che tutti gli strumenti condividano gli stessi dati, offrendo un’esperienza senza soluzione di continuità e personalizzata, che i tuoi clienti siano in chat, alla ricerca, durante la navigazione o ricevendo email.

Privacy #

La data foundation di Clerk.io è costruita tenendo conto della privacy, permettendo una grande personalizzazione senza compromettere la sicurezza dei dati. Siamo cookieless di default e completamente GDPR compliant.

Il cuore dell’AI di Clerk.io lavora su dati relativi a ordini e prodotti. Serve letteralmente sapere solo cosa è stato acquistato, in quale momento, per mostrare la gran parte dei risultati.

Inviando anche l’indirizzo email dei clienti, consenti una vera personalizzazione basata sulla cronologia degli acquisti individuali. Questo è raccomandato, ma non obbligatorio.

Layers #

Quando l’AI mostra i risultati, ciò avviene attraverso 4 layer:

  1. Data layer, contenente i dati grezzi come attributi per prodotti e ordini.

  2. AI layer, dove l’AI di Clerk.io utilizza le connessioni tra tutti i dati per prevedere i risultati, in base a quale endpoint è utilizzato.

  3. Merchandising layer, dove Campaigns possono influenzare i risultati.

  4. Product layer, dove l’API di Clerk restituisce i risultati finali.

Di seguito puoi leggere i vari punti dati che Clerk.io utilizza per alimentare la sua AI.

Attributes #

Ogni oggetto deve includere gli attributi obbligatori elencati per il suo tipo qui sotto. Puoi anche inviare qualsiasi attributo personalizzato di cui hai bisogno. Gli altri attributi mostrati in questo articolo sono esempi raccomandati, non un elenco completo di ciò che puoi inviare.

Clerk.io supporta interi, float, stringhe, booleani, liste (array JSON) e dizionari (oggetti JSON) come valori di attributo.

Le liste e i dizionari di attributi personalizzati devono essere piatti: non possono contenere altre liste o dizionari. Ad esempio, {"material": "cotton", "weight": 0.5} è supportato, ma {"details": {"material": "cotton"}} non lo è.

Products #

Questi stanno al centro dell’AI di Clerk.io. Vengono utilizzati per comprendere la struttura del tuo catalogo e rappresentano la principale forza trainante dietro le conversioni extra che Clerk.io ti aiuta a ottenere.

I prodotti hanno alcuni attributi obbligatori richiesti per far funzionare correttamente Clerk.io:

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

Qui sotto un esempio di oggetto 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 specifica completa dei Products qui.

Puoi anche prevedere un attributo numerico opzionale profit per prodotto nel tuo feed, o crearlo con AI Modifiers utilizzando un margine stimato. Il valore è un importo monetario per unità. Vedi Profit per il calcolo e il comportamento storico.

Categories #

Servono a raggruppare i prodotti. Sebbene siano opzionali, sono fortemente raccomandati poiché aiutano l’AI di Clerk.io a comprendere come i tuoi prodotti sono collegati all’interno del tuo catalogo.

Ad esempio, la nostra logica Alternatives si basa molto sulle categorie per capire quali sono gli articoli più simili e tutte le logiche relative alle Category richiedono la loro presenza.

Le Categories vengono inviate a Clerk.io allo stesso modo dei prodotti, ma hanno un insieme diverso di attributi.

Puoi inviare quanti attributi di categoria vuoi per motivi di stile (ad esempio un’immagine, una descrizione, ecc.), ma solo gli attributi obbligatori vengono utilizzati da Clerk.io per mostrare i risultati.

Gli attributi obbligatori sono:

  • id
  • name
  • subcategories
  • url

Qui sotto un esempio di oggetto Category:

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

Consulta la specifica completa delle Categories qui.

Orders #

Sono fondamentali per ottenere le migliori performance con Clerk.io poiché l’AI utilizza i dati degli ordini per comprendere come i clienti interagiscono con i tuoi prodotti.

Tutto, dai risultati di Search alle previsioni di Audience, usa i dati degli ordini per identificare i pattern di ciò che i clienti faranno probabilmente dopo.

Gli attributi obbligatori sono:

  • id
  • products
  • time

Inoltre, consigliamo vivamente di inviare l’attributo email, che contiene l’indirizzo Email del cliente, permettendo la personalizzazione e la segmentazione Audience.

È anche possibile inviare lo status di un ordine, inclusa l’informazione sui Parcels, così i tuoi clienti possono chiedere dei loro pacchi tramite Clerk.io Chat.

Qui sotto un esempio di oggetto Order:

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

Consulta la specifica completa degli Orders qui.

Parcels #

I Parcels rappresentano il tracking delle consegne dei tuoi ordini. Tipicamente includono un tracking_code, lo stato di consegna status, opzionalmente status_details e un tracking_link.

Puoi visualizzare i Parcels in Data > Parcels e vederli nella pagina dei dettagli di ciascun ordine nel pannello “Parcel Tracking Information”. Questo rende semplice verificare gli stessi dati sui quali i tuoi clienti possono chiedere informazioni via Chat.

Scopri di più sull’uso dei Parcels nell’interfaccia alla pagina Parcels. Per il formato dati, vedi la risorsa API dei Parcels.

Pages #

Anche se sono opzionali, sono fortemente consigliate perché permettono a Clerk.io di lavorare con i tuoi blog, articoli e altre pagine di contenuto.

Possono essere mostrate nei risultati di Search, avere Recommendations sulle loro pagine, ed essere incluse come banner di contenuto rilevante quando i clienti navigano tra prodotti o categorie.

Gli attributi obbligatori sono:

  • id
  • type
  • url
  • title
  • text

Oltre a questi, consigliamo anche di inviare un attributo image per rendere le raccomandazioni sulle Pages più accattivanti visivamente, cosa che spesso porta a più clic.

Puoi gestire le pagine direttamente in Data > Pages.

Le Pages possono essere:

  • Synced pages: pagine importate tramite la sincronizzazione dei dati.
  • Manually uploaded pages: pagine caricate manualmente in my.clerk.io.

Se modifichi o elimini una synced page in my.clerk.io, tali modifiche verranno sovrascritte alla prossima sincronizzazione dei dati per le pagine.

Le pagine caricate manualmente sono considerate protette e non vengono sovrascritte (o eliminate) dalla sincronizzazione dei dati.

Formati di file supportati per il caricamento:

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

Qui sotto un esempio di oggetto 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 specifica completa delle Pages qui.

Customers #

Sono opzionali, ma consigliati perché ti permettono di utilizzare lo strumento Audience di Clerk.io come CDP. L’oggetto Customer contiene un ID o un indirizzo Email, insieme a qualsiasi numero di attributi su cui si voglia segmentare.

L’ID o l’indirizzo Email sono utilizzati per collegare i dati Customer a qualsiasi ordine esistente che già includa il loro ID o email.

Quando invii gli oggetti, Audience riceverà automaticamente una nuova opzione chiamata Customer Data su cui puoi segmentare tramite questi attributi.

L’unico attributo obbligatorio per i Customers è:

  • id oppure email

Oltre a questo, consigliamo di inviare qualsiasi punto dati rilevante per il tuo marketing, come gender, age, interests e altro.

Qui sotto un esempio di oggetto Customer:

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

Consulta la specifica completa dei Customers qui.

Questa pagina è stata tradotta da un'utile intelligenza artificiale, quindi potrebbero esserci errori linguistici. Grazie per la comprensione.