Hvis du vil oprette en brugerdefineret TrustBox-widget til at vise dine Trustpilot-anmeldelser og -bedømmelser på dit website, kan du gøre det ved hjælp af en af vores API'er. I denne artikel kan du læse, hvordan du kommer i gang.
Det kræver lidt teknisk ekspertise, så du får muligvis brug for hjælp fra en udvikler.
Business Units
Før du begynder at fremvise dine Trustpilot-anmeldelser, er det vigtigt at vide, hvordan vi identificerer domæner via Business Unit ID'er, også kaldet BUID'er. En Business Unit er samlingspunktet for alt Trustpilot-indholdet for et website og indeholder en virksomheds bedømmelser, anmeldelser og svar. BUID'et er en unik identifikator for den pågældende virksomhed og den primære nøgle i mange af dine API calls. Du kan læse mere om BUID'er her.
Sådan finder du et BUID
Dit Business Unit ID er et unikt ID, der er specifikt for dit domæne. Det er altid det samme og ændrer sig kun, hvis dit domæne på Trustpilot bliver ændret. Du kan finde Business Unit ID'et for dit domæne ved hjælp af slutpunktet "Find a business unit". Den påkrævede parameter her er dit Business Units "name", dvs. dit websites domæne. Eksempel: Hvis du gerne vil finde Trustpilots BUID, skal du angive parameteren "trustpilot.com".
Du kan selv prøve det af. Du skal bare huske at angive en anden API-nøgle.
https://api.trustpilot.com/v1/business-units/find?apikey={{apikey}}&name=trustpilotdemo.com
Når du får svar, skal du finde feltet "id". Dette er dit BUID for det domæne, du søgte efter.
Hent dine anmeldelser
Når du har fået et BUID for dit domæne, kan du begynde at hente dine anmeldelser, bedømmelser og svar ved hjælp af følgende API call: Get a business unit’s reviews.
Hvis du kun vil hente de offentlige oplysninger om et Business Unit (dvs. stjernebedømmelser, antal anmeldelser, TrustScore osv.), kan du finde oplysningerne under slutpunktet Find a business unit som angivet ovenfor. Du kan også bruge slutpunktet Get public business unit.
Retningslinjer for brugertilpassede integrationer
For at sikre, at du følger vores retningslinjer, vil vi anbefale dig at læse vores supportartikel Trustpilots API'er – Retningslinjer for integration af serviceanmeldelser.
Her er nogle af hovedpunkterne:
- Du skal altid oplyse, hvilke anmeldelser du viser. Hvis du for eksempel viser 4- og 5-stjernede anmeldelser, skal du angive det.
- Afslør ikke din API-nøgle offentligt i frontend. Du bør kun foretage API calls fra backend og derefter sende data til frontend til visning.
- Undgå at foretage et API call, hver gang siden indlæses. I stedet bør du cachelagre dataene på din side og opdatere dem f.eks. hver halve time, time eller hvert døgn. Du kan også bruge vores webhooks til at opdatere anmeldelser i realtid.
- Sørg for, at anmeldelsesteksten i din widget ikke kan indekseres af Google. Dermed undgår du kopieret indhold, og at din placering i søgemaskiner forringes. Placér i stedet dine widgets på en separat side (f.eks. et subdomæne) med tagget <meta name="robots" content="noindex"> i head-elementet. Derfra kan du bruge en <iframe> til at vise din TrustBox-widget på dit hovedwebsite.
API calls på serversiden
Af sikkerhedshensyn skal alle API calls foretages på serversiden. Dermed bliver din private API-nøgle ikke eksponeret på dit website. Det giver også hurtigere indlæsningshastigheder og reducerer netværksomkostninger.
Cachelagring af API calls
Når du viser brugerdefinerede TrustBox-widgets på dit site, vil vi anbefale, at du cachelagrer dataene. Cachelagring øger ydeevnen og pålideligheden. Ydeevnen øges, fordi kilden til cachelagrede data kan være tættere på forbrugeren, og cachen kan behandle duplikerede dataanmodninger, hvilket sparer unødvendige beregninger og netværkstrafik. Pålideligheden øges, fordi dataforbrugeren er isoleret fra tjenesteafbrydelser fra kilden.