Gli eventi di prodotto ti permettono di tracciare il modo in cui i contatti interagiscono con i tuoi prodotti, ad esempio quando visualizzano un articolo, lo aggiungono al carrello o completano un acquisto. Puoi poi utilizzare questi dati nelle automazioni, nelle segmentazioni e nelle statistiche per comprendere meglio il comportamento dei clienti e personalizzare la comunicazione.
Questo articolo spiega come inviare gli eventi di prodotto e quali regole devi seguire per assicurarti che i dati vengano memorizzati correttamente.
Per saperne di più sugli eventi di prodotto, consulta l'articolo "Cos'è un evento di prodotto".
Ci sono 2 opzioni per inviare eventi di prodotto a User.com:
Javascript SDK
REST API
In generale, inviare eventi di prodotto è abbastanza simile a inviare eventi standard. Tuttavia, ci sono alcuni aspetti a cui devi prestare attenzione:
Utilizza la parola chiave product_event quando invii un evento di prodotto.
Includi i campi obbligatori: "product_id" e "event_type"
Passare il nome del prodotto è facoltativo. Se non lo includi e il prodotto non esiste ancora, il prodotto verrà creato senza nome.
L'elenco dei tipi di evento è chiuso. Non puoi aggiungerne di nuovi. Le opzioni disponibili sono:
click
promo click
view
detail
liking
add to observation
reservation
add
add to cart
remove
checkout
checkout option
order
purchase
return
refund
Puoi includere campi del prodotto, come "product name", "category" o qualsiasi altro campo personalizzato di cui hai bisogno.
Prima di inviare eventi di prodotto, assicurati che i campi del prodotto esistano già nel tuo workspace. È importante mantenere lo stesso tipo di campo.
User.com non memorizza i valori storici dei campi degli eventi di prodotto (ad eccezione di event_type). Ogni nuovo evento di prodotto aggiorna i valori correnti dei campi sul profilo del prodotto. Ciò significa che i valori precedenti vengono sovrascritti.
Poiché i campi del prodotto riflettono sempre l'ultimo valore, non potrai tracciare le differenze tra le varianti all'interno di un singolo prodotto. Se devi distinguere tra varianti (come le stesse scarpe in taglie diverse), crea un prodotto separato per ogni variante e assegna a ciascuno un product_id univoco.
Per mantenere i tuoi dati strutturati e facili da gestire, è consigliato creare i campi del prodotto prima di inviarli al sistema. In questo modo puoi assegnare in anticipo il tipo di dato corretto (come integer, boolean, date e altri).
Se un campo viene inviato senza essere predefinito, verrà creato automaticamente come stringa. Ciò può ridurre la precisione dei filtri e limitare in seguito le tue possibilità di segmentazione e reportistica.
Per visualizzare i tipi di campo disponibili e selezionare l'opzione più adatta alle tue esigenze, consulta il seguente articolo.
Endpoint REST API per inviare un evento di prodotto:
Di seguito un esempio di invio di un evento di prodotto utilizzando la REST API:
curl -X POST
"https://<your_app_subdomain>.user.com/api/public/products-by-id/"
-H 'authorization: Token <your_64_char_api_key>'
-H 'content-type: application/json'
-d '{
"name": "my product",
"custom_id": "my_product_id",
"product_url": "https://myshop.com/products/my_product/",
"image_url": "https://myshop.com/media/products/myproduct.jpg"
}'Se invii un evento di prodotto senza fornire un nome, il sistema controllerà innanzitutto se esiste già un prodotto con il "product_id" indicato.
Se non viene trovato alcun prodotto corrispondente, verrà creato un nuovo prodotto utilizzando quel "product_id", ma sarà salvato senza nome.
Puoi anche attivare un evento di prodotto direttamente da HTML, ad esempio quando un contatto clicca su un pulsante o un link.
<a href="#"
onclick="userengage('product_event', {
product_id: 'the_id',
event_type: 'add to cart',
name: 'product name',
my_attribute: 'value',
my_attribute_2: 'value_2'
})">
CLICK ME!
</a>Per una migliore organizzazione dei dati e una maggiore flessibilità a lungo termine, è fortemente consigliato creare i campi del prodotto prima di inviarli al sistema. Definire i campi in anticipo ti permette di impostare il tipo di dato corretto (come integer, boolean, date, ecc).
Se i campi non sono predefiniti, verranno creati automaticamente con il tipo di dato stringa . Ciò può rendere i filtri meno precisi e limitare in futuro le tue opzioni di segmentazione e reportistica.
Per rivedere i tipi di campo disponibili e scegliere quello giusto per il tuo caso d'uso, consulta il seguente articolo.
Per inviare eventi di prodotto utilizzando il metodo JavaScript, assicurati che la richiesta includa i parametri obbligatori.
Campi obbligatori:
product_id
event_type
Campi facoltativi:
name
description
Eventuali altri campi dell'evento di prodotto rilevanti per il tuo caso d'uso
Per "event_type", seleziona uno dei valori predefiniti elencati in precedenza in questo articolo.
Esempio:
userengage("product_event", {
product_id: "12345",
event_type: "add to cart",
name: "Product Name",
description: "Product description"
});Comprendere l'interesse e l'intento di acquisto dei clienti: traccia azioni chiave come visualizzazioni di prodotto, click, eventi di aggiunta al carrello e acquisti per capire meglio a cosa sono interessati i clienti e in quale punto abbandonano la customer journey d'acquisto.
Aumenta le conversioni con follow-up automatizzati in tempo reale: utilizza gli eventi di prodotto per attivare automazioni basate sul comportamento dei clienti. Ad esempio, inviare promemoria o offerte quando un contatto aggiunge un articolo al carrello ma non completa l'acquisto.
Crea segmentazioni più accurate per un marketing mirato: costruisci segmentazioni basate su interazioni reali con i prodotti per raggiungere il pubblico giusto con messaggi pertinenti, come i clienti che hanno visualizzato un prodotto specifico o mostrato interesse per una particolare categoria.
Misura l'engagement dei prodotti e ottimizza le prestazioni: analizza nel tempo i dati degli eventi di prodotto per valutare la popolarità dei prodotti, tracciare i trend di engagement e identificare i prodotti più performanti o meno performanti, per prendere decisioni migliori a livello di marketing e Sale.
Aumenta i ricavi con suggerimenti di prodotto personalizzati: utilizza gli eventi di acquisto per consigliare prodotti pertinenti in base a ciò che i clienti hanno già acquistato. Questo ti permette di realizzare campagne dedicate che promuovono articoli complementari o simili, incoraggiando gli acquisti ripetuti e aumentando il valore medio dell'ordine.
Utilizza tipi di dato appropriati per i campi, in modo da mantenere accuratezza e coerenza. Ad esempio, imposta "Price" come "float" per evitare errori.
Personalizza i dati dei tuoi prodotti aggiungendo campi in linea con le esigenze del tuo business, per un tracciamento e un'analisi più precisi.
Gestendo i tuoi prodotti in modo strategico, puoi ottenere insight preziosi e migliorare l'efficacia delle tue strategie di marketing e di engagement.