Risoluzione dei problemi relativi al contenuto dei Checkout Blocks

Il contenuto dei Checkout Blocks potrebbe non essere visualizzato come previsto per vari motivi, con la conseguenza che gli elementi scompaiono o non funzionano correttamente. I problemi comuni includono il mancato rispetto delle regole di visualizzazione, errori di configurazione delle autorizzazioni o discrepanze tra le impostazioni del block stesso e il modo in cui il block è stato aggiunto all'editor del check-out e degli account.

Questa guida ti aiuta a risolvere autonomamente i problemi più comuni di Checkout Blocks. Se i problemi persistono dopo aver seguito i passaggi di questa guida, contatta l'Assistenza Shopify per ricevere assistenza.

In questa pagina

Risoluzione dei problemi dei block

I block sono gli elementi di personalizzazione che visualizzano contenuti nel check-out, come campi personalizzati, contenuti dinamici e banner. Se un block non funziona come previsto, utilizza le sezioni seguenti per identificare e risolvere il problema.

Il block non viene visualizzato nel check-out

Risoluzione dei problemi: il block non è stato aggiunto all'editor

La creazione di un blocco nell'app Checkout Blocks non lo aggiunge automaticamente al check-out. Devi aggiungere il blocco alla configurazione del check-out utilizzando l'editor del check-out e degli account.

Passaggi:

Dal pannello di controllo Shopify, vai su Impostazioni > Check-out.

Nella sezione Configurazioni, clicca su Personalizza accanto alla configurazione che desideri modificare.

Vai alla pagina di check-out in cui desideri visualizzare il block.

Clicca su ⊕ Aggiungi block e seleziona il tipo di block appropriato.

Configura l'ID del block in modo che corrisponda all'ID del block che hai creato in Checkout Blocks.

Clicca su Salva.

Risoluzione dei problemi: il block non è impostato su Attivo

Un block deve essere impostato su Attivo per essere visualizzato nel check-out. I block in stato di bozza non vengono visualizzati ai clienti.

Passaggi:

Dal pannello di controllo Shopify, vai su App > Checkout Blocks.

Clicca su Block.

Clicca sul block che desideri attivare.

Nella sezione Stato, seleziona Attivo.

Clicca su Salva.

Risoluzione dei problemi: il block non è pubblicato sul mercato o sulla pagina

Se il tuo block è configurato con impostazioni di pubblicazione specifiche per un mercato, verrà visualizzato solo nei mercati selezionati. Se il block è pubblicato solo su pagine di check-out specifiche, non verrà visualizzato su altre pagine.

Passaggi:

Dal pannello di controllo Shopify, vai su App > Checkout Blocks.

Clicca su Block.

Clicca sul block che desideri controllare.

Nella sezione Pubblicazione, verifica che il block sia pubblicato su tutti i mercati pertinenti.

Nella sezione Pagine di check-out, verifica che il block sia impostato per la visualizzazione su tutte le pagine di check-out pertinenti.

Clicca su Salva.

Risoluzione dei problemi: le regole di visualizzazione non sono state soddisfatte

Le regole di visualizzazione definiscono le condizioni che devono essere soddisfatte affinché un blocco venga visualizzato nel check-out. Se queste condizioni non vengono soddisfatte durante la sessione di check-out di un cliente, il blocco non viene visualizzato.

Passaggi:

Dal pannello di controllo Shopify, vai su App > Checkout Blocks.

Clicca su Block.

Clicca sul block che non viene visualizzato.

Controlla le regole di visualizzazione configurate per il block.

Verifica se il tuo check-out di prova soddisfa tutte le condizioni richieste, come le soglie del totale carrello, i tipi di prodotto o lo stato di accesso del cliente.

Se hai impostato Mostra solo quando: tutte le regole sono soddisfatte, assicurati che ogni regola sia soddisfatta. Se hai impostato Mostra solo quando: qualsiasi regola è soddisfatta, assicurati che almeno una regola sia soddisfatta.

Risoluzione dei problemi: ID del block non corrispondente

Ogni tipo di block nell'editor del check-out e degli account ha un'impostazione ID del block. L'ID del block nell'editor deve corrispondere all'ID del block creato nell'app Checkout Blocks. Se gli ID non corrispondono, il block non viene visualizzato.

