Estensioni e funzioni dell’app

Alcune app aggiungono funzionalità al negozio utilizzando estensioni e funzioni. Le estensioni e le funzioni vengono configurate dallo sviluppatore di app e diventano disponibili quando installi e attivi l’app.

Le estensioni consentono alle app di aggiungere funzionalità ad aree come il Negozio online, il check-out, gli account cliente o il POS. Ad esempio, un’app potrebbe aggiungere un campo personalizzato alla pagina di check-out, aprire un bot per la chat sul negozio online o mostrare i punti fedeltà negli account cliente.

Functions consente alle app di personalizzare la logica di back-end del negozio. Ad esempio, un’app potrebbe utilizzare una function per creare un tipo di sconto personalizzato, modificare le opzioni di consegna al check-out o applicare regole di pagamento specifiche. Le function vengono eseguite automaticamente come parte delle operazioni del negozio dopo la configurazione dell’app.

Puoi visualizzare e gestire le estensioni e le funzioni delle app installate da Impostazioni > App nel pannello di controllo Shopify. Nella pagina delle informazioni sull’app, i riquadri Estensioni e Functions mostrano quante sono attualmente attive e in quali aree del negozio sono disponibili. Passa il puntatore sul testo delle aree per visualizzare dove sono attive, ad esempio Check-out, Account cliente, Negozio online o POS per le estensioni e Check-out, Sconti, Pagamenti o Spedizione e consegna per le funzioni.

Clicca su Estensioni o Functions per visualizzare l’elenco completo per quell’app. Nella pagina Estensioni o Functions, puoi passare dalla scheda Attive alla scheda Inattive per controllare quali estensioni o funzioni sono attualmente in esecuzione. Clicca su un’estensione o una funzione per aprirla. A seconda dell’estensione, si apre l’area del negozio in cui puoi attivarla o gestirla oppure i dettagli sullo stato di funzionamento dell’estensione.

Se sei uno sviluppatore di app, consulta le dev docs di Shopify sulle estensioni e le dev docs di Shopify su Functions per la documentazione tecnica.

Attivazione di estensioni e function

Puoi attivare e disattivare le estensioni e le function nell’area del pannello di controllo Shopify in cui vengono utilizzate. Dalla pagina Estensioni o Functions nelle impostazioni dell’app, clicca sul nome di un’estensione o di una function per passare all’area in cui può essere gestita. Dopo aver attivato un’estensione o una function, questa viene visualizzata come attiva nella pagina delle informazioni dell’app.

Se puoi consultare i dettagli sullo stato di funzionamento di un’estensione, cliccando su un’estensione del check-out o degli account cliente si aprono invece questi dettagli. Per aprire l’editor per una di queste estensioni, passa il puntatore sulla riga dell’estensione, quindi clicca sull’icona Apri nell’editor.

Estensioni

Le estensioni possono essere attivate nelle seguenti aree del pannello di controllo Shopify:

Functions

Le function possono essere attivate nelle seguenti aree del pannello di controllo Shopify:

Eventi delle app dalle estensioni

Le app possono usare le proprie estensioni di check-out e degli account cliente per inviare eventi dell'app a Shopify. Un evento dell'app registra un'azione all'interno di un'estensione, come la visualizzazione di un'offerta da parte di un cliente. Shopify utilizza gli eventi delle app per mostrare, nelle analisi del negozio, come i clienti utilizzano l'app. Anche lo sviluppatore di app può visualizzare gli eventi per monitorare e fornire assistenza per la propria app, anche per le proprie finalità di analisi.

Gli eventi delle app sul check-out e sugli account cliente vengono inviati solo dopo che un cliente ha autorizzato le analisi nelle impostazioni sulla privacy dei clienti. Shopify potrebbe restituire al merchant informazioni aggregate relative all'ID visitatore e all'ID sessione, allegate a un evento dell'app dello sviluppatore, per le analisi del merchant. Se non vuoi che un'app invii eventi dell'app sulla vetrina virtuale, disinstallala.

Comprendere lo stato di funzionamento delle estensioni

