Introduzione

In questa pagina sono contenute tutte le istruzioni necessarie ad inserire i nuovi widget Feedaty all’interno del sito web. Le recensioni autentiche, inserite sul tuo sito, aggiungono credibilità e portano conversioni: con la nostra raccolta di widget puoi mostrare le recensioni nel tuo stile preferito, facendole diventare un elemento aggiuntivo perfettamente integrato con il tuo brand.
Per l'inclusione di un qualsiasi Widget Feedaty© è necessario aggiungere le seguenti due porzioni di codice nella pagina del proprio sito web:

  1. la libreria Javascript feedaty.js
  2. il div contenitore del widget

1. Inclusione della libreria feedaty.js ( Javascript SDK )

La risorsa Javascript:

<script async type="text/javascript" src="https://widget.feedaty.com/v3.0.0/js/2021/merchant_code/feedaty.min.js"></script>

La risorsa javascript dovrà essere inclusa appena dopo la chiusura del body e richiede i seguenti parametri:
  • Il paramentro merchant_code indica il Codice Merchant dell'account Feedaty desiderato.Il merchant code è sempre reperibile nella tua area partners personale, nella sezione: Pubblica le recensioni > API
  • Il paramentro style_ver indica l'ultima versione grafica disponibile, a oggi la 2021.

2. Inclusione del div contenitore Widget Feedaty© in una pagina HTML

Il div o contenitore

<div class="feedaty_widget" data-type="product" data-variant="Striscia-full-altwrap" data-id="selettore1" data-gui="all" data-lang="all" data-sku="prod1" data-snippets="1" data-location="sede1"></div>

Il div o contenitore è la porzione di codice HTML dove verrà renderizzato il Widget
Dovrà essere inserito nella pagina web nella posizione in cui si vuole visualizzare il widget. Richiede i seguenti parametri:
  • data-type="product"

    *Parametro obbligatorio - Determina il tipo di Widget, nell'esempio un widget di tipo Prodotto, valori accettati:

    • merchant
    • product
    • carousel
    • carouselproduct
    • product_tab

  • data-variant="Striscia-full-altwrap"

    *Parametro obbligatorio - indica la variante grafica del widget

    • Elenco data-variant del type “merchant”:

      data-type="merchant"
      • 300x100 Merchant

        300x100-1

        300x100-2

        300x100-3

        300x100-4

        300x100-5

        300x100-6

      • 300x200 Merchant

        300x200-1

        300x200-2

        300x200-3

        300x200-4

        300x200-5

        300x200-6

      • 150x100 Merchant

        150x100-1

        150x100-2

        150x100-3

        150x100-4

        150x100-5

        150x100-6

      • 200x150 Merchant

        200x150-1

        200x150-2

        200x150-3

        200x150-4

      • Striscia Merchant

        Striscia-1

        Striscia-2

        Striscia-3

      • Striscia Merchant Responsive

        Striscia-1wrap

        Striscia-2wrap

        Striscia-3wrap

      • Sticky

        Sticky-1

        Sticky-3

        Sticky-4

    • Elenco data-variant del type “product”:

      data-type="product"
      • Prodotto Striscia

        Striscia-full-alt

        Striscia-full-alt-black

        Striscia-full-alt-nologo

        Striscia-full

        Striscia-full-nologo

        Striscia-full-black

        Striscia-slim

        Striscia-slim-blk

      • Prodotto Striscia versione responsive:

        Striscia-full-altwrap

        Striscia-full-alt-blackwrap

        Striscia-full-alt-nologowrap

        Striscia-fullwrap

        Striscia-full-nologowrap

    • Elenco data-variant del type “carousel”:

      data-type="carousel"
      • Carosello Merchant versione responsive

        carosello-1

        View 1170x217

        View 860x217

        View 582x217

        View 400x400

        carosello-2

        View 1170x217

        View 860x217

        View 582x217

        View 400x400

      • Carosello merchant versione mobile

        carosello-3

    • Elenco data-variant del type “carouselproduct”:

      data-type="carouselproduct"
      • Carosello prodotti versione responsive

        recensioni-carosello-1

        View 896x180

        View 750x180

        View 530x180

        View 400x400

        recensioni-carosello-2

        View 896x180

        View 750x180

        View 530x180

        View 400x400

        Carosello prodotti versione non responsive

        recensioni-carosello-3

        recensioni-carosello-4

    • Elenco data-variant del type “product_tab”:

      data-type="product_tab"
      • Tab prodotto

        Recensioni-Verticale-30-70

        Dimensioni reali 980x900

        Recensioni-Verticale-40-60

        Dimensioni reali 980x900

        Recensioni-Verticale-Alternative

        Dimensioni reali 980x900

        Recensioni-Verticale-Mobile

        Dimensioni reali 375x1047



  • data-id="selettore1"

    *Parametro obbligatorio - Indica l'id UNIVOCO del widget (formato stringa)

    • Importanza: Questo parametro è fondamentale per identificare in modo univoco il widget all'interno della pagina e per evitare conflitti quando sono presenti più widget.
    • Avvertenza: Non utilizzare valori randomici per data-id. Assegnare un ID randomico può causare malfunzionamenti e comportare un sovraccarico dei nostri sistemi. Assicurati che ogni data-id sia stabile e deterministico per evitare problemi di integrazione e prestazioni.


  • data-gui="all"

    *Parametro obbligatorio - Determina la lingua della User Interface del widget, parametri disponibili:
    • null
      • in questo caso viene utilizzata la lingua di default dell'account del merchant Feedaty
    • it-IT
    • en-US
    • es-ES
    • fr-FR
    • de-DE

  • data-lang="all"

    Parametro obbligatorio - Determina la lingua delle review, dei rating e dei count sui dati del widget - Paramentri disponibili:

    • all
    • it-IT
    • en-US
    • es-ES
    • fr-FR
    • de-DE

  • data-sku="prod1"

    * Parametro obbligatorio solo in caso di widgetprodotto o carosello prodotti- Determina Il ProductID o sku del prodotto legato ai Widget prodotto e carosello prodotti.
    Verifica con il tuo referente IT o con lil tuo Account Manager di Feedaty qual è il codice prodotto da utilizzare.


  • Widget merchant

    data-snippets="1"

    Parametro opzionale, disponibile solo in caso di widget prodotto di tipo product_tab e di tipo carouselproduct - determina la presenza o meno dei microdati dello schema AggregateRating nel template del tipo widget product_tab
    Parametri disponibili:

    • 0

      Nessuno schema microdati nel widget

    • 1

      Schema microdati Aggregate Rating Lo Schema.org avg rating da inserire all'interno di uno schema microdati product gia presente nella pagina

    • 2

      Schema microdati Product completo. Lo Schema.org in formato microdati product completo

    • 4

      Schema.org json/ld Product completo. Schema.org tipo product con Aggregate Rating

    Widget prodotto

    data-snippets="1"

    Parametro opzionale, disponibile solo in caso di widget prodotto di tipo product_tab e di tipo carouselproduct - determina la presenza o meno dei microdati dello schema AggregateRating nel template del tipo widget product_tab
    Parametri disponibili:

    • 0

      Nessuno schema microdati nel widget

    • 1

      Schema microdati Aggregate Rating Lo Schema.org avg rating da inserire all'interno di uno schema microdati product gia presente nella pagina

    • 2

      Schema microdati Product completo. Lo Schema.org in formato microdati product completo

    • 4

      Schema.org json/ld Product completo. Schema.org tipo product con Aggregate Rating



