Artikkelit aiheesta: Widgetit

Widgetin upottaminen parametrien kanssa

Pikaohjeet widgetin upotuskoodin parametrointiin


  1. Aseta yksilölliset lyhytnimet arvostelulähteillesi (Review Connections). Käytä lyhyttä mutta kuvaavaa nimeä.
  2. Lisää segmenttiparametri "m" widgetisi upotuskoodiin ID-merkkijonon jälkeen. Käytä aiemmin asettamaasi arvoa.
  3. Upota widget lisätyllä parametrilla, jolloin sen pitäisi näyttää arvostelut vain määritetystä segmentistä.



Sama widget useammalle eri sijainnille


Kun widget upotetaan verkkosivulle, sille on mahdollista antaa lisäparametreja, jotka muuttavat widgetin ulkoasua ja sisältöä. Tämä mahdollistaa saman widgetin uudelleenkäytön niin, että se näyttää eri arvostelujoukon eri otsikolla.


Widgetin uudelleenkäyttö vähentää manuaalista työtä, kun widgettejä upotetaan useille sivuille eri tuotteiden tai sijaintien arvostelujen näyttämiseksi.


Suodatinparametrit lisätään yksinkertaisesti widgetin ID:n perään joko script-upotuksen URL-osoitteeseen tai <div>-upotuksen data-trustmary-widget-attribuuttiin. Katso esimerkit alta.


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


Vaiheittaiset ohjeet ei-koodaajille


Onko sinulla yli tusina arvostelulähdettä tai sijaintia? Kannattaa harkita API:mme käyttöä arvostelulähteiden hallintaan prosessin automatisoimiseksi.


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


  1. Etsi yhteytesi Advanced settings (Lisäasetukset) ja avaa se nuolta klikkaamalla. Anna jokaiselle arvostelulähteelle yksilöllinen nimi Short name (Lyhytnimi) -kentässä.


  1. Luo widget (tai avaa olemassa oleva).


  1. Klikkaa widget-editorissa Add to website (Lisää verkkosivulle) -painiketta ja kopioi upotuskoodi. Lisää ?connection=[lyhytnimi] koodiin widgetin ID:n jälkeen.


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 lisätyllä lyhytnimellä sivulle.



Esimerkkitapaus: Sushi Helsinki


Tällä hetkellä Sushi Helsingillä on


  • Kymmeniä sushiravintoloita, joilla on omat laskeutumissivut
  • Tuodut Google-arvostelut jokaiselle sijainnille, joille on annettu yksilölliset lyhytnimet
  • Yksi widget lisättynä useille laskeutumissivuille ja suodatettuna arvostelulähteillä


Mono-sushi



Nanapo Sushi



Jos sivuston omistaja haluaa päivittää widgettien ulkoasua, hänen tarvitsee muokata vain yhtä widgettiä Trustmaryssa. Kun muutokset tallennetaan widget-editorissa, kaikki kymmenet widgetit päivittyvät automaattisesti ilman että koodiin tarvitsee koskea uudelleen.


Widgetin sisällön muuttaminen


Widgetin otsikkoa ja tuotteen nimeä widgetin Schema.org-strukturoidussa datassa on mahdollista muuttaa parametrien avulla.


Muuta widgetin otsikkokenttää


Joidenkin widget-mallien käyttämä otsikkokenttä voidaan korvata title-parametrilla. Script-upotuksissa parametri sijoitetaan URL-osoitteen perään:


<script src="https://widget.trustmary.com/<YOUR_WIDGET_ID>?title=A+title+for+this+location"></script>


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


<div data-trustmary-widget="<YOUR_WIDGET_ID>?title=A+title+for+this+location" />


Muuta tuotteen nimikenttää strukturoidussa datassa


Jos widgetin mukana on Schema.org-strukturoitua dataa, voi olla hyödyllistä asettaa productName-kenttä vastaamaan widgetin sisältöä. Erityisesti, kun listataan arvosteluja yhdelle liiketoimintasijainnille tai tuotteelle, productName-kentän tulisi viitata kyseiseen kohteeseen koko yrityksen sijaan. Käytä productName-parametria muuttaaksesi tuotteen nimen strukturoidussa datassa:


Arvostelujen suodattaminen parametreilla


Voit myös suodattaa widgettiin tulevia arvosteluja arvostelulähteen, tunnisteiden (tags) ja mukautettujen sääntöjen (yhteystieto- ja arvostelukentät) mukaan.


Suodatus arvostelulähteen mukaan (jatkoa)


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


Tässä joitakin edistyneempiä keinoja arvostelujen suodattamiseen 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/<YOUR_WIDGET_ID>?connection=my-connection"></script>


Useita lähteitä voidaan määrittää pilkulla erotettuna listana:


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


Jokerimerkkiä (wildcard) voidaan käyttää kaikkien lyhytnimeltään täsmäävien lähteiden valitsemiseen. Alla olevassa esimerkissä valitaan kaikki arvostelulähteet, joiden lyhytnimi alkaa merkeillä "helsinki-":


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


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


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


