# Community-visualisaties in Looker Studio

[[TOC]]

## Wat zijn community-visualisaties?

Community-visualisaties zijn aangepaste grafiektypen die door de Looker Studio-community zijn gebouwd: Google-medewerkers, developers en externe partijen. Ze voegen grafiektypen toe die standaard niet in Looker Studio zitten. Je configureert ze net als de ingebouwde grafieken, met dimensies, statistieken en stijlopties.

Populaire community-visualisaties:

| Type | Gebruik |
|---|---|
| Sankey-diagram | Stromen en verhoudingen, bijvoorbeeld een conversietrechter |
| Gantt-diagram | Tijdlijnen en planning |
| Heatmap | Patronen op een raster, bijvoorbeeld dag tegen uur |
| Waffle chart | Percentage-visualisatie als raster |
| Funnel chart | Sales- of marketingfunnel |
| Gauge of meter | Voortgang naar een doelwaarde |
| Bullet chart | KPI tegen target met meer opties |
| Word cloud | Frequentie van tekst-dimensies |

## Community-visualisatie inladen

:::howto title="Community-visualisatie toevoegen"
1. Klik op **Grafiek toevoegen** in de werkbalk.
2. Scroll naar beneden naar **Community-visualisaties** en klik op **Verken meer**.
3. De Community Gallery opent. Blader door de visualisaties of zoek op naam.
4. Klik op de gewenste visualisatie en daarna op het canvas om hem te plaatsen.
5. Bij een visualisatie van een externe maker vraagt Looker Studio eenmalig om **toestemming**, omdat er code van buiten Google wordt geladen. Bevestig dit om door te gaan.
6. Stel in het eigenschappenpaneel de velden in. Welke velden nodig zijn, verschilt per visualisatie.
:::

:::info title="Google-eigen versus visualisaties van derden"
Een aantal community-visualisaties is door Google zelf gebouwd, zoals gauge, waterfall en candlestick. Daarvoor hoef je geen toestemming te geven. Visualisaties van externe makers vragen wel toestemming, en je databron moet dan op **inloggegevens van de eigenaar** staan.
:::

:::warning title="Je deelt rapportdata met externe code"
Community-visualisaties van derden voeren JavaScript uit dat door externe ontwikkelaars is geschreven en krijgen toegang tot de data in je rapport. Looker Studio gebruikt een Content Security Policy die externe verzoeken beperkt om te voorkomen dat data naar een server buiten Google wordt gestuurd, maar Google beoordeelt de visualisaties zelf niet inhoudelijk op veiligheid. Gebruik daarom alleen visualisaties van bekende makers met goede reviews, open-source code en actief onderhoud. Controleer de GitHub-repository op recente activiteit.
:::

## Aanbevolen community-visualisaties

### Heatmap Calendar
Visualiseer een waarde per dag in een jaarkalender. Ideaal voor patronen zoals websiteverkeer of verkoopactiviteit per dag van het jaar.

Velden: Datum op dagniveau en een numerieke statistiek.

### Sankey-diagram
Toon hoe gebruikers van de ene staat naar de andere stromen. Ideaal voor conversietrechters, budgetallocatie of leveringsketen-analyses.

Velden: Bron, Bestemming en Gewicht als statistiek.

### Funnel Chart
Visualiseer een conversietrechter met de afname per stap. Communiceert drop-off duidelijker dan een standaard staafdiagram.

### Word Cloud
Toon de frequentie van tekst-dimensies als woordenwolk. Nuttig voor zoekwoorden, productcategorieën of klantsegmenten.

:::tip title="Test eerst op een kopie"
Voeg een nieuwe community-visualisatie eerst toe aan een testrapport of een kopie van je dashboard. Zo zie je hoe hij met jouw data en filters omgaat zonder dat je een live rapport verstoort, en kun je de prestaties beoordelen voordat je hem breed inzet.
:::

## Privé community-visualisaties hosten

Geavanceerde gebruikers en organisaties kunnen hun eigen community-visualisaties bouwen en hosten. Dat vereist:

1. Kennis van JavaScript en de Looker Studio visualization API.
2. Een Google Cloud Storage-bucket of ander CDN om de visualisatiecode en het manifest te hosten.
3. Het manifestpad. Via **Grafiek toevoegen**, **Verken meer** en **Bouw je eigen visualisatie** voer je het manifestpad in om de visualisatie te testen en toe te voegen.
4. Registratie in de Community Gallery, optioneel, alleen als je wilt publiceren.

Voor organisaties met specifieke wensen die niet in bestaande visualisaties zitten, is dit een goede route. Raadpleeg de officiële Looker Studio developer-documentatie voor de API-specificaties.

## Beperkingen van community-visualisaties

- De prestaties kunnen langzamer zijn dan bij ingebouwde visualisaties.
- Onderhoud ligt bij derden, dus updates en bugfixes zijn niet gegarandeerd.
- De integratie met Looker Studio-functies is beperkt, sommige filterinteracties werken bijvoorbeeld niet.
- Niet alle community-visualisaties ondersteunen alle databrontypen.

:::faq
### Een community-visualisatie toont een foutmelding na het laden. Wat doe ik?
Controleer of de veldtypen correct zijn ingesteld. De visualisatie vereist vaak een specifiek type, bijvoorbeeld een datumveld als Datum en niet als Tekst. Raadpleeg daarnaast de documentatie van die specifieke visualisatie.

### Kan ik een community-visualisatie opnemen in een geplande PDF-e-mail?
Ja, maar de resultaten kunnen variëren. Sommige community-visualisaties renderen niet correct in PDF-exports. Download daarom altijd eerst een handmatige PDF voordat je geplande leveringen instelt.

### Zijn er beveiligingsrisico's bij community-visualisaties?
Visualisaties van derden voeren externe code uit met toegang tot je rapportdata. Een Content Security Policy beperkt verzoeken naar buiten, maar je vertrouwt nog steeds code van een externe maker. Gebruik alleen visualisaties met actief onderhoud en open-source code die je kunt inspecteren.

### Hoe schakel ik community-visualisaties helemaal uit?
In de instellingen van een databron kun je community-visualisaties voor die bron uitzetten. Dan kan niemand jouw data via een visualisatie van derden weergeven. Dat is een goede keuze voor gevoelige bronnen.

### Kan ik de code van een community-visualisatie aanpassen?
Alleen als je de visualisatie zelf host op je eigen CDN. Dan beheer je de code en het manifest. Gebruik je een visualisatie uit de gallery, dan ben je afhankelijk van de maker voor wijzigingen.
:::