Wanneer gebruik je inbedding?
Inbedding is nuttig wanneer je Looker Studio-rapporten wilt integreren in een bestaande omgeving in plaats van mensen naar een aparte rapport-URL te sturen:
- Website: openbare dashboards op een klantgerichte pagina
- Intranet: interne dashboards op je bedrijfsportaal
- Applicatie: rapportages als onderdeel van je eigen product
- Presentaties: live dashboards in een browser-gebaseerde presentatie
- Schermen op kantoor: operationele dashboards op een muurscherm
Een ingebed rapport is een live, interactieve versie van het dashboard. Filters en datumbereik-besturingen blijven werken, maar bezoekers kunnen het rapport niet bewerken, kopieren of doorsturen.
Inbedding activeren
Inbedcode genereren
- Open het rapport in bewerkingsmodus.
- Ga naar Bestand > Rapport inbedden, of klik rechtsboven op Inbedden.
- Zet de schakelaar Inbedden inschakelen aan.
- Kies de optie Inbedcode (in plaats van Inbed-URL).
- Pas de breedte en hoogte aan naar de afmetingen van je inbedruimte.
- Klik op Kopieren naar klembord en plak de iframe-code in de HTML van je website of applicatie.
Gebruik de inbed-link, niet de gewone deellink
Je moet de link gebruiken die in dit inbed-venster wordt gegenereerd. Een rapport inbedden met de gewone deelbare link werkt niet.
Voorbeeldcode:
<iframe
width="600"
height="450"
src="https://lookerstudio.google.com/embed/reporting/[ID]/page/[PAGE]"
frameborder="0"
style="border:0"
allowfullscreen
sandbox="allow-storage-access-by-user-activation allow-scripts allow-same-origin allow-popups allow-popups-to-escape-sandbox">
</iframe>
Vereisten voor inbedding
Het rapport moet toegankelijk zijn voor de bezoeker van je pagina. De zichtbaarheid hangt af van de deelinstelling van het rapport:
- Openbaar rapport: iedereen kan het iframe bekijken zonder in te loggen
- Link-deelbaar: bezoekers moeten ingelogd zijn met een Google-account dat toegang heeft
- Gedeeld met specifieke personen, groepen of domeinen: alleen die personen zien het rapport in het iframe
Voor publieke websites kies je het openbare rapport. Voor intranet-pagina's is link-deelbaar of een domeingedeeld rapport praktisch wanneer alle medewerkers een Google Workspace-account hebben.
URL-parameters voor dynamische inbedding
Je kunt de inbed-URL uitbreiden met parameters om het rapport voor te configureren. Zet parameters achter de URL na een vraagteken.
Datumbereik meegeven
?df1=20240101&df2=20241231
Geeft een vast datumbereik mee als standaardinstelling, in de notatie JJJJMMDD.
Filterwaarden en parameters meegeven
?params={"df1":"20240101","df2":"20241231","filter1":"Nederland"}
Looker Studio leest rapportparameters uit een URL-gecodeerde JSON-string in de params-parameter. De exacte URL-naam van elke parameter vind je in het rapport onder Variabelen (parameters) beheren. URL-encodeer de JSON-waarde voordat je hem in een productie-iframe plakt.
Paginaselectie
Voeg de pagina-ID toe aan de URL om direct op een specifieke pagina te landen:
/page/p_abc123xyz
Toolbar verbergen
Voeg &rm=minimal aan de URL toe om de toolbar en paginanavigatie te verbergen voor een strakker inbedformaat.
Responsieve inbedding
Iframes zijn standaard niet responsief. Voor een schaalbare inbedding gebruik je een wrapper met CSS:
<div style="position:relative; padding-bottom:56.25%; height:0; overflow:hidden;">
<iframe style="position:absolute; top:0; left:0; width:100%; height:100%;"
src="https://lookerstudio.google.com/embed/reporting/[ID]/page/[PAGE]"
frameborder="0" allowfullscreen></iframe>
</div>
De padding-bottom van 56.25% zorgt voor een 16:9-verhouding. Pas dit percentage aan als je dashboard een andere hoogte-breedteverhouding heeft.
Beveiligingsoverwegingen
Denk goed na over welke data je openbaar inbedt. Eenmaal openbaar is de data voor iedereen beschikbaar, ook voor zoekmachines en scrapers. Test je rapport in een incognitovenster om te verifieren welke data zichtbaar is voor anonieme bezoekers.
Praktische maatregelen voor veiliger inbedden:
- Gebruik eigenaarscredentials op de databron alleen als je de data bewust openbaar wilt maken
- Maak een aparte, gefilterde databron voor het openbare rapport wanneer de bron gevoelige data bevat
- Beperk velden en filters tot wat de bezoeker echt mag zien, niet de volledige dataset
- Monitor het gebruik: hoeveel dataverzoeken genereert je ingebed rapport en wat kost dat bij een betaalde bron als BigQuery?
Per-klant data afschermen
Heb je een BigQuery-databron in een beheerde Google Workspace- of Cloud Identity-organisatie? Dan kun je klantspecifieke parameterwaarden via URL-parameters doorgeven nadat je in je eigen applicatie de toegang hebt gevalideerd. Zo ziet elke klant alleen zijn eigen data zonder aparte rapporten.
Content Security Policy (CSP)
Als je website een strikt Content Security Policy heeft, moet je het Looker Studio-domein toevoegen aan je frame-src-allowlist:
frame-src https://lookerstudio.google.com;
Zonder deze toestemming blokkeert de browser het iframe. Houd er rekening mee dat ingebedde rapporten HTTPS vereisen; een iframe op een pagina via HTTP wordt door moderne browsers geweigerd.
Mijn ingebed rapport laadt niet, wat kan ik controleren?
Loop deze punten af: controleer of het rapport openbaar of correct gedeeld is, bekijk de browser-console op CSP- of frame-fouten, test de rapport-URL rechtstreeks in de browser, en controleer of je pagina via HTTPS wordt geserveerd. Looker Studio-iframes werken niet op een HTTP-pagina.
Kan ik een ingebed rapport beveiligen met een wachtwoord?
Looker Studio heeft geen ingebouwde wachtwoordbeveiliging voor rapporten. Beveilig in plaats daarvan de pagina waarop het iframe staat, via de login of toegangscontrole van je CMS of webapplicatie.
Het rapport werkt in mijn browser maar niet voor bezoekers, hoe kan dat?
Je bent zelf ingelogd met een Google-account dat toegang heeft, dus je ziet het rapport via je eigen rechten. Anonieme bezoekers zien alleen openbare rapporten. Test daarom altijd in een incognitovenster of een ander account.
Kan ik meerdere rapporten op dezelfde pagina inbedden?
Ja, elk iframe laadt zijn eigen rapport. Let wel op de laadtijd: meerdere live dashboards op een pagina kunnen veel dataverzoeken tegelijk genereren en de pagina trager maken.
Waarom kan ik de standaard deellink niet gebruiken voor inbedding?
Inbedding vereist de speciale link uit het inbed-venster, niet de gewone deelbare URL. De inbed-link bevat het /embed/-pad waarmee Looker Studio het rapport in view-modus binnen een iframe serveert.
Kan ik het Looker Studio-watermerk verwijderen uit het ingebedde rapport?
Nee, het watermerk in een ingebed rapport kan niet worden verwijderd. Houd hier rekening mee in het ontwerp van de omliggende pagina.