Suodatus tunnisteiden (tags) mukaan


Arvosteluja on mahdollista näyttää tunnisteen mukaan. Voit antaa tunnisteen (tai pilkulla erotetun listan tunnisteita) joko tunnisteen nimenä tai tunnisteen ID:nä. Seuraavat esimerkit suodattavat tunnisteen nimellä "My tag" tai ID:llä "12345":


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


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


Mukautetuilla säännöillä voidaan suodattaa yhteystieto- tai kyselykenttien mukaan.


Esimerkkejä käyttötapauksista:

  • Sinulla on useita liiketoimintasijainteja ja verkkosivustollasi on erilliset alasivut kullekin sijainnille. Sijaintia voidaan käyttää parametrina, jotta näytetään vain kyseisen sijainnin arvostelut.
  • Haluat näyttää arvostelut asiakasjoukolta, joka esim. osti tietyn tuotteen.


Esimerkiksi, jos haluat näyttää Helsingin sijaintisi arvostelut ja olet kerännyt kyselyvastaukset niin, että p1-segmentti on asetettu sijainnin nimeksi, suodatin voidaan asettaa alla olevalla tavalla:


<script src="https://widget.trustmary.com/<YOUR_WIDGET_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-kyselyparametreina
  • Jokerimerkkejä voidaan käyttää kentän osittaiseen täsmäytykseen, esim. ?survey.p1=*Helsinki* (täsmää, jos "Helsinki" löytyy mistä tahansa kohdasta kentässä survey.p1)


Lue lisää parametreilla tehtävästä segmentoinnista 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/<YOUR_WIDGET_ID>?contact.field_LOCATION=Helsinki"></script>


Annetut parametrit lisätään sääntöihin, jotka olet mahdollisesti asettanut widget-editorissa. Esim. jos olet asettanut mukautetun suodattimen näyttämään vain viiden tähden arvostelut, p1:n lisääminen parametrina näyttää vain ne viiden tähden arvostelut, joissa myös p1 on asetettu annettuun arvoon.


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

  • contact.field_: mukautettu kenttä, kuten se on asetettu yhteystiedon tiedoissa.
  • Jokerimerkkejä voidaan käyttää kentän osittaiseen täsmäytykseen, esim. ?contact.field_<FIELDNAME>=*Helsinki* (täsmää, jos "Helsinki" löytyy mistä tahansa kohdasta kentässä contact.field_<FIELDNAME>)


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



Segmenttiparametri (m)


Käytä segmenttiparametria yhdistääksesi arvostelusijainnit, kyselyt ja widgetit toisiinsa. Todennäköinen käyttötapaus tälle olisi yksinkertaistaa kyselyvastausten keräämistä ja näyttämistä sijainnille, kun tilillä on useita sijainteja.


  • Arvostelulähteillä tulisi olla lyhytnimi, joka edustaa sijaintia, 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 täsmäävä lyhytnimi: lopullinen Kiitos-sivu näyttää vain sen arvostelulähteen, joka täsmää m:n kanssa.
  • Widget-parametria m tulisi käyttää samalla arvolla kuin lyhytnimeä: <script src="https://widget.trustmary.com/L4c5B3zYT?m=london"></script> (näyttää kaikki arvostelut siitä arvostelulähteestä, jolla on täsmäävä lyhytnimi, SEKÄ kaikki kyselyvastaukset, joilla on täsmäävä segmenttiarvo)
  • Kun lähetetään kyselykutsuja, yhteystietojen lista voidaan tuoda segmenttiarvon kanssa jokaiselle yhteystiedolle. Kutsusähköposteissa on tällöin m-parametri mukana kyselyn URL-osoitteessa.
  • On mahdollista antaa pilkulla erotettu lista segmenteistä, jolloin näytetään arvostelut mistä tahansa niistä: <script src="https://widget.trustmary.com/L4c5B3zYT?m=london,helsinki"></script>


Korostussegmentti (h)



Voit välttää tyhät tai lähes tyhjät widgetit h-parametrilla. Widget näyttää ensin kaikki h-segmenttiin täsmäävät arvostelut ja täyttää loput muilla arvosteluilla. Tätä on mahdollista yhdistää myös muihin suodattimiin.


  • Näyttääksesi ensin segmentin london ja täyttääksesi loput millä tahansa muulla segmentillä: <script src="https://widget.trustmary.com/L4c5B3zYT?h=london"></script>
  • Näyttääksesi ensin segmentin london ja täyttääksesi loput uk-segmentillä: <script src="https://widget.trustmary.com/L4c5B3zYT?h=london&m=uk"></script>
  • On mahdollista antaa pilkulla erotettu lista segmenteistä, jolloin korostetaan arvostelut mistä tahansa niistä: <script src="https://widget.trustmary.com/L4c5B3zYT?h=london,helsinki"></script>

Päivitetty: 02/07/2026

Oliko tämä artikkeli hyödyllinen?

Jaa palautteesi

Peruuttaa

Kiitos!