Voeg een gestructureerde data snippet toe aan de AFS

Deze functie is onderdeel van het Free-pakket.

De AFS (Automatic Feedback Service) is een handige tool, maar voor optimale uitnodigingen en nog meer functionaliteit voeg je een gestructureerde data snippet toe. Dit voeg je ook toe als je de AFS wilt gebruiken maar geen BCC-veld hebt.

Wat is een gestructureerde data snippet?

Gestructureerde data zijn gegevens in een standaard indeling. Hiermee wordt informatie over een pagina verstrekt en kan de inhoud ervan worden geclassificeerd.

Door een gestructureerde data snippet toe te voegen aan de code van je trigger-e-mails, kan Trustpilot de gestructureerde data lezen en dynamisch de relevante informatie ophalen en opnemen in je review-uitnodigingen.

Waar voeg ik het toe?

Neem de gestructureerde data snippet op in de broncode van de AFS-triggerende transactionele e-mail.

Belangrijk: Implementeer dit fragment met de door jouw specifieke platform gebruikte dynamische tijdelijke placeholders. Bekijk welke placeholders jouw systeem gebruikt en vervang de voorbeelden met de betreffende informatie.

Om de snippet correct te laden, moet de indeling ongewijzigd blijven — alle komma's, dubbele punten en aanhalingstekens zijn vereist.

Welke gestructureerde data snippets kan ik gebruiken voor de AFS?

Je kunt, naargelang je behoeften, kiezen welke informatie je opneemt in gestructureerde data snippets. Hieronder vind je codevoorbeelden voor de verschillende snippets. Vervang tijdelijke placeholders en voorbeelden (hieronder vetgedrukt aangegeven) met de relevante tijdelijke placeholders van jouw systeem en voorkeursinstellingen.

Opmerking: Je hebt wellicht een developer nodig om je te helpen met de implementatie.

Klantnaam en referentienummer

De AFS haalt standaard automatisch namen en referentie-ID's uit het e-mailonderwerp, om uitnodigingen te personaliseren als ze niet aanwezig zijn in de gestructureerde data. Klantnamen worden uit het 'Aan:'-veld gehaald, en het referentienummer wordt uit het e-mailonderwerp gehaald. Indien nodig kun je nog steeds gebruikmaken van gestructureerde data.

Voorbeeld: 

<script type="application/json+trustpilot">
    {
        "recipientName": "dynamische placeholder",
        "recipientEmail": "dynamische placeholder",
        "referenceId": "dynamische placeholder"
    }
</script>

E-mailadres klant

Als je het e-mailadres van de klant in de gestructureerde data snippet opneemt, heeft dit altijd voorrang op het e-mailadres in het veld 'Aan:'. Je kunt de trigger-e-mail rechtstreeks naar je unieke Trustpilot-e-mailadres sturen als je deze niet aan het BCC-veld kunt toevoegen.

Voorbeeld:

<script type="application/json+trustpilot">
    {
        "recipientName": "dynamische placeholder",
        "referenceId": "dynamische placeholder",
        "recipientEmail": "dynamische placeholder"
    }
</script>

Template

Als je gebruikmaakt van verschillende uitnodigings-templates voor verschillende doeleinden of doelgroepen, kun je aangeven welke je wilt gebruiken door een template-ID (templateId) op te nemen. Je vindt de template-ID in de template-editor.

Voorbeeld:

<script type="application/json+trustpilot">
    {
        "recipientName": "dynamische placeholder",
        "recipientEmail": "dynamische placeholder",
        "referenceId": "dynamische placeholder",
        "templateId": "voeg je template-ID in"
    }
</script>

Locaties

Voeg een locatie-ID toe als je meerdere bedrijfslocaties hebt en je naar een specifieke locatiepagina wilt verwijzen.

Voorbeeld: 

<script type="application/json+trustpilot">
    {
      "recipientName": "dynamische placeholder",
      "recipientEmail": "dynamische placeholder",
      "referenceId": "dynamische placeholder",
      "locationId": "voeg je locatie-ID in"
    }
</script>

Landingspagina's in verschillende talen

Je kunt ook aangeven naar welke landingspagina je klanten moeten worden gestuurd door een landinstelling toe te voegen.

Voorbeeld:

