Tämä artikkeli on saatavana myös seuraavilla kielillä:

Widgetin upottaminen parametrien kanssa

Pikaohje monisijainti-widgetin käyttöön


  1. Aseta yksilölliset lyhytnimet arvostelulähteillesi (Review Connections). Käytä lyhyttä mutta kuvaavaa nimeä.
  2. Lisää segmenttiparametri "m" widgetin upotuskoodiin ID-merkkijonon perään. Käytä samaa arvoa, jonka asetit edellä.
  3. Upota widget parametrin kanssa, jolloin se näyttää vain määritetyn segmentin arvostelut.



Monisijainti-widget


Kun widget upotetaan verkkosivulle, sille voi antaa lisäparametreja, jotka muuttavat widgetin ulkoasua ja sisältöä. Näin samaa widgetiä voi käyttää uudelleen eri arvostelujoukon ja eri otsikon näyttämiseen.


Widgetin uudelleenkäyttö vähentää manuaalista työtä, kun widgetejä upotetaan useille sivuille eri tuotteiden tai sijaintien arvostelujen näyttämiseksi. Myös uudet arvostelut päivittyvät widgetteihin automaattisesti niille annettujen parametrien mukaisesti.


Suodatinparametrit lisätään yksinkertaisesti widgetin ID:n perään skriptiupotuksen URL-osoitteessa tai data-trustmary-widget -attribuutissa, jos käytät vaihtoehtoista <div>-upotustapaa. Katso esimerkit alta.


Parametrien arvot on koodattava (URL-enkoodaus), jos ne sisältävät erikoismerkkejä.


Vaiheittainen ohje ei-koodareille


Onko sinulla yli kymmenkunta arvostelulähdettä tai sijaintia? Kannattaa harkita API:n käyttöä arvostelulähteiden hallintaan, jolloin prosessin voi automatisoida.


  1. Lisää arvostelulähteet (Google, Booking.com, TripAdvisor jne.) Arvostelulähteet -sivulla.



  1. Etsi lähteen Lisäasetukset ja avaa se nuolesta. Anna jokaiselle arvostelulähteelle yksilöllinen nimi Lyhytnimi -kenttään.



  1. Luo widget (tai avaa olemassa oleva).



  1. Klikkaa widget-editorissa Lisää verkkosivuille -painiketta ja kopioi upotuskoodi. Lisää koodiin widgetin ID:n perään ?connection=[lyhytnimi].



Tässä esimerkissä lyhytnimet ovat mono-sushi ja nanapo-sushi, joten koodit näyttäisivät tältä:


<script src="https://widget.trustmary.com/Uh_MrCSI1?connection=mono-sushi"></script>

<script src="https://widget.trustmary.com/Uh_MrCSI1?connection=nanapo-sushi"></script>


  1. Avaa verkkosivustosi editori ja liitä koodi lyhytnimen kanssa halutulle sivulle.



Esimerkkitapaus: Sushi Helsinki


Tällä hetkellä Sushi Helsingillä on


  • Kymmeniä sushiravintoloita, joilla kullakin on oma laskeutumissivu
  • Google-arvostelut tuotuna jokaiselle sijainnille ja niille annetut yksilölliset lyhytnimet
  • Yksi widget, joka on lisätty useille laskeutumissivuille ja suodatettu arvostelulähteiden perusteella


Mono-sushi



Nanapo Sushi



Jos widgettien ulkoasua täytyy muuttaa, kaikki muutokset voidaan tehdä yhteen widgetiin Trustmaryssa. Kun muutokset on tallennettu widget-editorissa, kaikki widgetin esiintymät päivittyvät automaattisesti ilman että koodiin tarvitsee koskea.


Widgetin sisällön muuttaminen


Parametreilla voi muuttaa widgetin otsikkoa sekä widgetin Schema.org-rakennedatan tuotenimeä.


Widgetin otsikkokentän muuttaminen


Joidenkin widget-pohjien käyttämän otsikkokentän voi ohittaa title-parametrilla. Skriptiupotuksissa parametri sijoitetaan URL-osoitteen perään:


<script src="https://widget.trustmary.com/<WIDGETIN_ID>?title=Otsikko+tälle+sijainnille"></script>


