Campaigns

Il Merchandising ti offre un alto livello di controllo sui prodotti mostrati da Clerk, come il potenziamento dei prodotti in saldo, la priorità a marchi specifici, l’occultamento dei prodotti non disponibili e molto altro.

Informazioni di base #

Le campagne hanno sempre un Nome a tua scelta. Facoltativamente, puoi aggiungere una Descrizione per ricordare a te stesso e ai tuoi colleghi lo scopo della campagna.

Pianificazione #

Decidi se una campagna deve essere attiva indefinitamente o durante un periodo di tempo specifico. La pianificazione è particolarmente utile se vuoi influenzare i risultati solo durante un periodo come la settimana del Black Friday o durante le vendite natalizie.

Usare la pianificazione significa che non dimenticherai accidentalmente di disattivare la campagna quando non è più applicabile.

Selezione dei prodotti #

Quando configuri Trigger e Regole, dovresti scegliere i prodotti in modo che le tue campagne restino aggiornate anche quando il catalogo cambia.

Puoi selezionare manualmente i prodotti con Product List, ma è consigliato scrivere parole chiave con Search o usare Filters per selezionare dinamicamente i prodotti.

Così facendo manterrai rilevanti le tue campagne, anche quando i prodotti esauriscono e nuovi articoli vengono aggiunti al catalogo.

Product List #

Questo è il modo più semplice per scegliere i prodotti per la tua campagna. Cerca semplicemente i prodotti desiderati e cliccaci sopra per selezionarli.

Puoi selezionare quanti prodotti vuoi. Se in seguito i prodotti scompaiono dal catalogo, non saranno più inclusi nei risultati.

Ordine dei prodotti #

Quando una regola utilizza Product list, puoi impostare l’ordine dei prodotti selezionati direttamente nel selettore di prodotti. Questo è l’ordine che gli acquirenti vedono quando la regola posiziona quei prodotti nei risultati.

1. Apri Merchandising e modifica la campagna.
2. In Rules, clicca sul pulsante che mostra i prodotti selezionati dalla regola per aprire il selettore di prodotti.
3. Afferra la maniglia punteggiata accanto a un prodotto selezionato e trascinala nella posizione desiderata. La riga segue il cursore e una casella tratteggiata mostra dove verrà posizionata.
4. Rilascia la riga nella casella tratteggiata. Ripeti per tutti gli altri prodotti che vuoi spostare.
5. Chiudi il selettore e clicca su Save nella campagna.

Per riordinare con la tastiera, focalizza una riga di prodotto e premi Alt + ↑ o Alt + ↓. I lettori di schermo annunciano lo spostamento.

Ad esempio, sposta un prodotto selezionato dalla quarta alla prima posizione per posizionarlo prima degli altri prodotti scelti manualmente. Puoi cambiare questo ordine senza rimuovere e riselezionare i prodotti. La regola controlla ancora dove vengono posizionati nei risultati.

Search #

Scegli i prodotti usando testo libero. Digita semplicemente le parole chiave che corrispondono ai prodotti che vuoi includere, come “Nike sneakers”, “proteine whey fragola” o “macbook pro”.

Qualsiasi prodotto che corrisponde a queste parole chiave in qualsiasi momento farà parte della campagna.

Filters #

Possono essere utilizzati per selezionare dinamicamente i prodotti in base ai loro attributi. Qualsiasi prodotto che corrisponde ai filtri in qualsiasi momento farà parte della campagna.

L’interfaccia dei Filtri ti consente di scegliere qualsiasi numero di attributi, come prodotti in saldo con un prezzo inferiore a €100 che sono anche articoli ad alto margine.

Valori Dinamici #

Quando una campagna utilizza When Seeing Products Matching, puoi fare in modo che un filtro usi un attributo preso dal prodotto che il visitatore sta visualizzando. Questo consente alla stessa campagna di adattarsi a ciascuna pagina prodotto invece di usare un valore fisso.

Nella sezione Filtri della campagna, configura ogni filtro con:

1. L’attributo prodotto su cui filtrare, come marca, tipo prodotto o tag.
2. La condizione, come is o contains.
3. Fixed value per inserire un valore specifico, oppure Current product per usare il prodotto visualizzato.
4. Il valore con cui confrontare, o l’attributo da usare dal prodotto attuale.

Ad esempio, scegli Current product e usa il tipo del prodotto attuale per mostrare articoli dello stesso tipo. Puoi combinarlo con altri filtri, come una condizione di prezzo fissa.

