Vai al contenuto principale
Questa pagina è il catalogo completo alla base dell’editor delle Strategie: ogni trigger e gli operatori che accetta, ogni azione, i filtri globali e il modo in cui viene valutata una Strategia. È il complemento della guida Costruire le strategie: consultala quando ti servono tutti i dettagli su un’opzione specifica. Una regola abbina dei trigger (il quando) a delle azioni (il cosa) e puoi combinare fino a cinque trigger con un unico interruttore AND / OR: con AND ogni trigger deve corrispondere, con OR ne basta uno qualsiasi. Le sezioni seguenti seguono questa struttura: prima Trigger e Azioni, poi i controlli a livello di Strategia che si applicano a tutte le regole: ordinamento delle regole, Filtri globali e il Catch all.

Trigger

I trigger determinano quando si attiva una regola. Tipi di trigger disponibili:

Trigger di prodotto

Targeting basato sui prodotti nel contesto (il carrello dell’acquirente, l’ordine appena completato o il prodotto visualizzato):
  • Specific product(s) - corrisponde a prodotti Shopify specifici per ID
  • Collection - corrisponde ai prodotti che appartengono a collezioni specifiche
  • Tag(s) - corrisponde ai prodotti con tag specifici (ad es. “sale”, “summer”)
  • Title - corrisponde al titolo del prodotto
  • Vendor - corrisponde al nome del fornitore/marchio
  • Type - corrisponde al campo del tipo di prodotto (ad es. “Apparel”, “Electronics”)
  • Handle - corrisponde allo slug dell’URL del prodotto
  • Metafield - corrisponde a coppie personalizzate namespace/chiave/valore dei metafield
  • Selling plan - corrisponde a prodotti “subscription” o “one-time”. Viene valutato solo quando il contesto della richiesta fornisce un selling plan per il prodotto: le superfici di upsell del checkout e post-acquisto di Aftersell non lo inviano, quindi lì il trigger non corrisponderà a meno che un’integrazione personalizzata non lo fornisca esplicitamente

Trigger del cliente

Targeting basato su chi è l’acquirente:
  • Customer tag - ad es. “VIP”, “loyalty-gold”
  • Country code - paese di fatturazione
  • Province code - provincia/stato di fatturazione
  • Locale - lingua del cliente (ad es. “en-US”)
  • Accepts marketing - stato del consenso al marketing
  • Order count - numero di ordini precedenti
  • Total spent - spesa complessiva

Trigger del carrello

Targeting basato sullo stato complessivo del carrello:
  • Cart subtotal - ad es. subtotale superiore a $50
  • Item count - quantità totale di articoli nel carrello
  • Line count - numero di righe distinte
  • Cart attribute - attributi personalizzati del carrello impostati tramite la cart API di Shopify
  • Cart note - il campo nota del carrello

Trigger di località

Targeting basato sulla destinazione di spedizione dell’acquirente e sulla valuta del negozio:
  • Shipping country - paese di destinazione della spedizione
  • Shipping province - provincia/stato di destinazione della spedizione
  • Shipping method - metodo di spedizione selezionato
  • Store currency - il codice della valuta attiva del negozio

Trigger di marketing

Targeting basato sull’URL della pagina su cui è arrivato l’acquirente:
  • URL - corrisponde a una sottostringa dell’URL di atterraggio, così puoi puntare a una campagna o a un canale specifico facendo corrispondere un parametro incluso nell’URL (ad es. utm_source=newsletter)

Trigger temporali

Targeting basato sul momento in cui viene valutata la richiesta, nell’orario del negozio:
  • Day of week - il giorno corrente
  • Hour of day - l’ora corrente

Trigger dinamici

  • Always match - un trigger senza condizione che si attiva sempre. Usalo per far eseguire una regola a ogni richiesta (è diverso dal Catch all a livello di Strategia, che si attiva solo quando nessun’altra regola corrisponde).
Non tutti i trigger vengono popolati su ogni superficie. Il checkout, ad esempio, invia solo il contesto di prodotto e carrello: lì i trigger del cliente, di località e di marketing non corrisponderanno. Consulta le guide Implementare le Strategie per sapere cosa invia ogni superficie.

Operatori

Ogni trigger usa un operatore per definire come viene confrontato il valore. Gli operatori disponibili dipendono dal tipo di trigger. Non tutti gli operatori sono disponibili per ogni trigger:
  • Gli operatori di elenco (Contains any / all e le loro negazioni) si applicano a campi multivalore come tag, collezioni, tag cliente e prodotti specifici.
  • Gli operatori di testo (Equals, Contains e le loro negazioni) si applicano a campi di testo a valore singolo come titolo, fornitore, handle, lingua, paese e URL.
  • Gli operatori numerici si applicano a campi come subtotale del carrello, numero di articoli, numero di righe, numero di ordini, spesa totale e ora del giorno. Gli operatori numerici non hanno varianti “does not”.
  • Alcuni campi supportano solo Equals e Does not equal: selling plan, giorno della settimana e accepts marketing.

Azioni

Le azioni creano l’esperienza che vuoi offrire al cliente. È qui che decidi quali prodotti proporre, come proporli ed eventuali dati aggiuntivi da passare insieme a essi. Una regola può avere più azioni configurate insieme per costruire l’esperienza completa. Per ogni regola, tutte le azioni configurate contribuiscono a un unico pool combinato. Ad esempio, una regola con un’azione su prodotti specifici, un’azione su una collezione e un’azione basata sui tag restituirà insieme i prodotti di tutte e tre le fonti. Se un prodotto corrisponde a più fonti, viene deduplicato.

Azioni di prodotto

