Objects

Foundation #

La vera personalizzazione è possibile solo quando è coerente in 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—sia che i tuoi clienti stiano chattando, cercando, navigando o ricevendo email.

Privacy #

La fondazione dati di Clerk.io è costruita pensando alla privacy, permettendo una grande personalizzazione senza compromettere la sicurezza dei dati. Siamo senza cookie per impostazione predefinita e completamente conformi al GDPR.

Il nucleo dell’AI di Clerk.io lavora su dati di ordini e prodotti. Letteralmente ha bisogno solo di sapere cosa è stato acquistato, in quale momento, per mostrare la stragrande maggioranza dei risultati.

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

Layers #

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

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

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

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

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

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

Products #

Questi sono al centro dell’AI di Clerk.io. Sono utilizzati per comprendere la struttura del tuo catalogo e sono il principale motore dietro le conversioni extra che Clerk.io ti aiuta a ottenere.

I prodotti hanno una serie di attributi obbligatori necessari affinché Clerk.io funzioni correttamente, ma oltre a questo puoi aggiungere tutti gli attributi che hai disponibili nella tua piattaforma eCommerce. Gli attributi obbligatori sono:

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

Qui sotto trovi 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 fornire 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 #

Queste sono utilizzate per raggruppare i prodotti insieme. Sebbene siano opzionali, sono altamente raccomandate perché 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 legate alle Category le richiedono presenti.

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

Puoi inviare tutti gli attributi di category che desideri per motivi di stile (ad es. 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

Ecco 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 #

Questi sono fondamentali per ottenere le migliori prestazioni con Clerk.io poiché l’AI utilizza i dati degli ordini per capire come i clienti interagiscono con i tuoi prodotti.

Tutto, dai risultati di Search alle previsioni di Audience, utilizza i dati degli ordini per identificare i modelli di cosa probabilmente faranno i clienti in seguito.

Gli attributi obbligatori sono:

• id
• products
• time

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

È anche possibile inviare lo stato status di un ordine, incluse informazioni sui Parcels, consentendo ai clienti di chiedere informazioni sui loro pacchi quando utilizzano Clerk.io Chat.

Qui sotto trovi 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 tracciamento della consegna per i tuoi ordini. Tipicamente includono un tracking_code, uno stato della consegna status, eventuali status_details opzionali e un tracking_link.

Puoi consultare i Parcels in Data > Parcels e vederli nella pagina dei dettagli di ogni ordine nel pannello “Parcel Tracking Information”. Questo rende facile verificare gli stessi dati su cui i tuoi clienti possono chiedere tramite Chat.

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

Pages #

Pur essendo opzionali, sono fortemente raccomandate perché consentono a Clerk.io di lavorare con i tuoi blog, articoli e altre pagine di contenuto.

Queste possono essere mostrate nei risultati di search, avere recommendations sulle loro pagine, ed essere incluse come contenuto banner rilevante quando i clienti navigano prodotti o categorie.

Gli attributi obbligatori sono:

• id
• type
• url
• title
• text

Oltre a questi, consigliamo anche l’invio di un attributo image per rendere le raccomandazioni sulle Pages più accattivanti, il che spesso porta a più click.

Puoi gestire le pagine direttamente in Data > Pages.

Le Pages possono essere:

• Synced pages: Pagine importate tramite la tua sincronizzazione dati.
• Manually uploaded pages: Pagine caricate direttamente in my.clerk.io.

Se modifichi o cancelli una synced page in my.clerk.io, tali modifiche verranno sovrascritte al prossimo sync dati per le pagine.

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

Formati di file supportati per il caricamento:

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

Qui sotto trovi 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 #

Questi sono opzionali, ma raccomandati perché ti permettono di utilizzare lo strumento Audience di Clerk.io come un CDP. L’oggetto Customer contiene un ID o indirizzo email, insieme a tutti gli attributi che desideri per segmentarli.

L’ID o l’email vengono utilizzati per collegare i dati Customer ai dati di ordini esistenti che già includono il loro ID o email.

Inviando gli oggetti, Audience ottiene automaticamente una nuova opzione chiamata Customer Data dove puoi segmentare su questi attributi.

L’unico attributo obbligatorio per i Customers è:

• id o email

Oltre a questo, raccomandiamo di inviare tutti i punti dati rilevanti 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.