L’espressione del filtro può comunque essere modificata manualmente. I valori dinamici usano il formato {{ attribute_name }}, dove attribute_name è sostituito dall’attributo corrispondente del prodotto visualizzato.

Il conteggio dei prodotti non viene mostrato nell’editor per i filtri che usano valori di prodotto attuali, poiché non esiste un prodotto attuale finché un visitatore non apre una pagina prodotto. Questi valori vengono risolti sul sito a partire dal prodotto visualizzato.

I valori di prodotto attuale sono disponibili solo per le regole di Merchandising. Audience, email e altri filtri restano invariati.

Valori Cliente #

Il filtro prodotto di una regola può confrontare un attributo del prodotto con uno del cliente identificato. Questo permette a una regola di scegliere prodotti diversi per ciascun visitatore o destinatario email, in base al paese, al genere o al gruppo cliente.

I valori Cliente funzionano nei widget Search e Recommendations dello storefront, Email Embeds, AI Newsletters e Flows.

1. Apri Merchandising e modifica la campagna.
2. In Rules, apri la selezione dei prodotti della regola.
3. Apri la scheda Filter e clicca su Add filter.
4. Scegli l’attributo del prodotto e la condizione da confrontare.
5. Imposta la fonte del valore su Customer e scegli l’attributo cliente.
6. Chiudi la selezione prodotti e clicca su Save nella campagna.

Ad esempio, confronta i paesi disponibili per un prodotto con il paese del cliente per selezionare prodotti spedibili. Entrambi gli attributi devono contenere valori compatibili affinché il confronto abbia successo.

Se registri il genere del cliente e lo invii a Clerk.io, puoi confrontarlo con l’attributo del prodotto per il genere e selezionare prodotti corrispondenti. Sono necessari dati di genere sia su clienti che su prodotti, con valori compatibili.

Puoi anche usare un gruppo cliente per selezionare prodotti pertinenti.

Puoi combinarlo con un trigger attributo cliente. Il trigger decide quando far partire la campagna; il valore cliente decide quali prodotti seleziona la regola.

Identificazione

I valori cliente richiedono l’email del cliente e l’attributo scelto nel relativo record cliente in Clerk.io. L’email identifica il cliente; non fornisce valori mancanti per paese, genere o gruppo.

Per newsletter e flow emails, la regola usa gli attributi del destinatario. Assicurati che l’attributo scelto sia presente nel record cliente in Clerk.io.

Clerk.js gestisce automaticamente questo per i negozi che già registrano login o identificazioni cliente per Clerk.io. Un clic in campagna che trasporta l’email del cliente conta anch’essa come identificazione.

Per un cliente loggato, l’email viene ricordata tra i caricamenti di pagina durante la sessione di navigazione. Non viene mai memorizzata in modalità cookie-less o privata.

Per integrazioni personalizzate, vedi Customer Context di seguito.

Valori mancanti

Se l’email del cliente è sconosciuta o non ha valore per l’attributo scelto, la regola viene saltata. Questo non causa errori. Le regole esistenti mantengono il comportamento attuale.

Una regola regionale, quindi, limita i prodotti solo per clienti identificabili che hanno l’attributo richiesto. I visitatori anonimi non hanno tale restrizione.

Trigger #

Questi controllano dove devono essere attive le campagne. I Trigger spaziano da ovunque, fino a uno specifico banner su una specifica pagina prodotto.

Le campagne possono essere eseguite su uno qualsiasi dei Trigger selezionati, oppure solo quando tutti i criteri di trigger sono soddisfatti.

Di seguito tutti i Trigger attualmente disponibili.

Cross-Platform #

Usato per indirizzare tutti gli elementi Clerk o selezionarne alcuni specifici in base ai loro Content ID o endpoint API.

• Anywhere: Tutti gli elementi Clerk su sito, email e Chat.
• Only for Specific Content: Qualsiasi Content block selezionato creato in Search, Recommendations ed Email.
• For Specific API Endpoint: Endpoint come recommendations/complementary o search/predictive. Solitamente serve solo per setup server-side.
• For Specific API Parameter: Permette di attivare la campagna programmando.
• When Customer Attribute …: Target sui clienti identificati con attributi che corrispondono alle proprie condizioni.
• When Customer is in Audience …: Target sui clienti che rientrano in una o più Audience selezionate.

Search #