Vaihtoehtoisesti, jos käytät div-upotustapaa, parametri sijoitetaan data-trustmary-widget-muuttujan perään:


<div data-trustmary-widget="<WIDGETIN_ID>?title=Otsikko+tälle+sijainnille" />


Rakennedatan tuotenimikentän muuttaminen


Jos widgetin mukana on Schema.org-rakennedataa, productName-kenttä kannattaa asettaa vastaamaan widgetin sisältöä. Erityisesti silloin, kun listataan yksittäisen toimipisteen tai tuotteen arvosteluja, productName-kentän tulisi viitata siihen kohteeseen eikä koko yritykseen. Käytä productName-parametria rakennedatan tuotenimen muuttamiseen:


<script src="https://widget.trustmary.com/<WIDGETIN_ID>?productName=tuotteen+nimi"></script>



Arvostelujen suodattaminen parametreilla


Voit myös suodattaa widgetiin tulevia arvosteluja arvostelulähteen, tagien ja mukautettujen sääntöjen (yhteystieto- ja arvostelukentät) perusteella.


Suodatus arvostelulähteen mukaan (jatkoa)


Kuten edellisessä esimerkissä näytettiin, on mahdollista näyttää vain tietystä arvostelulähteestä (Google, Facebook, Tripadvisor jne.) tuodut arvostelut.


Alla muutamia edistyneempiä tapoja suodattaa arvosteluja tällä tavalla.


Alla näet connection-parametrin "perusmuodon". Tämä näyttää vain ne arvostelut, jotka on tuotu arvostelulähteestä, jonka lyhytnimeksi olet antanut "my-connection".


<script src="https://widget.trustmary.com/<WIDGETIN_ID>?connection=my-connection"></script>


Useita arvostelulähteitä voi määrittää pilkulla erotettuna listana:


<script src="https://widget.trustmary.com/<WIDGETIN_ID>?connection=my-connection,connection2,my-other-connection"></script>


Jokerimerkillä voi valita kaikki arvostelulähteet, joiden lyhytnimi vastaa hakuehtoa. Alla olevassa esimerkissä valitaan kaikki arvostelulähteet, joiden lyhytnimi alkaa "helsinki-":


<script src="https://widget.trustmary.com/<WIDGETIN_ID>?connection=helsinki-*"></script>


Jos käytät <div>-upotustapaa, connection-parametri näyttäisi tältä:


<div data-trustmary-widget="<WIDGETIN_ID>?connection=my-connection" />


Suodatus tagien mukaan


Arvosteluja voi näyttää tagin perusteella. Voit antaa tagin (tai pilkulla erotetun listan tageja) joko tagin nimenä tai tagin ID:nä. Seuraavat esimerkit suodattavat tagilla, jonka nimi on "My tag" tai jonka ID on "12345":


<script src="https://widget.trustmary.com/<WIDGETIN_ID>?tag=My+tag"></script>
<script src="https://widget.trustmary.com/<WIDGETIN_ID>?tag=12345"></script>


Mukautetut säännöt (yhteystieto- ja kyselykentät)


Mukautetuilla säännöillä voi suodattaa yhteystieto- tai kyselykenttien perusteella.


Esimerkkejä käyttötapauksista:

  • Sinulla on useita toimipisteitä ja verkkosivustollasi on erillinen alasivu jokaiselle sijainnille. Sijaintia voi käyttää parametrina, jolloin näytetään vain kyseisen sijainnin arvostelut.
  • Haluat näyttää arvostelut vain tietyltä asiakasjoukolta, joka esimerkiksi osti tietyn tuotteen.


Jos haluat esimerkiksi näyttää Helsingin toimipisteen arvostelut ja olet kerännyt kyselyvastaukset niin, että p1-segmentti on asetettu toimipisteen nimeksi, suodatin asetetaan näin:


<script src="https://widget.trustmary.com/<WIDGETIN_ID>?survey.p1=Helsinki"></script>


