Metodi avanzati per gli Aggiornamenti del carrello

Se si utilizza questo metodo di sincronizzazione dei carrelli con il nostro script di tracciamento, non è possibile aggiornare i carrelli con il "metodo paq.push" spiegato in questo articolo.

Il vantaggio di utilizzare questo metodo di aggiornamento dei carrelli è che si ha il controllo completo sull'aggiunta o la rimozione di articoli dal carrello e sulla sovrascrittura o lo svuotamento dello stesso. Il metodo "paq.push" consente solo di sovrascrivere il carrello a ogni aggiornamento.

Supponiamo che si utilizzi Google Tag Manager e si condividano gli eventi e-commerce con il dataLayer. In questo caso, vi consigliamo di utilizzare questo metodo di condivisione degli aggiornamenti del carrello con Datatrics, poiché Google consente anche di aggiungere e rimuovere singoli articoli dal carrello sia in Universal Analytics (Enhanced Ecommerce) che in GA4 GTM Ecommerce.

È necessario assicurarsi che la variabile item sia del tipo di dati corretto per gli articoli aggiunti/rimossi dal carrello. Di seguito è riportata una spiegazione di ciascuna variabile item e del tipo di dati da utilizzare:

Variabile	Tipo	Descrizione
{{item_id}}	String	ID dell'articolo
{{item_name}}	String	Nome dell'articolo
{{item_category}}	String or Array	Categoria dell'articolo. Si può anche specificare un array di un massimo di 5 categorie, ad esempio ["{{categoryname1}}", "{{categoryname2}}", "{{categoryname 3}}"].
{{item_price}}	Decimal	Prezzo per articolo
{{item_quantity}}	Number	Item quantity (amount added/removed from cart)

Di seguito sono riportati tutti i modi possibili per sincronizzare il carrello di un visitatore con il nostro script di tracciamento. Ogni funzione è corredata da un evento di esempio.

Aggiungere gli articoli al carrello

È necessario eseguire il codice sottostante per ogni articolo aggiunto al carrello. Se lo stesso articolo viene aggiunto più volte, è possibile eseguirlo più volte o aggiornare immediatamente la quantità all'importo aggiunto.

datatricsAddCartItem(
    "{{item_id}}",
    "{{item_name}}",
    "{{item_category}}",
    {{item_price}},
    {{item_quantity}}
);

//Example with actual data

datatricsAddCartItem(
    "325791-564a",
    "The best book",
    "Best sellers",
    50.5,
    1
);

Rimuovere gli articoli dal carrello

Solo item_id e l'importo rimosso sono necessari quando si rimuovono gli articoli dal carrello.

datatricsRemoveCartItem(
    "{{item_id}}",
    {{quantity}}
);

//Example with actual data

datatricsRemoveCartItem(
    "325791-564a",
    1
);

Sovrascrivere il carrello

Se si desidera sovrascrivere l'intero carrello (ad esempio, quando un visitatore sta visitando il suo carrello o sta effettuando il checkout), è necessario implementarlo usando il seguente metodo.

datatricsSetCart([{
    id: "{{item_id}}",
    name: "{{item_name}}",
    category: "{{item_category}}",
    price: {{item_price}},
    quantity: {{item_quantity}}
},{
    id: "{{item_id}}",
    name: "{{item_name}}",
    category: "{{item_category}}",
    price: {{item_price}},
    quantity: {{item_quantity}}
},{
    id: "{{item_id}}",
    name: "{{item_name}}",
    category: "{{item_category}}",
    price: {{item_price}},
    quantity: {{item_quantity}}
}]);

//Example with actual data

datatricsSetCart([{
    id: "325791-564a",
    name: "The best book",
    category: "Best sellers",
    price: 50.5,
    quantity: 1
},{
    id: "518168",
    name: "Another book",
    category: "Thriller",
    price: 25,
    quantity: 2
},{
    id: "8771649",
    name: "Adventure Book 2",
    category: ["Adventure Books", "Best sellers"],
    price: 15,
    quantity: 1
}]);

Svuotare il carrello

Quando il carrello viene completamente svuotato, è possibile utilizzare questa funzione per condividere questo evento con il nostro script di tracciamento.

datatricsEmptyCart();