<script type="application/json+trustpilot">
    {
        "recipientName": "dynamische placeholder",
        "recipientEmail": "dynamische placeholder",
        "referenceId": "dynamische placeholder",
        "locale": "voeg je landinstelling in"
      }
</script>

De beschikbare landinstellingen zijn:

"locale": "da-DK" / Deens-Denemarken

"locale": "de-DE" / Duits-Duitsland

"locale": "en-GB" / Engels-Verenigd Koninkrijk

"locale": "es-ES" / Spaans-Spanje

"locale": "fi-FI" / Fins-Finland

"locale": "fr-FR" / Frans-Frankrijk

"locale": "it-IT" / Italiaans-Italië

"locale": "nb-NO" / Noors-Noorwegen

"locale": "nl-NL" / Nederlands-Nederland

"locale": "pl-PL" / Pools-Polen

"locale": "pt-PT" / Portugees-Portugal

"locale": "ru-RU" / Russisch-Rusland

"locale": "sv-SE" / Zweeds-Zweden

"locale": "en-AU"/ Engels-Australië

"locale": "en-IE" / Engels-Ierland

"locale": "de-AT" / Duits-Oostenrijk

"locale": "de-CH" / Duits-Zwitserland

"locale": "fr-BE" / Frans-België

"locale": "nl-BE" / Nederlands-België

"locale": "ja-JP" / Japans-Japan

"locale": "pt-BR" / Braziliaans Portugees-Brazilië

"locale": "en-US" / Engels-Verenigde Staten

"locale": "en-CA" / Engels-Canada

"locale": "en-NZ" / Engels-Nieuw-Zeeland

Uitnodigingen naar klanten in verschillende landen

Om klanten uit verschillende landen uit te nodigen, stel je de landingspagina in en geef je een template-ID op. Je kunt kiezen tussen onze geoptimaliseerde template en je zelfgemaakte template. Zorg ervoor dat de taal van de landingspagina en de template met elkaar overeenkomen.

Voorbeeld:

<script type="application/json+trustpilot">
      {
        "recipientName": "dynamische placeholder",
        "recipientEmail": "dynamische placeholder",
        "referenceId": "dynamische placeholder",
        "locale": "voeg je landinstelling in",
        "templateId": "voeg je template-ID in"
    }
</script>

Taggen

Automatiseer het taggen van reviews door de tags op te nemen die je op een review wilt toepassen nadat deze is ingediend. Je mag zoveel tags gebruiken als je wilt, maar houd er rekening mee dat je uitnodigingen niet worden verzonden als je tags spaties bevatten.

Voorbeeld: 

<script type="application/json+trustpilot">
    {
       "recipientName": "dynamische placeholder",
       "recipientEmail": "dynamische placeholder",
       "referenceId": "dynamische placeholder",
       "tags": ["Amsterdam","Sales"]
    }
</script>

Opmerking: Amsterdam en Sales zijn voorbeeldtags. Vervang ze met de tags die je wilt opnemen.

Productreviews

Verzamel productreviews effectief door productgegevens op te nemen in je review-uitnodigingen. De eenvoudigste manier om dit te doen is om je productcatalogus te uploaden naar Trustpilot, en vervolgens de product-SKU voor elk gekocht product toe te voegen. Om ervoor te zorgen dat de SKU's goed worden geladen, is het belangrijk dat je de catalogus uploadt voordat je de gestructureerde gegevenssnippet gebruikt.

Voorbeeld:

<script type="application/json+trustpilot">
   { 
      "recipientName": "dynamische placeholder", 
      "recipientEmail": "dynamische placeholder", 
      "referenceId": "dynamische placeholder", 
      "productSkus": ["ABC-1234","ABC-4321"]
   }
</script>

Opmerking: ABC-1234 en ABC-4321 zijn voorbeeld-SKU's. Vervang ze met je eigen SKU's.

In plaats daarvan kun je ook alle transactie- en productgegevens toevoegen aan de gestructureerde data snippet. Dit omvat onder meer een URL, een productafbeelding, de productnaam en de SKU.

Als het veld 'productCategoryGoogleId' is opgenomen, wordt de productcategorie automatisch bijgewerkt in de productcatalogus.

Opmerking: De velden 'productURL', 'naam' en 'SKU' zijn verplicht.

Voorbeeld:

<script type="application/json+trustpilot">
   {
        "recipientName": "dynamische placeholder",
        "recipientEmail": "dynamische placeholder",
        "referenceId": "dynamische placeholder",
        "productReviewInvitationPreferredSendTime": "2018-12-25T13:00:00",
        "productReviewInvitationTemplateId": "voeg je productreview template-ID in",
        "products": [
      {
        "productUrl": "http://www.bedrijf.nl/.../12345.htm",
        "imageUrl": "http://www.bedrijf.nl/.../.../12345.jpg",
        "name": "Metalen speelgoedauto",
        "sku": "ABC-1234",
        "gtin": "1234567890",
        "mpn": "7TX1641",
        "brand": "Acme",
        "productCategoryGoogleId": "1253"
      },
      {
        "productUrl": "http://www.bedrijf.nl/.../4321.htm",
        "imageUrl":"http://www.bedrijf.nl/.../.../4321.jpg",
        "name": "Garage voor metalen speelgoedauto's",
        "sku": "CBA-4321",
        "gtin": "9876543210",
        "mpn": "5TX1649",
        "brand": "Acme",
        "productCategoryGoogleId": "1253"
      }
     ]
    }
</script>

Opmerking: alle vetgedrukte tekst zijn voorbeelden van tijdelijke placeholders. Vervang ze met jouw informatie.

Tijdstip van verzenden

Als je een datum en tijd wilt instellen voor het verzenden van uitnodigingen, kun je de gewenste verzendtijd ('preferredSendTime') toevoegen. Alle tijden zijn in UTC.

Opmerking: Deze functie is alleen beschikbaar voor gebruikers met de Enhance-add-on.

Voorbeeld:

<script type="application/json+trustpilot">
    {
        "recipientName": "dynamische placeholder",
        "recipientEmail": "dynamische placeholder",
        "referenceId": "dynamische placeholder",
        "preferredSendTime": "2018-12-15T13:37:00"
    }
</script>

Opmerking: De vermelde tijd is slechts een voorbeeld. Vervang het met je eigen gewenste verzendtijd.

Volledig gestructureerde data snippet

Als je de volledige code gebruikt, ziet het er ongeveer zo uit:

<script type="application/json+trustpilot">
    {
      "recipientEmail": "dynamische placeholder",
      "recipientName": "dynamische placeholder",
      "referenceId": "dynamische placeholder",
      "templateId": "voeg je template-ID in",
      "productReviewInvitationTemplateId": "voeg je productreview template-ID in",
      "locale": "voeg je landinstelling in",
      "senderEmail": "jouw@verzendemail.nl",
      "senderName": "Naam afzender",
      "replyTo": "jouw@antwoordemail.nl",
      "preferredSendTime": "2018-12-15T13:30:00",
      "productReviewInvitationPreferredSendTime": "2018-12-25T13:00:00",
      "tags": ["Tag1","Tag2"],
      "products": [
        {
          "productUrl": "http://www.bedrijf.nl/producten/12345.htm",
          "imageUrl": "http://www.bedrijf.nl/producten/afbeeldingen/12345.jpg",
          "name": "Metalen speelgoedauto",
          "sku": "ABC-1234",
          "gtin": "01234567890",
          "mpn": "7TX1641",
          "brand": "Acme",
          "productCategoryGoogleId": "1253"
        }
      ]
    }
</script>

Let op! Alle vetgedrukte tekst zijn voorbeelden van tijdelijke placeholders. Vervang ze met je eigen informatie.

Ondersteunen alle systemen gestructureerde data?

De meeste wel, maar sommige e-commerce-platforms staan wellicht niet toe dat de gestructureerde data snippet in de broncode wordt opgenomen. Een mogelijke oplossing voor dit probleem is om de gestructureerde data snippet in te sluiten met HTML-comments, zoals weergegeven in de onderstaande code.

Voorbeeld:

<!-- <script type="application/json+trustpilot">
    {
        "recipientName": "dynamische placeholder",
        "recipientEmail": "dynamische placeholder",
        "referenceId": "dynamische placeholder",
        "templateId": "voeg je template-ID in"
    }
</script> -->

Vorige Voeg een klantnaam en referentienummer toe aan AFS-uitnodigingen

Volgende: AFS - FAQ

Related articles