Käytettävissä olevat kentät kyselyille:

  • survey.source: kyselyn lähde-URL, jonka widget asettaa automaattisesti
  • survey.p1– survey.p20: segmentointiparametrit, jotka on annettu lomakkeen URL-osoitteen kyselyparametreina
  • Jokerimerkeillä voi hakea osittaista osumaa, esim. ?survey.p1=*Helsinki* (osuu, jos "Helsinki" löytyy mistä tahansa kohtaa kenttää survey.p1)


Lue lisää parametrisegmentoinnista täältä.


Voit käyttää myös yhteystiedon mukautettuja kenttiä. Jos olet tallentanut asiakkaan ensisijaisen sijainnin kenttään LOCATION, voit käyttää seuraavia parametreja:


<script src="https://widget.trustmary.com/<WIDGETIN_ID>?contact.field_LOCATION=Helsinki"></script>


Annetut parametrit lisätään niiden sääntöjen päälle, jotka olet mahdollisesti asettanut widget-editorissa. Jos olet esimerkiksi asettanut mukautetun suodattimen näyttämään vain viiden tähden arvostelut, p1-parametrin lisääminen näyttää vain ne viiden tähden arvostelut, joiden p1 on lisäksi annettu arvo.


Käytettävissä olevat kentät yhteystiedoille:

  • contact.field_: yhteystiedon tiedoissa asetettu mukautettu kenttä.
  • Jokerimerkeillä voi hakea osittaista osumaa, esim. ?contact.field_<KENTTÄNIMI>=*Helsinki* (osuu, jos "Helsinki" löytyy mistä tahansa kohtaa kenttää contact.field_<KENTTÄNIMI>)


Lue lisää mukautetuista kentistä täältä.



Segmenttiparametri (m)


Segmenttiparametrilla yhdistät arvostelusijainnit, kyselyt ja widgetit toisiinsa. Tyypillinen käyttötapaus on yksinkertaistaa yhden sijainnin kyselyvastausten keräämistä ja näyttämistä, kun tilillä on useita sijainteja.


  • Arvostelulähteille tulisi asettaa sijaintia kuvaava lyhytnimi, esim. london, helsinki
  • Kyselyt voivat käyttää m-parametria merkitäkseen vastaukset kyseiselle segmentille.
  • Kyselyt voivat näyttää ja ohjata vain siihen arvostelulähteeseen, jolla on vastaava lyhytnimi: lopullinen kiitos-sivu näyttää vain sen arvostelulähteen, joka vastaa m-arvoa
  • Widgetin m-parametrissa tulisi käyttää samaa arvoa kuin lyhytnimessä: <script src="https://widget.trustmary.com/L4c5B3zYT?m=london"></script> (näyttää kaikki arvostelut siitä arvostelulähteestä, jolla on vastaava lyhytnimi, JA kaikki kyselyvastaukset, joilla on vastaava segmenttiarvo)
  • Kyselykutsuja lähetettäessä yhteystietolistan voi tuoda niin, että jokaisella yhteystiedolla on segmenttiarvo. Kutsusähköposteissa on tällöin m-parametri mukana kyselyn URL-osoitteessa.
  • Segmentit voi antaa pilkulla erotettuna listana, jolloin näytetään arvostelut mistä tahansa niistä: <script src="https://widget.trustmary.com/L4c5B3zYT?m=london,helsinki"></script>


Korostettu segmentti (h)


h-parametrilla vältät tyhjät ja lähes tyhjät widgetit. Widget näyttää ensin kaikki h-segmenttiin osuvat arvostelut ja täyttää loput muilla arvosteluilla. Sen voi yhdistää myös muihin suodattimiin.


  • Näytä ensin segmentti london ja täytä loput millä tahansa muulla segmentillä: <script src="https://widget.trustmary.com/L4c5B3zYT?h=london"></script>
  • Näytä ensin segmentti london ja täytä loput uk-segmentillä: <script src="https://widget.trustmary.com/L4c5B3zYT?h=london&m=uk"></script>
  • Segmentit voi antaa pilkulla erotettuna listana, jolloin korostetaan arvostelut mistä tahansa niistä: <script src="https://widget.trustmary.com/L4c5B3zYT?h=london,helsinki"></script>

Päivitetty: 01/09/2026

Oliko tämä artikkeli hyödyllinen?

Jaa palautteesi

Peruuttaa

Kiitos!