Specializzato per i risultati mostrati in Instant Search, Search Page o Omnisearch.

• On All Searches: Qualsiasi ricerca fatta dai visitatori.
• When a Search: Parole specifiche di tua scelta per una corrispondenza esatta o approssimativa, oppure quando la query contiene semplicemente le parole. Può anche essere lasciato vuoto per targetizzare l’empty-state in Omnisearch, prima che una query venga digitata.

Chat #

Specializzato per i risultati mostrati nella Chat quando cerca prodotti.

• On All Chat Searches: Impatta tutti i prodotti mostrati in Chat durante la ricerca.
• When a Chat Search…: Impatta solo i prodotti trovati con parole chiave specifiche. Scegli parole per una corrispondenza esatta o approssimata, oppure query che contengono le parole.

Recommendations #

Specializzato per elementi onsite che utilizzano la logica Recommendations, come Bestsellers in home page o Cross-Sell sulle pagine prodotto.

• When Seeing Category: Seleziona una specifica pagina categoria per nome. Si applica alla logica Bestsellers & Trending in Category, sia come banner che come pagina.
• On All Categories: Come sopra, ma su tutte le pagine categoria.
• When Seeing Products Matching: Si applica a Best Cross-Sell e Best Alternatives sulle pagine prodotto corrispondenti alla selezione.
• On All Recommendations: Tutti gli elementi Recommendations sul sito.

Email #

Specializzato per email marketing, sia quando si incorporano prodotti che quando si usano email inviate con Clerk.

• Only for Specific AI Campaign: Selezionata per nome.
• Only for Specific Newsletter: Selezionata per nome.
• Only for Specific Trigger: Selezionata per nome.
• Only for Specific Embedded Email: Selezionata per nome dell’Embed.
• On All AI Campaigns: Targetizza qualsiasi AI Campaign attiva.
• On All Newsletters: Targetizza qualsiasi Newsletter attiva.
• On All Triggers: Targetizza qualsiasi trigger attivo.
• On All Embedded Emails: Targetizza qualsiasi Email Embed attivo.

Regole #

Queste decidono come sono influenzati i risultati cambiando la loro posizione nei risultati. Per posizione si intende se un prodotto è mostrato come 1° risultato, 10°, 34° e così via.

Le regole possono andare da molto ampie, come il potenziamento di tutti i prodotti in saldo, a molto specifiche come fissare un paio di sneakers Nike nel banner degli alternativi per un altro paio simile.

Forzatura #

Ignora la logica esistente, inclusi filtri e altre regole Merchandising. I prodotti possono anche essere forzati nei risultati dove altrimenti non verrebbero mostrati.

• Pin: La regola più aggressiva. Forza uno o più prodotti in cima, indipendentemente dalla logica.

Ordinamento #

Cambia l’ordine dei risultati mostrando solo i prodotti che erano già nell’insieme dei risultati.

Ad esempio, se promuovi le scarpe Nike Air 2.0, non appariranno per ricerche su “t-shirts”, ma avranno più visibilità per ricerche su “sneakers”.

Le regole di ordinamento influenzano i risultati mantenendo viva l’intelligenza dell’AI di Clerk.io.

• Adjust position in results: Sposta i prodotti corrispondenti verso l’alto di una percentuale. Un aggiustamento del 50% sposta un prodotto dalla posizione 20 alla 10; 100% lo porta alla posizione 1.
• Promote in results: Sparge i prodotti selezionati nei risultati, ad esempio posizionando un articolo ad alto margine ogni 3 prodotti a partire dal secondo risultato.
• Promote to position: Colloca prodotti selezionati a partire da una posizione specifica, ad esempio mostra 3 prodotti Adidas dal quarto risultato.
• Bury below others: I prodotti selezionati verranno mostrati dopo gli altri. Es. mostra i prodotti esauriti in fondo ai risultati di ricerca.
• Promote slightly (Outdated): I prodotti selezionati sono prioritizzati un po’ di più, ma non influenzerà molto i risultati. Si consiglia di usare Adjust position in results.
• Give a significant boost (Outdated): I prodotti selezionati sono prioritizzati molto di più, spesso portando questi nelle prime posizioni. Si consiglia di usare Adjust position in results.
• Give a custom boost (Outdated): Scegli un moltiplicatore personalizzato per dare priorità ai prodotti. Si consiglia di usare Adjust position in results.

Rimozione #