Lo stato di funzionamento delle estensioni indica l’affidabilità del caricamento delle estensioni di un’app nel check-out o negli account cliente. Quando un’estensione dell’app non viene caricata, i clienti non possono utilizzare la funzionalità che aggiunge al check-out o agli account cliente, come un campo personalizzato o i punti fedeltà.

Considerazioni sullo stato di funzionamento delle estensioni

Prima di visualizzare lo stato di funzionamento delle estensioni di un’app, leggi le seguenti considerazioni:

  • Lo stato di funzionamento viene misurato solo per le estensioni attive nel check-out e negli account cliente.
  • Lo stato di funzionamento non viene misurato per le estensioni in altre aree, come Negozio online o POS, né per le funzioni.
  • I tassi di errore vengono stimati con un approccio prudente, quindi è meno probabile che un’estensione con pochi caricamenti venga segnalata per un numero ridotto di errori.

Come viene visualizzato lo stato di funzionamento delle estensioni

Ogni estensione del check-out e degli account cliente mostra uno dei seguenti stati di funzionamento:

  • Buono: non sono stati rilevati errori di caricamento persistenti per l’estensione.
  • Avviso: oltre il 5% dei caricamenti dell’estensione negli ultimi 7 giorni non è andato a buon fine e il tasso di errore è rimasto superiore al 5% per 72 ore.
  • Critico: oltre il 50% dei caricamenti dell’estensione negli ultimi 7 giorni non è andato a buon fine e il tasso di errore è rimasto superiore al 50% per 48 ore.
  • Dati insufficienti: non ci sono dati sufficienti per misurare lo stato di funzionamento dell’estensione. Questo stato viene visualizzato quando l’estensione è stata caricata meno di 10 volte negli ultimi 7 giorni o quando la versione attuale non dispone ancora di dati storici sufficienti. Lo stato di funzionamento viene misurato per ogni versione di un’estensione, quindi un’estensione aggiornata di recente può mostrare questo stato finché la nuova versione non raggiunge almeno 7 giorni di attività, anche se viene caricata spesso.

Le estensioni hanno anche una pagina dei dettagli che mostra lo stato di funzionamento e le seguenti metriche relative agli ultimi 7 giorni:

  • Tasso di errore: la percentuale di caricamenti dell’estensione non riusciti.
  • Caricamenti non riusciti: il numero di volte in cui non è stato possibile caricare l’estensione a causa di un problema dell’app.
  • Caricamenti dell’estensione: il numero di volte in cui l’estensione è stata caricata.

Controlla lo stato di funzionamento di un’estensione

  1. Dal pannello di controllo Shopify, vai su Impostazioni > App.

  2. Clicca sull’app che vuoi controllare.

  3. Clicca su Estensioni.

  4. Nella scheda Attive, controlla la colonna Stato di funzionamento per ogni estensione del check-out e degli account cliente.

  5. Facoltativo: per consultare ulteriori dettagli, clicca sul nome dell’estensione.

Gestione degli errori di caricamento delle estensioni

Se lo stato di un’estensione è Avviso o Critico, un banner nella pagina dei dettagli dell’estensione indica che gli errori sono dovuti a un problema dell’app e che lo sviluppatore dell’app ha ricevuto una notifica. Per aprire l’estensione nell’editor, clicca su Apri nel check-out o Apri negli account cliente. Per ricevere assistenza con l’estensione, contatta lo sviluppatore dell’app.

Se lo stato di un’estensione diventa Critico, lo staff che può consultarne lo stato di funzionamento riceve un avviso nel feed Avvisi del negozio. Clicca sull’avviso per aprire la pagina dei dettagli dell’estensione.

Risoluzione dei problemi relativi agli errori delle function

Se si verifica un errore in una function, viene visualizzato un avviso nella scheda Functions della pagina delle informazioni dell’app e nella pagina dedicata alle function. La scheda mostra Errori in [numero] area invece del solito conteggio delle aree disponibili e l’avviso indica quando sono stati rilevati gli errori più recenti.

Nella pagina Funzioni, le funzioni che presentano errori sono evidenziate da un’icona Attenzione. Se una funzione presenta errori, contatta lo sviluppatore di app per ricevere assistenza. In alcuni casi, l’errore potrebbe essere già stato risolto. Puoi anche condividere i log delle funzioni per aiutare lo sviluppatore a risolvere il problema.