Trigger personalizzati per la vetrina online

I trigger integrati per la vetrina online coprono gli eventi riportati all'indirizzo Shopify. Un trigger personalizzato per la vetrina online copre tutto il resto di ciò che avviene sulla Sua vetrina online: Le basta pubblicare un evento dal Suo tema con una sola riga di codice JavaScript e questo diventa un trigger che potrà utilizzare all'indirizzo Shopify Flow.

L’esempio più evidente è il pannello a tendina del carrello. L’evento “cart view” di Shopify viene attivato sulla pagina /cart, ma la maggior parte dei temi moderni non effettua mai la navigazione verso tale pagina, bensì apre il pannello a tendina tramite scorrimento. Shopify non riporta alcun evento, pertanto nessuna app può rilevarlo. Pubblicando un proprio evento all’apertura del pannello a tendina è possibile colmare tale lacuna.

Altri utilizzi da parte dei negozi:

• L'aggiunta alla lista dei desideri o la selezione dell’opzione “Avvisami”, operazioni che Shopify non riporta.
• La consultazione della guida alle taglie o delle condizioni di reso, come indicazione relativa a un prodotto.
• Una modifica alla variante nel selettore, che non comporta la visualizzazione di una nuova pagina (si veda Condizioni di attivazione di Storefront).
• Qualsiasi informazione di cui il Suo tema o un’applicazione di terze parti sia già a conoscenza e che Shopify non conosca.

Come funziona

1. Crei il trigger nell'app e gli attribuisca un nome, ad esempio cart_drawer_opened. Come ogni trigger della vetrina online, richiede l'accesso al comportamento della vetrina online, che viene concesso una sola volta nella pagina “Autorizzazioni”.
2. Copi il frammento di codice di una riga che l’app Le mostra e lo incolli nel Suo tema nel punto in cui si verifica quel problema. Se non è sicuro di cosa incollare o dove, Generare codice trigger con l'intelligenza artificiale genera il frammento di codice per il Suo tema a partire da una descrizione in linguaggio semplice.
3. Scriva una trasformazione se desidera filtrare o modificare il contenuto da inviare, oppure lasci il campo vuoto per inoltrare tutto.
4. Attivatelo, quindi aggiungete un "Trigger personalizzato della vetrina online" in Shopify Flow e create un ramo in base al nome dell'evento.

Lo snippet rappresenta l'intera integrazione dal punto di vista del tema:

Shopify.analytics.publish("cart_drawer_opened", {
  // anything you want the Flow to receive
  itemCount: 3,
  total: "129.90"
});

Denominazione dell’evento

Il nome dell’evento costituisce il criterio in base al quale il workflow di Shopify Flow si ramifica; pertanto, scelga un nome chiaro e non lo modifichi più una volta che i workflow lo utilizzano.

I nomi possono contenere lettere, numeri, trattini bassi e trattini; devono iniziare con una lettera o un numero e possono contenere fino a 64 caratteri. L’app converte automaticamente ciò che digitate in uno "slug", quindi Cart drawer opened diventa cart_drawer_opened.

Il nome è associato a uno spazio dei nomi interno, pertanto non potrà mai entrare in conflitto con un evento Shopify o con un trigger personalizzato di webhook con lo stesso nome.

Filtraggio e rimodellamento

I dati che si passano come secondo argomento vengono ricevuti in Shopify Flow come output del trigger. Se ciò è tutto ciò di cui avete bisogno, avete terminato.

Se desiderate attivare l'evento solo in determinati casi, oppure inviare campi diversi da quelli pubblicati dal tema, scrivete una trasformazione (lo stesso modulo JavaScript utilizzato da Trigger personalizzato). Restituite un oggetto per attivare l'evento, restituite null per ignorarlo:

export async function transform(payload, topic, shop, ctx) {
  // Anything you published is on `payload`.
  if ((payload.itemCount || 0) < 2) return null;

  return {
    itemCount: payload.itemCount,
    total: payload.total,
    // Present only when the shopper is signed in.
    customerId: payload.customerId,
  };
}

Come utilizzarlo in Shopify Flow

Ogni trigger personalizzato dello Storefront viene visualizzato in Shopify Flow con lo stesso nome: "Trigger personalizzato dello Storefront". Lo si aggiunga a un workflow, quindi si aggiunga una condizione in cui "eventName" sia uguale al nome scelto.

È proprio questo che consente a un singolo trigger di Shopify Flow di riattivare tutti gli eventi della vostra vetrina online. Il trigger riporta inoltre il nome che gli avete assegnato nell’app e l’output della vostra trasformazione.

È stato volutamente separato da “Trigger personalizzato”, che supporta l’Trigger personalizzato basato sui webhook. I due si differenziano in un aspetto che vale la pena conoscere: un trigger personalizzato basato sui webhook viene eseguito sui nostri server ed è affidabile, mentre un evento della vetrina online dipende dal fatto che il browser dell’acquirente riesca a raggiungerci e dal suo consenso all’utilizzo dei dati analitici.

Cosa non inviare

Il secondo argomento della funzione publish è interamente sotto il Suo controllo, il che significa che è Sua responsabilità evitare di inserirvi dati personali.

Inviate gli identificativi e i dati relativi all'evento: ID del prodotto e della variante, quantità, prezzi e la descrizione dell'evento verificatosi. L'ID del cliente che ha effettuato l'accesso viene aggiunto automaticamente, qualora sia disponibile, pertanto non è mai necessario inserirlo manualmente.

Si prega di non inviare nomi, indirizzi e-mail, numeri di telefono o indirizzi postali. Il Suo workflow può ricavare tutte queste informazioni dall’ID cliente in Shopify Flow; pertanto, non vi è alcun vantaggio nell’inserirle in un evento della vetrina online e, così facendo, si trasforma un evento di analisi in un evento contenente dati personali.

Prossimi passi

• Condizioni di attivazione di Storefront - i trigger integrati nella vetrina online e il funzionamento del pixel.
• Generare codice trigger con l'intelligenza artificiale - Lasci che l'intelligenza artificiale scriva per lei il frammento di tema o la trasformazione.
• Trigger personalizzato - la stessa idea applicata agli eventi webhook di Shopify, con l'affidabilità garantita dal lato server.
• Piani e utilizzo - cosa si intende per “evento”.