Ad esempio, se il tuo block ha un ID del block pari a 4 nell'app Checkout Blocks, anche il block nell'editor del check-out e degli account deve avere il suo ID del block impostato su 4.

Passaggi:

Dal pannello di controllo Shopify, vai su App > Checkout Blocks.

Clicca su Block.

Clicca sul block che non viene visualizzato e prendi nota del suo ID del block.

Vai a Impostazioni > Check-out.

Nella sezione Configurazioni, clicca su Personalizza accanto alla configurazione che desideri controllare.

Clicca sul block nell'editor che dovrebbe visualizzare il contenuto.

Nelle Impostazioni del block, verifica che l'ID del block corrisponda all'ID del passaggio 3.

Se gli ID non corrispondono, aggiorna l'ID del block in modo che corrisponda.

Clicca su Salva.

Risoluzione dei problemi: il campo ID del block di anteprima contiene un valore

Il campo ID del block di anteprima (a scopo di test) nell'editor del check-out e degli account è destinato solo ai test. Se questo campo contiene un valore dopo aver salvato il check-out, può sovrascrivere le regole di visualizzazione del block e causare un comportamento imprevisto.

Passaggi:

Dal pannello di controllo Shopify, vai su Impostazioni > Check-out.

Nella sezione Configurazioni, clicca su Personalizza accanto alla configurazione che desideri controllare.

Clicca sul block che non viene visualizzato correttamente.

Nel campo ID del block di anteprima (a scopo di test), elimina qualsiasi valore in modo che il campo sia vuoto.

Clicca su Salva.

Risoluzione dei problemi: viene visualizzato un block con priorità più alta

Se hai più blocchi dello stesso tipo con regole di visualizzazione che si sovrappongono, viene visualizzato solo il blocco con la priorità più alta. Scopri di più sulla priorità dei blocchi.

Passaggi:

Dal pannello di controllo Shopify, vai su App > Checkout Blocks.

Clicca su Block.

Clicca su ⇅ Modifica priorità.

Seleziona il tipo di blocco che non viene visualizzato.

Controlla l'ordine di priorità. I blocchi con un numero più basso hanno una priorità più alta.

Modifica i numeri di priorità per cambiare il blocco da visualizzare per primo.

Clicca su Salva.

Risoluzione dei problemi per il limite di blocchi attivi raggiunto

Checkout Blocks supporta fino a 30 blocchi attivi per tipo di blocco. Se hai più di 30 blocchi attivi di un unico tipo, ad esempio 35 blocchi di campi personalizzati attivi, solo i primi 30 blocchi possono essere visualizzati nel check-out.

Passaggi:

Dal pannello di controllo Shopify, vai su App > Checkout Blocks.

Clicca su Block.

Filtra in base al tipo di blocco per cui stai risolvendo il problema.

Conta il numero di blocchi attivi.

Se hai più di 30 blocchi attivi, disattiva o elimina quelli che non ti servono più.

Il blocco viene visualizzato più volte nel check-out

Risoluzione dei problemi per un blocco aggiunto a una sezione condivisa

A seconda di dove aggiungi un blocco nell'editor del check-out e degli account, questo potrebbe essere visualizzato in ogni passaggio del check-out. La sezione Riepilogo ordine e l'area associata al pulsante Continua o torna indietro sono presenti in tutte le pagine del check-out.

Per visualizzare un blocco solo in un passaggio specifico, aggiungilo all'area dei contenuti principali di quel passaggio.

Passaggi:

Dal pannello di controllo Shopify, vai su Impostazioni > Check-out.

Nella sezione Configurazioni, clicca su Personalizza accanto alla configurazione che desideri modificare.

Clicca sul blocco che viene visualizzato più volte.

Prendi nota della sezione in cui si trova il blocco. Se si trova nella sezione Riepilogo ordine o è associato al pulsante Continua o torna indietro, il blocco viene visualizzato in ogni pagina di check-out.

Per visualizzare il blocco solo in una pagina specifica, rimuovilo dalla sezione corrente e aggiungilo all'area dei contenuti principali della pagina di check-out desiderata.

Clicca su Salva.

Risoluzione dei problemi per più istanze di blocco aggiunte