Gli stessi attributi di prodotto disponibili per i trigger sono disponibili anche per la definizione delle azioni. Puoi restituire prodotti in base a:
  • Prodotti specifici - scegli manualmente singoli prodotti dal tuo catalogo Shopify.
  • Collezione - restituisci tutti i prodotti che appartengono a una collezione specifica.
  • Attributi di prodotto - restituisci i prodotti che corrispondono a criteri come tag, fornitore, tipo di prodotto o metafield, gli stessi tipi di attributo usati nei trigger.

Azioni dinamiche

Le azioni dinamiche cambiano ciò che viene restituito in base a segnali in tempo reale anziché a un elenco fisso di prodotti. I tipi di azione dinamica disponibili includono:
  • Most popular - i prodotti con le migliori prestazioni del tuo negozio per volume di vendite, sull’intero negozio o limitati a una collezione.
  • Recently purchased - prodotti acquistati di recente nel negozio.
  • Inherit from when - riutilizza i trigger della regola stessa (il “quando”) come selettore di prodotti, in modo che i prodotti restituiti corrispondano agli stessi criteri per cui la regola si è attivata.
  • AI Recommendations - suggerimenti personalizzati generati dal modello di raccomandazione di Aftersell.

Azioni di filtro

Una volta assemblato il pool di prodotti, puoi configurare quanti prodotti vengono restituiti e in quale ordine:
  • Sort - controlla quali prodotti vengono selezionati:
    • Random - una selezione casuale.
    • Price: high → low - vengono restituiti per primi i prodotti più costosi.
    • Price: low → high - vengono restituiti per primi i prodotti meno costosi.
  • Amount/Limit - imposta il numero massimo di prodotti da restituire.
  • Type - restringe il pool di prodotti assemblato a un singolo tipo di prodotto Shopify. Scegli Equals per una corrispondenza esatta o Contains per una corrispondenza di sottostringa (entrambi non fanno distinzione tra maiuscole e minuscole). Vengono mantenuti solo i prodotti il cui tipo corrisponde al valore inserito; gli altri vengono rimossi prima che venga applicato Amount/Limit.
Il filtro Type riduce il pool di prodotti assemblato dalle tue azioni di prodotto: è diverso dall’azione di prodotto Product type, che restituisce i prodotti di un determinato tipo. Usa il filtro quando vuoi limitare ciò che può restituire un’azione più ampia (come un’azione su una collezione o un’azione dinamica).
Viene applicato prima Sort, poi Amount/Limit. Ad esempio, se l’ordinamento è impostato su Random, l’intero pool di prodotti viene mescolato prima che venga applicato il limite, quindi ottieni sempre una porzione casuale, non gli stessi prodotti in ordine casuale.

Azioni chiave-valore

Facoltativamente, puoi associare coppie chiave-valore a una regola. Quando la regola corrisponde, queste vengono restituite in meta.data nella risposta dell’API insieme ai risultati dei prodotti. Usi comuni:
  • Testo dei banner promozionali
  • Etichette delle campagne per le analitiche
Se più regole corrispondono ed emettono la stessa chiave, prevale il valore della prima regola corrispondente: le regole successive non possono sovrascriverlo.

Priorità delle regole e ordine di valutazione

Le regole all’interno di una Strategia vengono valutate in ordine, un passaggio alla volta. Il passaggio 1 viene valutato per primo, e così via. Puoi riordinare le regole trascinandole nell’editor delle Strategie. Il motore di valutazione:
  1. Valuta i trigger di ogni regola rispetto al contesto fornito.
  2. Raccoglie i prodotti da tutte le regole corrispondenti.
  3. Deduplica e limita il risultato al massimo configurato (predefinito: 20 prodotti).

Filtri globali

I filtri globali rendono i prodotti non idonei alla selezione in tutte le regole di una Strategia. Puoi accedervi tramite l’icona del filtro accanto al nome della Strategia, in alto a sinistra nell’editor delle Strategie. Filtri globali disponibili:
  • Exclude out of stock - esclude automaticamente qualsiasi prodotto attualmente non disponibile per l’acquisto.
  • Exclude input products - esclude i prodotti che hanno attivato la regola (ad es. il prodotto che un acquirente sta visualizzando in una PDP), così non raccomandi mai lo stesso prodotto che l’acquirente sta già guardando.
  • Exclude by product tag - esclude i prodotti con tag specifici.
  • Exclude by metafield - esclude i prodotti che corrispondono a uno specifico namespace/chiave/valore di metafield.
  • Exclude by product ID - esclude prodotti specifici per ID.
  • Require stock at location - mantiene solo i prodotti con inventario disponibile in una sede scelta (richiede i permessi di lettura per inventario e sedi).

Catch all

Catch all è una regola speciale che funge da passaggio finale di ogni valutazione di una Strategia. Non ha trigger; si attiva automaticamente se nessun’altra regola della Strategia corrisponde alla richiesta corrente. Quando è abilitato, il Catch all garantisce che il tuo slot di raccomandazione non sia mai vuoto. La sua azione può essere configurata usando uno qualsiasi dei tipi di azione disponibili per le regole normali: prodotti specifici, collezioni, azioni dinamiche, ecc.
  • Abilita/disabilita - attiva o disattiva la regola Catch all per la Strategia. Quando è disattivata, le richieste che non corrispondono a nessuna regola restituiranno un risultato vuoto.
  • Configura le azioni - definisci cosa restituire usando qualsiasi combinazione dei tipi di azione disponibili, come per qualsiasi altra regola.
Quando si attiva il Catch all, la risposta dell’API indicherà resolution.fallbackUsed: true.