I Suggerimenti di prodotto aiutano il tuo team a presentare consigli personalizzati che aumentano il coinvolgimento dei contatti e stimolano le vendite online. Combinando i dati storici di acquisto con le interazioni in tempo reale dei contatti, Positive User prevede quali articoli i tuoi contatti vorranno vedere successivamente.
Scopri come funzionano i modelli di Suggerimento di prodotto per iniziare da "Introduction to Product Recommendations".
Per garantire che il motore di raccomandazione generi suggerimenti pertinenti ed efficaci, sono fondamentali alcune basi di dati.
Un tracciamento coerente e accurato degli eventi di prodotto è fondamentale. Traccia gli eventi di acquisto storici e le interazioni dei contatti in tempo reale, in modo che il motore di raccomandazione abbia dati sufficienti per apprendere le abitudini di acquisto e gli interessi immediati.
Evento di prodotto "Purchase": traccia almeno sei mesi di dati storici sugli eventi di acquisto per stabilire solide relazioni tra i prodotti. Ogni evento inviato a Positive User deve includere il tipo di evento (purchase), l'ID prodotto (custom_id) e un timestamp preciso.
Altri eventi di prodotto: traccia gli eventi di interazione in tempo reale come view, add to cart e checkout con l'ID prodotto e il timestamp. Queste azioni alimentano i suggerimenti dinamici sull'endpoint /predictions/predict-for-user/.
Consulta l'elenco degli eventi di prodotto disponibili qui.
Assicurati che gli articoli del tuo catalogo abbiano i campi standard compilati, in modo che i suggerimenti mostrino i dettagli completi dell'articolo.
Assicurati che ogni articolo includa questi campi standard:
Name: nome visualizzato del prodotto.
Custom_id: identificativo univoco del prodotto, corrispondente all'ID utilizzato negli eventi di prodotto.
Image_url: link diretto e accessibile pubblicamente all'immagine del prodotto.
Url: link diretto alla pagina del prodotto sul tuo sito web.
Price: prezzo attuale del prodotto.
Puoi collegare il tuo data feed del prodotto al workspace di Positive User per avere dettagli aggiornati sui prodotti. Maggiori informazioni in "Introduction to Product Feeds".
Altre opzioni di sincronizzazione dei prodotti sono descritte qui.
Seleziona l'endpoint API in base al fatto che tu voglia indirizzare contatti specifici o mostrare prodotti correlati. URL di base: https://<your_workspace_subdomain>.user.com/ (sostituisci <your_workspace_subdomain> con il sottodominio effettivo del tuo workspace).
Questa API di raccomandazione è separata dall'API REST standard di Positive User e non richiede una chiave di autorizzazione API, consentendo l'interrogazione diretta dagli script lato client del sito web.
/predictions/predict-for-user/: fornisce suggerimenti personalizzati su misura per un contatto specifico utilizzando user_id o userKey. Link alla documentazione API.
/predictions/predict/: fornisce suggerimenti basati su ID prodotto "seed" (come gli articoli attualmente nel carrello). Usa questo endpoint come fallback quando non è possibile identificare un contatto. Link alla documentazione API.
Invia un payload JSON con i parametri della richiesta per personalizzare quali prodotti vengono restituiti:
limit: (number) numero massimo di prodotti da restituire (massimo 25).
user_id: (string) identificativo univoco del cliente per i contatti loggati dal sistema del tuo sito web, corrispondente a "custom_id" in Positive User. Utilizzato con /predictions/predict-for-user/.
userKey: (string) identificativo di sistema di Positive User per i contatti conosciuti e anonimi. Creato nel cookie "__ca__chat" quando viene concesso il consenso ai cookie e il tracciamento è attivo. Utilizzato con /predictions/predict-for-user/.
segment_id: (number) ID numerico di una segmentazione di prodotto in Positive User (ad esempio, "All Available Products"). Consigliato per mantenere i suggerimenti limitati agli articoli attivi.
categories: (array of strings) filtra gli articoli per nome di categoria (ad es. ['Electronics', 'Laptops']).
tags: (array of strings) filtra gli articoli per nome di tag (ad es. ['B2B products', 'Professional products']).
product_ids o custom_ids: (array of numbers or strings) array di ID prodotto "seed" per l'endpoint /predict/ (massimo 15 ID per richiesta).
extra_data: (number: 0 o 1) controlla il comportamento di fallback quando i filtri restituiscono meno prodotti rispetto al limite. Imposta su 0 (Strict Mode) per restituire solo gli articoli che corrispondono a tutti i filtri, oppure su 1 (Default) per riempire gli slot rimanenti con i migliori suggerimenti generali.
Una richiesta API riuscita restituisce una risposta JSON. Il nucleo di questa risposta è un oggetto contenente una chiave recommended_products, che contiene un array di oggetti prodotto.
Ogni oggetto prodotto include campi standard come:
id: ID prodotto generato dal sistema di Positive User.
name: nome del prodotto.
custom_id: il tuo ID prodotto.
description: descrizione del prodotto.
product_url: URL della pagina del prodotto.
image_url: URL dell'immagine del prodotto.
created_at, updated_at: timestamp.
Inoltre, ogni oggetto prodotto contiene:
attributes array: elenca tutti i campi del prodotto (standard e personalizzati) definiti nel workspace di Positive User per quel prodotto (ad esempio, "Price", "Sale_price", "Brand", "Color", ecc.). Ogni campo ha il suo "Name", "Value" e "Value_type".
categories array: elenca le categorie a cui appartiene il prodotto all'interno di Positive User.
Esempio:
{
"recommended_products": [
{
"id": 77,
"name": "Ripped Denim Jacket",
"custom_id": "1811",
"description": "This ripped denim jacket...",
"product_url": "https://ecommerce.demouser.eu/product/ripped-denim-jacket",
"image_url": "https://ecommerce.demouser.eu/wp-content/uploads/2018/02/6290019144_1_1_1.jpg",
// ... other standard fields ...
"attributes": [
{
"name": "price",
"name_std": "price",
"value": 79.0,
"value_type": 7
},
// ... other attributes
],
"categories": [
{
"id": 66,
"name": "Women, Jackets & Coats"
}
]
}
// ... more products
]
}Ottenere suggerimenti personalizzati per un contatto specifico: usa l'endpoint /predictions/predict-for-user/ con "userKey" o "user_id" per visualizzare suggerimenti su misura basati sulle abitudini di navigazione individuali.
Esempio di payload:
{
"userKey": "user_key_value_from_ca_chat_cookie",
"limit": 5,
"segment_id": 101 // e.g., "Available Products"
"extra_data": 0 // Strict: only show items within the segment
}Ottenere suggerimenti correlati a prodotti specifici: usa l'endpoint /predictions/predict/ con "custom_ids" per mostrare articoli correlati ai prodotti attualmente nel carrello di un contatto.
Esempio di payload:
{
"custom_ids": ["SKU123", "SKU456"], // IDs of products in cart
"limit": 3,
"segment_id": 101, // e.g., "Available Products"
"extra_data": 0 // Strict: only show items within the segment
}