Alcuni tipi di blocco, come i blocchi Modifica articolo, in genere devono essere aggiunti al check-out una sola volta. Il blocco si basa su regole di visualizzazione per mostrare contenuti diversi per scenari diversi. Se il contenuto del blocco è duplicato, potresti aver aggiunto accidentalmente il blocco più volte del necessario.

Passaggi:

Dal pannello di controllo Shopify, vai su Impostazioni > Check-out.

Nella sezione Configurazioni, clicca su Personalizza accanto alla configurazione che desideri controllare.

Naviga tra le pagine del check-out e controlla i blocchi che sono stati aggiunti.

Se trovi blocchi duplicati dello stesso tipo e con lo stesso ID blocco, rimuovi quelli aggiuntivi cliccando sul blocco e selezionando Rimuovi blocco.

Clicca su Salva.

Risoluzione degli errori durante la creazione o il salvataggio dei blocchi

Se ricevi un errore quando provi a creare o salvare un blocco, consulta le sezioni seguenti.

Risoluzione dei problemi per l'errore “Si sono verificati alcuni problemi con l'invio del modulo”

Questo errore in genere indica che l'account staff non dispone delle autorizzazioni necessarie per creare blocchi in Checkout Blocks.

Autorizzazioni necessarie:

Autorizzazioni negozio > Contenuto: lo staff deve disporre delle autorizzazioni per visualizzare e creare e modificare le definizioni dei metaobject, nonché per visualizzare e creare e modificare le voci.
Autorizzazioni negozio > Impostazioni negozio: lo staff deve disporre dell'autorizzazione Gestisci impostazioni.
Autorizzazioni app: lo staff deve disporre almeno delle autorizzazioni per Checkout Blocks.

Passaggi:

Dal pannello di controllo Shopify, vai su Impostazioni > Utenti e autorizzazioni.
Clicca sull'account staff che sta riscontrando l'errore.
In Autorizzazioni negozio, espandi la sezione Contenuto.
Verifica che per Definizioni dei metaobject siano selezionate le autorizzazioni Visualizza e Crea e modifica.
Verifica che per Voci siano selezionate le autorizzazioni Visualizza e Crea e modifica.
In Impostazioni negozio, verifica che Gestisci impostazioni sia selezionato.
In Autorizzazioni app, verifica che Checkout Blocks sia selezionato.
Clicca su Salva.

Se non disponi dell'autorizzazione per modificare le autorizzazioni dello staff, contatta il proprietario del negozio o un membro dello staff con le autorizzazioni di gestione degli utenti.

Risoluzione dei problemi relativi agli sconti personalizzati

Gli sconti personalizzati creati in Checkout Blocks potrebbero non essere applicati come previsto per diversi motivi.

Risoluzione dei problemi per il limite di sconti automatici attivi raggiunto

Shopify consente un massimo di 25 sconti automatici attivi alla volta, inclusi gli sconti basati su app da tutte le app installate. Questo limite si applica a tutto il negozio, non solo a Checkout Blocks.

Se provi ad attivare un 26° sconto automatico, questo non verrà applicato nel check-out.

Passaggi:

Dal pannello di controllo Shopify, vai su Sconti.
Filtra per visualizzare solo gli sconti Automatici.
Conta quanti sconti automatici sono attualmente attivi.
Se hai 25 o più sconti automatici attivi, disattiva o elimina gli sconti che non ti servono più prima di attivarne di nuovi.

Scopri di più sulle limitazioni relative alla combinazione degli sconti.

Risoluzione dei problemi per sconto non attivo

Uno sconto personalizzato deve essere impostato su Attivo affinché venga applicato nel check-out. Inoltre, lo sconto non deve essere scaduto in base alle date di inizio e fine configurate.

Passaggi:

Dal pannello di controllo Shopify, vai su App > Checkout Blocks.

Clicca su Sconti.

Clicca sullo sconto che non viene applicato.

Nella sezione Stato, verifica che lo sconto sia impostato su Attivo.

Nella sezione Date di validità, verifica che la data corrente rientri tra le date di inizio e fine configurate.

Clicca su Salva.

Risoluzione dei problemi per le regole di sconto non soddisfatte

Gli sconti personalizzati in Checkout Blocks possono avere regole condizionali dettagliate che determinano quando viene applicato lo sconto. Se queste condizioni non vengono soddisfatte durante la sessione di check-out di un cliente, lo sconto non verrà applicato.

