viewa/docs
Guida all'implementazione (Italiano)

Preselezione di prodotti e materiali

Collegare il visualizzatore con un prodotto, un materiale o entrambi già selezionati.

Obiettivo: portare i visitatori direttamente al prodotto che stavano già guardando.

Qualsiasi link al visualizzatore può includere parametri facoltativi che preselezionano un prodotto, un materiale o entrambi. Il visitatore salta la fase di scelta e vede la propria selezione non appena il visualizzatore si apre. Questa funzione si abbina naturalmente ai pulsanti "Visualizza" nelle pagine prodotto.

Parametri

ParametroPreselezionaAccetta
dp (oppure product)Un prodottoLo slug o lo SKU del prodotto nel catalogo Viewa, oppure un proprio identificativo registrato come alias di catalogo
dm (oppure sku)Un materialeLo slug o lo SKU del materiale, oppure un alias di catalogo

product e sku sono nomi alternativi di dp e dm, pensati per le integrazioni che già inviano questi parametri. Se sono presenti entrambe le forme, prevalgono dp e dm.

Esempi

Sostituire l'URL dell'istanza e gli identificativi con i propri:

<!-- Solo prodotto -->
<a href="https://your-instance-url?dp=ROLLER-BLIND-01">Visualizza a casa tua</a>

<!-- Solo materiale: il visitatore sceglie il prodotto -->
<a href="https://your-instance-url?dm=CHARCOAL-WEAVE">Visualizza a casa tua</a>

<!-- Prodotto e materiale -->
<a href="https://your-instance-url?dp=ROLLER-BLIND-01&dm=CHARCOAL-WEAVE">Visualizza a casa tua</a>

<!-- Direttamente in un ambiente specifico -->
<a href="https://your-instance-url/scene/living-room?dp=ROLLER-BLIND-01">Guardalo in un soggiorno</a>

<!-- Propri identificativi, risolti tramite alias di catalogo -->
<a href="https://your-instance-url?product=roller-blinds&sku=FAB-1001">Visualizza a casa tua</a>

Un materiale viene applicato solo se il prodotto selezionato lo prevede. Se si indica solo il materiale, questo viene applicato quando il visitatore sceglie un prodotto che lo prevede.

Apertura in una nuova scheda

Aprire o meno il visualizzatore in una nuova scheda dipende dal percorso desiderato. Con target="_blank" la pagina resta aperta in secondo piano, così i visitatori possono chiudere il visualizzatore e riprendere da dove avevano lasciato; senza, il visualizzatore sostituisce la pagina e i visitatori devono tornare indietro. Quando si usa target="_blank", aggiungere anche rel="noopener".

Alias di catalogo

Raramente un sito usa gli slug e gli SKU di Viewa. Un alias di catalogo associa uno dei propri identificativi al catalogo Viewa, in modo che i link possano usare i valori già presenti sulla propria piattaforma: uno SKU di variante WooCommerce, un handle Shopify o lo slug di una categoria.

Ogni alias associa un identificativo a uno dei seguenti elementi:

Destinazione dell'aliasDa usare perEsempio
Un prodottoUn identificativo di categoria o di prodotto del proprio sitoroller-blinds → Roller Blind
Un materialeLo SKU di un tessuto o di un coloreFAB-1001 → Linen Blockout, White
Un prodotto e un materialeUno SKU che li identifica entrambiRB-1001-WHT → Roller Blind in Linen Blockout, White
Una gamma di materialiRegistrato per completezza: lo SKU di una gamma non preseleziona nullaLINEN-BO

Uno SKU che identifica sia un prodotto sia un materiale preseleziona l'elemento richiesto dal parametro, quindi va inviato in entrambi: ?product=RB-1001-WHT&sku=RB-1001-WHT.

Come vengono confrontati gli alias:

  • Il confronto ignora maiuscole/minuscole e gli spazi iniziali e finali; gli alias valgono per singola istanza.
  • Un alias ha la precedenza su uno slug o uno SKU Viewa con lo stesso valore.
  • Un alias che punta a qualcosa che il parametro non può usare (un alias di materiale in dp, oppure lo SKU di una gamma in qualsiasi parametro) non trova corrispondenze. Non si ricorre al catalogo come alternativa.

Gli alias vengono configurati da Viewa: è sufficiente inviarci gli identificativi usati sul proprio sito (l'ideale è un feed o un'esportazione dei prodotti) e li associeremo al vostro catalogo.

Da sapere

  • I valori non distinguono tra maiuscole e minuscole.
  • Un prodotto o un materiale non riconosciuto viene ignorato: il visualizzatore si apre con le impostazioni predefinite invece di mostrare un errore, quindi un link a uno SKU fuori produzione continua a funzionare.
  • La selezione resta valida per il resto della sessione del browser, anche navigando all'interno del visualizzatore.
  • Alcuni CMS ed editor di email codificano il carattere &. Se viene applicato solo il primo parametro, controllare la & tra i due.
  • La preselezione non è ancora supportata nelle istanze figlie, ovvero i visualizzatori che condividono il catalogo di un'altra istanza, come il sito di un rivenditore o di una filiale. I link verso queste istanze si aprono con le impostazioni predefinite. Contattateci se avete bisogno di questa funzione.

On this page