Seleziona prodotti specifici che possono essere mostrati, nascondendo gli altri che non soddisfano i criteri.

• Show Only: Verranno mostrati solo i prodotti selezionati, anche se ne esistono altri.
• Remove any: Nasconde completamente i prodotti selezionati.

Scopi #

Clerk utilizza gli ID di prodotto e categoria per applicare le campagne. Le campagne Multi Store funzionano correttamente solo se questi ID sono coerenti tra i tuoi Store.

Le campagne possono essere aggiunte a un singolo Store o a più contemporaneamente. Questo ti dà la libertà di influenzare i risultati su tutta l’attività o solo sulle parti che contano.

Ogni campagna può essere configurata con uno Scopo in base a dove vuoi venga eseguita. Usa il menu Edit scope per selezionare gli Store su cui attivare la campagna.

Dall’overview Merchandising, puoi vedere e creare campagne per lo Store attuale dalla pagina Single Store e usare la pagina Multiple Stores per campagne cross-account.

Ulteriori dettagli #

Questi dettagli spiegano i casi limiti importanti per configurare o risolvere problemi con le regole di riordino:

• Promote in Results, Promote to Position e Adjust Position riordinano solo i prodotti già nella finestra dei risultati attuali. Pin può aggiungere prodotti che non sono nei risultati organici.
• La priorità delle regole è: Pin, Promote to Position, Promote in Results, poi Adjust Position. I prodotti vengono spostati, non duplicati.
• Mantieni distinti questi limiti:
  • API limit: prodotti restituiti per ogni pagina.
  • Promote to Position limit: prodotti inseriti nel suo blocco.
  • Adjust Position Max depth: fino a che punto nell’elenco i prodotti corrispondenti possono essere trovati.
• Il Merchandising si applica prima della paginazione. Mantieni la dimensione pagina costante usando Load more e controlla la prima pagina insieme alla successiva.
• Il servizio Search sottostante fa gran parte del lavoro pesante per il Merchandising, quindi la versione Search influenza la finestra dei risultati. Search v2 applica le regole di riordino all’intero risultato endpoint prima di tagliare secondo l’API limit; Search v3 le applica a una finestra limitata recuperata prima di ritagliare. Un prodotto posizionato in profondità potrebbe quindi essere raggiungibile in Search v2 ma fuori dalla finestra di Search v3. Usa Pin se il prodotto deve comparire.

Per sviluppatori #

Le campagne possono essere attivate e disattivate anche via codice, dandoti maggiore controllo su dove applicarle. Casi d’uso includono il trigger di campagne al login di gruppi clienti o al raggiungimento di una certa dimensione carrello.

Customer Context #

Per regole basate sui clienti in una integrazione custom dello store, imposta l’email nota del visitatore in Clerk.js prima di fare le chiamate che vuoi usare:

Clerk('context', 'email', 'customer@example.com');

Sostituisci l’esempio con l’email del visitatore identificato. Puoi anche passarla direttamente nella chiamata API storefront. Clerk.io userà l’email per recuperare gli attributi del cliente senza attendere il mapping cliente-visitatore.

API Trigger #

Crea la Campagna con il trigger For Specific API Parameter. Copia il suo ID per l’uso nelle chiamate API.

Includi il parametro merchandising nelle chiamate API. Deve essere inviato come lista di uno o più Campaign ID:

$ curl -X POST \
       -H 'Content-Type: application/json' \
       -d '{"key":      "your_api_key",
            "visitor":  "aR9Km32l",
            "limit":    4,
            "labels":   ["Most Popylar"],
            "merchandising": ["boost-bracelets", "high-margin"]' \
       http://api.clerk.io/v2/recommendations/popular

Clerk.js Trigger #

Includi il parametro data-merchandising nel tuo embedcode. Deve contenere una lista di uno o più Campaign ID:

<span class="clerk"
  data-template="@home-page-popular"
  data-merchandising="['boost-bracelets', 'high-margin']"
></span>

Disabilitazione in API #

Se Clerk.io mostra risultati imprevisti, può essere utile disabilitare tutte le campagne Merchandising per una chiamata API, per verificare se quella è la causa.

Puoi farlo aggiungendo il parametro flags=disable.merchandising alla chiamata API:

https://api.clerk.io/v2/recommendations/popular?key=your_api_key&flags=disable.merchandising=true

Questo disabiliterà tutte le campagne Merchandising per quella chiamata API, senza interrompere il resto del setup di Clerk.io.