Passaggi:

Dal pannello di controllo Shopify, vai su App > Checkout Blocks.

Clicca su Sconti.

Clicca sullo sconto che non viene applicato.

Controlla le regole e le condizioni configurate per lo sconto.

Verifica se il check-out di prova soddisfa tutte le condizioni richieste, come il valore minimo dell’ordine, prodotti o collezioni specifici o i requisiti di idoneità del cliente.

Regola le regole dello sconto secondo necessità.

Clicca su Salva.

Risoluzione dei problemi relativi alle personalizzazioni dei metodi di consegna e di pagamento

Se i metodi di consegna o di pagamento non vengono nascosti, rinominati o riordinati come previsto, consulta le sezioni seguenti.

Risoluzione dei problemi di personalizzazione non attiva

Una personalizzazione del metodo di consegna o di pagamento deve essere impostata su Attiva affinché venga applicata al check-out.

Passaggi:

Dal pannello di controllo Shopify, vai su App > Checkout Blocks.

Clicca su Functions.

Clicca sulla personalizzazione che non funziona.

Nella sezione Stato, verifica che la personalizzazione sia impostata su Attiva.

Clicca su Salva.

Risoluzione dei problemi relativi al raggiungimento del limite di funzioni attive

Shopify Functions prevede dei limiti al numero di funzioni attive che puoi avere per ogni tipo. Puoi attivare un massimo di 25 funzioni di personalizzazione dei pagamenti su ogni negozio. Se superi questo limite, potresti ricevere l'errore: Impossibile abilitare la personalizzazione. Riprova o contatta l'assistenza.

Questi limiti contribuiscono a garantire che il check-out mantenga prestazioni elevate. Devi unire o rimuovere le personalizzazioni per rimanere al di sotto del limite.

Passaggi:

Dal pannello di controllo Shopify, vai su App > Checkout Blocks.

Clicca su Functions.

Conta quante personalizzazioni attive dei metodi di consegna hai (se stai cercando di risolvere i problemi relativi alla consegna) o quante personalizzazioni attive dei metodi di pagamento hai (se stai cercando di risolvere i problemi relativi al pagamento).

Se hai raggiunto il limite per quel tipo, disattiva o elimina le personalizzazioni di cui non hai più bisogno.

Prova ad attivare di nuovo la nuova personalizzazione.

Risoluzione dei problemi relativi alle regole di personalizzazione non soddisfatte

Le personalizzazioni dei metodi di consegna e di pagamento si basano su regole che determinano quando viene applicata la personalizzazione. Se queste condizioni non vengono soddisfatte durante la sessione di check-out di un cliente, la personalizzazione non avrà effetto.

Passaggi:

Dal pannello di controllo Shopify, vai su App > Checkout Blocks.

Clicca su Functions.

Clicca sulla personalizzazione che non funziona.

Controlla le regole configurate per la personalizzazione.

Verifica se il check-out di prova soddisfa tutte le condizioni richieste.

Regola le regole secondo necessità.

Clicca su Salva.

Convalida delle modifiche con un check-out di prova

Prima di fare affidamento sulle personalizzazioni di Checkout Blocks in un ambiente live, dovresti convalidarne il funzionamento previsto utilizzando un check-out di prova.

Passaggi:

Dal negozio online, aggiungi al carrello i prodotti che soddisfano le condizioni per i blocchi, gli sconti o le personalizzazioni che desideri testare.
Procedi al check-out ma non completare l’acquisto.
Controlla ogni passaggio del check-out e verifica quanto segue:
- I blocchi vengono visualizzati nelle posizioni corrette con il contenuto corretto.
- Gli sconti personalizzati vengono applicati quando i requisiti di idoneità sono soddisfatti.
- Le personalizzazioni dei metodi di consegna e di pagamento funzionano come previsto.
Se stai testando le regole di visualizzazione in base al totale del carrello, prova diversi valori del carrello per confermare che i blocchi appaiano e scompaiano alle soglie corrette.
Se stai testando le regole di visualizzazione in base al cliente, testa gli scenari di check-out sia per i clienti che hanno effettuato l'accesso sia per quelli ospite.

Domande frequenti

Quanti blocchi posso avere attivi contemporaneamente?