Esempi completi

Esempio completo di widget Merchant Carosello con merchant code "10203010"

<div class="feedaty_widget" data-type="carousel" data-variant="carosello-1" data-id="selettore1" data-gui="all" data-lang="all" ></div>

<script async type="text/javascript" src="https://widget.feedaty.com/v3.0.0/js/2021/MERCHANTCODE/feedaty.min.js"></script>


Esempio completo di widget prodotto con merchant code "10203010" e ProductID/sku "prod1"

<div class="feedaty_widget" data-type="product" data-variant="Striscia-full-altwrap" data-id="selettore2" data-gui="all" data-lang="all" data-sku="prod1" ></div>

<script async type="text/javascript" src="https://widget.feedaty.com/v3.0.0/js/2021/MERCHANTCODE/feedaty.min.js"></script>


Esempio completo di widget merchant con merchant code "10203010" e sede/location "codice_11" con microdati attivi

<div class="feedaty_widget" data-type="merchant" data-variant="150x100-1" data-id="selettore3" data-gui="all" data-lang="all" data-snippets="1" data-location="codice_11" ></div>

<script async type="text/javascript" src="https://widget.feedaty.com/v3.0.0/js/2021/MERCHANTCODE/feedaty.min.js"></script>




Widget multipli in una singola pagina

È possibile inserire più di un widget all’interno di una pagina del proprio sito web. Per includere widget multipli nella pagina è necessario seguire le istruzioni sopra indicate, facendo attenzione a NON includere più volte la risorsa Javascript.

ATTENZIONE:

Includere più volte la risorsa Javascript in una singola pagina equivale a effettuare tante chiamate quanto il numero di inclusioni della stessa. Questo comporterà un rallentamento del caricamento della pagina web che la ospita e un numero maggiore di chiamate verso i server Feedaty.