Kiyoh Review Invite GTM tag template

De Kiyoh Review Invite-template verstuurt review-uitnodigingen naar klanten rechtstreeks vanuit GTM, door bij de orderbevestiging de Kiyoh-API aan te roepen. Dat gebeurt via de sendPixel-methode van GTM, met een GET-request waarin de klant- en ordergegevens meegaan.

• Verstuurt uitnodigingen via de API van Kiyoh en Klantenvertellen, zonder eigen code
• Ondersteunt beide platformen: Kiyoh internationaal en Klantenvertellen in Nederland
• Instelbare vertraging in dagen, zodat de mail ná de bezorging aankomt
• Vier talen: Nederlands, Engels, Duits en Frans
• Vuurt af als lichte pixel, zonder scripts te injecteren
• Koppelt rechtstreeks aan Data Layer-variabelen voor klant- en ordergegevens

De template bouwt dit GET-request op:

https://www.kiyoh.com/v1/invite/external
  ?hash={hash}&location_id={locationId}&tenantId={tenantId}
  &email={email}&first_name={firstName}&last_name={lastName}
  &ref_code={orderId}&delay={delay}&language={language}

De tenantId wordt automatisch gezet op basis van je platformkeuze: 98 voor Kiyoh, 99 voor Klantenvertellen.

• Ga in je Kiyoh- of Klantenvertellen-dashboard naar de API-instellingen en noteer je API Hash en Location ID.
• Maak een nieuwe tag in GTM met de Kiyoh Review Invite-template.
• Vul je API Hash en Location ID in, en kies het juiste platform.
• Koppel Customer Email aan een Data Layer-variabele met het e-mailadres van de koper op de bevestigingspagina.
• Koppel eventueel First Name, Last Name en Order ID aan hun variabelen.
• Stel de vertraging in. Drie tot zeven dagen is gebruikelijk, zodat de klant zijn bestelling heeft ontvangen voordat je ernaar vraagt.
• Zet de taal op die van je klant.

Laat de tag afgaan op de orderbevestigingspagina, via een Custom Event-trigger op je purchase-event of via een Page View-trigger met een URL-conditie zoals /order-confirmation of /checkout/bedankt.

dataLayer.push({
  event: 'purchase',
  customerEmail: '{{ customer.email }}',
  customerFirstName: '{{ customer.first_name }}',
  customerLastName: '{{ customer.last_name }}',
  orderId: '{{ order.name }}'
});

Consent. Deze tag stuurt het e-mailadres van een klant naar een externe API, dus koppel hem aan je consent-instellingen.

Deduplicatie. Geef het order-ID mee. Kiyoh gebruikt die referentiecode om unieke uitnodigingen te herkennen.

Er komt geen uitnodiging. Controleer of de API Hash klopt en actief is, of Customer Email in Preview een geldig adres teruggeeft, en of de tag in de lijst met afgevuurde tags staat. Staat er een vertraging ingesteld, wacht die dan af. In het Kiyoh-dashboard zie je in de logs of het verzoek is binnengekomen.

Verkeerd platform. Kiyoh en Klantenvertellen gebruiken verschillende tenant-ID's, en de verkeerde wordt geweigerd. Kiyoh is 98, Klantenvertellen is 99.

Verkeerde taal. Controleer het taalveld. Laat je het leeg, dan valt de API terug op de standaardtaal in je account.

Tag gaat af maar de API geeft een fout. sendPixel laat de respons niet zien, dus herhaal het verzoek in je adresbalk of in Postman om te zien wat er terugkomt. Een verkeerd Location ID geeft een autorisatiefout.

Dubbele uitnodigingen. Zonder order-ID kan Kiyoh niet dedupliceren. Gaat de tag vaker af, bijvoorbeeld bij herladen, voeg dan een triggerconditie of cookie toe zodat hij één keer per order afgaat.

• Kiyoh: https://www.kiyoh.com
• Klantenvertellen: https://www.klantenvertellen.nl
• Kiyoh API-documentatie: in je dashboard onder de API-instellingen
• Kiyoh-support: https://www.kiyoh.com/contact