Puoi avere fino a 30 blocchi attivi per tipo di blocco. Ad esempio, puoi avere contemporaneamente 30 campi personalizzati attivi, 30 blocchi di contenuti dinamici attivi e 30 blocchi di modifica delle voci attivi. Puoi creare più di 30 blocchi di un tipo, ma solo i primi 30 blocchi attivi possono essere visualizzati nel check-out.

Perché sono necessarie autorizzazioni specifiche dello staff per utilizzare Checkout Blocks?

Checkout Blocks crea definizioni di metaobject per archiviare le configurazioni dei blocchi. I membri dello staff necessitano delle autorizzazioni per creare e modificare definizioni e voci di metaobject per poter salvare i blocchi nell'app. Inoltre, lo staff necessita delle autorizzazioni Gestisci impostazioni in Impostazioni negozio e di Autorizzazioni app esplicite per Checkout Blocks.

Posso utilizzare Checkout Blocks se non ho un piano Shopify Plus?

I merchant con piano Basic Shopify o superiore possono utilizzare i blocchi di contenuto dinamico e contenuto statico solo nelle pagine di ringraziamento e di stato dell'ordine. Tutte le altre funzionalità di Checkout Blocks, inclusi campi personalizzati, sconti personalizzati e personalizzazioni del metodo di consegna/pagamento, richiedono il piano Shopify Plus.

Come faccio a sapere quale ID blocco utilizzare?

Quando crei un blocco nell'app Checkout Blocks, gli viene assegnato un ID blocco (il valore predefinito è 0). Quando aggiungi quel tipo di blocco al check-out nell'editor, devi impostare lo stesso ID blocco in modo che l'editor sappia quale blocco specifico visualizzare. Se desideri visualizzare blocchi diversi dello stesso tipo in posizioni diverse, assegna a ogni blocco un ID blocco univoco e abbina tali ID nell'editor. Scopri di più sugli ID blocco.

Posso combinare gli sconti di Checkout Blocks con altri sconti?

Gli sconti personalizzati creati in Checkout Blocks sono sconti automatici basati su Shopify Functions e seguono le stesse regole di combinazione degli sconti degli altri sconti automatici. Puoi avere un massimo di 25 sconti automatici attivi nel tuo negozio, inclusi quelli creati in Checkout Blocks e in altre app.

Prima di contattare l'Assistenza Shopify in merito a Checkout Blocks

Se hai provato i passaggi per la risoluzione dei problemi sopra indicati e il problema con Checkout Blocks persiste, puoi contattare l'Assistenza Shopify per ricevere aiuto. Prima di contattare l'Assistenza Shopify, raccogli le seguenti informazioni specifiche di Checkout Blocks per risolvere il problema più rapidamente:

Dettagli del blocco: nome, tipo (ad esempio campo personalizzato, contenuto dinamico o modifica della voce) e ID blocco del blocco che non funziona
Schermate di configurazione: schermate delle impostazioni del blocco nell'app Checkout Blocks, comprese eventuali regole di visualizzazione, impostazioni di pubblicazione e stato
Schermate dell'editor: schermate di come il blocco è configurato nell'editor del check-out e degli account, compresi i campi ID blocco e ID blocco anteprima
Messaggi di errore: schermate o testo esatto di eventuali messaggi di errore ricevuti durante la creazione, il salvataggio o l'anteprima dei blocchi
URL del check-out di prova: un link a un check-out di prova o a un check-out abbandonato in cui è possibile riprodurre il problema, insieme al contenuto del carrello utilizzato per attivare le regole di visualizzazione
Comportamento previsto e comportamento effettivo: una descrizione chiara di ciò che ti aspettavi che accadesse rispetto a ciò che accade effettivamente nel check-out
Passaggi per la risoluzione dei problemi completati: quali sezioni di questa guida hai già consultato e cosa hai provato a fare
Autorizzazioni staff: la conferma che il tuo account disponga delle autorizzazioni necessarie per Contenuto (definizioni e voci dei metaobject), Impostazioni del negozio (Gestisci impostazioni) e Autorizzazioni app (Checkout Blocks)

Avere a portata di mano queste informazioni specifiche per Checkout Blocks aiuta l'Assistenza Shopify a diagnosticare e risolvere il problema in modo più efficiente.