Cos'è il codice _bundlex sui miei ordini?

Se hai aperto un ordine nel pannello di controllo Shopify e hai notato una riga simile a _bundlex: {"o":0,"d":"da2a9114-..."}, Bundlex è in funzione. Si tratta di un tag di tracciamento interno e questo articolo spiega esattamente a cosa serve e perché è presente.

In breve

La proprietà della riga dell'ordine _bundlex è un codice di tracciamento interno che Bundlex aggiunge alle righe dell'ordine. Svolge due funzioni:

• Applica lo sconto corretto al checkout, registrando quale offerta bundle ha selezionato il cliente.
• Attribuisce i ricavi nelle analisi di Bundlex, registrando a quale sconto appartiene la riga.

Non è un codice sconto, un codice promozionale o qualcosa che il cliente ha inserito. Sono metadati che Bundlex utilizza in background.

Dove è visibile la proprietà

Shopify nasconde al checkout le proprietà delle righe dell'ordine precedute da un carattere di sottolineatura, ma le mantiene visibili nei dettagli dell'ordine nel pannello di controllo. La proprietà rimane inoltre disponibile nel codice del tema e nelle API del carrello.

Per nasconderla nel negozio online, il tema deve filtrare le proprietà private. Anche i template email personalizzati, i documenti di imballaggio e altre integrazioni dovrebbero evitare di stampare le proprietà interne. Non presumere che un carattere di sottolineatura nasconda il valore in ogni contesto. Consulta la documentazione di Shopify sulle proprietà private.

Bundlex non dispone di un'impostazione per nascondere questa proprietà dalla visualizzazione degli ordini nel pannello di controllo Shopify. Se i clienti possono vederla nel tuo negozio online o in un template personalizzato, contatta l'assistenza indicando la pagina o il template interessato.

Perché Bundlex la utilizza

La proprietà collega la riga del carrello alla relativa offerta e al relativo ruolo. Bundlex utilizza queste informazioni per determinare l'idoneità allo sconto e per la reportistica. Non rimuoverla dalle richieste del carrello per nasconderla visivamente; filtrala invece dall'output visualizzato.

Come appare il codice

In genere vedrai un tag per ogni riga dell'ordine. La riga del prodotto principale contiene spesso un riferimento all'offerta, mentre ogni riga aggiuntiva gratuita o a pagamento contiene un indicatore aggiuntivo:

_bundlex: {"o":0,"d":"da2a9114-8063-..."}        Main item
_bundlex: {"o":0,"e":0,"d":"da2a9114-8063-..."}  Gift or extra item

I valori sono identificatori interni: o indica la posizione dell'offerta, d è l'ID dello sconto utilizzato per l'attribuzione dei ricavi e e indica un omaggio o un extra a pagamento. Non devi intervenire su questi valori né interpretarli.

Vedo il tag, ma non è stato applicato alcuno sconto

È normale e generalmente previsto. Se un ordine contiene un solo articolo con il tag _bundlex ma senza sconto, quasi sempre l'acquisto corrispondeva a un livello impostato su None o 0%, ad esempio il livello "Acquista 1" o quello per una singola unità di un'offerta basata sulla quantità.

Supponiamo che tu gestisca un'offerta sul vino con un livello "Acquista 1" con sconto dello 0% e livelli superiori con uno sconto effettivo. Un ordine di una sola bottiglia avrà comunque il tag. Il cliente ha acquistato 1 unità, corrispondente al primo livello, quindi non viene applicato alcuno sconto ed è presente solo il tag di tracciamento. L'app funziona correttamente.

Suggerimento: se preferisci che il primo livello non abbia alcuno sconto invece di uno 0% esplicito, imposta il tipo di sconto dell'offerta su None per una configurazione più pulita. Il comportamento è lo stesso e il tag continuerà a comparire.

Devo fare qualcosa?

No. Puoi ignorare tranquillamente il codice _bundlex nei tuoi ordini. Supporta l'idoneità allo sconto e l'attribuzione dei ricavi. Se compare in un template rivolto ai clienti, verifica come il template visualizza le proprietà private. Se noti un ordine in cui ti aspettavi uno sconto ma non è stato applicato, controlla a quale livello corrispondeva la quantità acquistata prima di presumere che ci sia un problema.