Objects

Fondazione #

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 fluida e personalizzata, che i tuoi clienti stiano chattando, cercando, navigando o ricevendo email.

Privacy #

La base dati di Clerk.io è costruita con la privacy come priorità, consentendo una grande personalizzazione senza compromettere la sicurezza dei dati. Siamo per impostazione predefinita senza cookie e completamente conformi al GDPR.

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

Inviando anche l’indirizzo email dei clienti, permetti una vera personalizzazione basata sulla cronologia di acquisto individuale. Questo è consigliato ma non richiesto.

Livelli #

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

1. Livello dati, che contiene i dati grezzi come attributi di prodotti e ordini.

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

3. Livello Merchandising, dove le Campagne possono influenzare i risultati.

4. Livello prodotto, 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.

Prodotti #

Questi sono al centro dell’AI di Clerk.io. Sono utilizzati per comprendere la struttura del tuo catalogo e sono la forza trainante principale 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 questi puoi aggiungere tutti gli attributi disponibili nella tua piattaforma eCommerce. Gli attributi obbligatori sono:

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

Di seguito un esempio di oggetto Prodotto:

 {
    "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 specifica completa dei Prodotti qui.

Categorie #

Queste vengono usate per raggruppare i prodotti. Anche se sono opzionali, sono altamente consigliate poiché aiutano l’AI di Clerk.io a comprendere come i tuoi prodotti sono collegati all’interno del catalogo.

Ad esempio, la nostra logica degli Alternativi si basa fortemente sulle categorie per capire quali siano gli articoli più simili e tutte le logiche relative alle Categorie richiedono che siano presenti.

Le categorie vengono inviate a Clerk.io come i prodotti, ma hanno un insieme diverso di attributi.

Puoi inviare quanti attributi di categoria vuoi per scopi di stile (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

Di seguito un esempio di oggetto Categoria:

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

Consulta la specifica completa delle Categorie qui.

Ordini #

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

Tutto, dai risultati di ricerca alle previsioni di Audience, utilizza i dati degli ordini per identificare i modelli di comportamento più probabili dei clienti.

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 di Audience.

È anche possibile inviare lo status di un ordine, inclusi i dettagli sui Parcels, permettendo ai tuoi clienti di chiedere informazioni sui loro pacchi usando Chat di Clerk.io.

Di seguito un esempio di oggetto Ordine:

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

Consulta la specifica completa degli Ordini qui.

Parcels #

I Parcels rappresentano il tracciamento della consegna per i tuoi ordini. Di solito includono un tracking_code, uno status della consegna, eventuali status_details opzionali e un tracking_link.

Puoi visualizzare 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 che i tuoi clienti possono richiedere tramite Chat.

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

Pagine #

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

Queste possono essere mostrate nei risultati di ricerca, con raccomandazioni visualizzate sulle loro pagine, e potrebbero essere incluse come banner di contenuti rilevanti quando i clienti navigano tra prodotti o categorie.

Gli attributi obbligatori sono:

• id
• type
• url
• title
• text

Oltre a questi, raccomandiamo anche di inviare un attributo image per rendere le raccomandazioni sulle pagine più attraenti visivamente, il che spesso porta a più clic.

Puoi gestire le pagine direttamente in Data > Pages.

Le pagine possono essere:

• Pagine sincronizzate: pagine importate tramite la sincronizzazione dati.
• Pagine caricate manualmente: pagine caricate direttamente su my.clerk.io.

Se modifichi o elimini una pagina sincronizzata su my.clerk.io, tali modifiche saranno sovrascritte la volta successiva che viene eseguita una sincronizzazione dati per le pagine.

Le pagine caricate manualmente vengono trattate come protette e non vengono sovrascritte (o eliminate) dalla sincronizzazione dati.

Formati di file supportati per il caricamento:

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

Di seguito un esempio di oggetto Pagina:

{
    "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 Pagine qui.

Clienti #

Questi sono opzionali, ma raccomandati perché ti permettono di usare lo strumento Audience di Clerk.io come un CDP. L’oggetto Cliente contiene un ID o indirizzo email, oltre a qualsiasi numero di attributi su cui desideri segmentare.

L’ID o l’email vengono utilizzati per collegare i dati Cliente a qualsiasi ordine esistente che già includa il loro ID o email.

Inviando gli oggetti, Audience otterrà automaticamente una nuova opzione chiamata Customer Data dove puoi fare segmentazione su questi attributi.

L’unico attributo obbligatorio per i Clienti è:

• id o email

Oltre a questo, raccomandiamo di inviare qualsiasi dato rilevante per il tuo marketing, come gender, age, interests e altro.

Di seguito un esempio di oggetto Cliente:

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

Consulta la specifica completa dei Clienti qui.