Google Analytics
Toegang tot Google Analytics-gegevens en genereer uitgebreide rapporten voor websiteprestatieanalyse. Via de integratie van Langdock kunt u Google Analytics rechtstreeks vanuit uw gesprekken openen en beheren.
Authenticatie: OAuth Categorie: Google Workspace Beschikbaarheid: Alle workspace-abonnementen
Beschikbare acties
Realtime gebruikers per apparaat ophalen
googleanalytics.getRealtimeUsersbyDevice
Haalt actieve gebruikers van de afgelopen 30 minuten op, uitgesplitst naar apparaatscategorie (desktop, mobiel, tablet)
Bevestiging vereist: Nee
Parameters:
propertyId(TEKST, Verplicht): De Google Analytics 4 property-id. Dit is de numerieke identificatie voor uw GA4-property (bijv. 123456789)
Uitvoer: Geeft realtimegebruikersgegevens terug, uitgesplitst naar apparaatscategorie
Rapport uitvoeren
googleanalytics.runReport
Genereer aangepaste analyserapporten met flexibele datumbereiken, statistieken en dimensies
Bevestiging vereist: Nee
Parameters:
propertyId(TEKST, Verplicht): De Google Analytics 4 property-id. Dit is de numerieke identificatie voor uw GA4-property (bijv. 123456789)startDate(TEKST, Verplicht): Begindatum voor het rapport in YYYY-MM-DD-formaat of relatieve datum (bijv. ‘7daysAgo’, ‘yesterday’)endDate(TEKST, Verplicht): Einddatum voor het rapport in YYYY-MM-DD-formaat of relatieve datum (bijv. ‘yesterday’, ‘today’)metrics(TEKST, Verplicht): De metric om op te nemen in het rapport (bijv. ‘sessions’, ‘activeUsers’, ‘screenPageViews’, ‘bounceRate’)dimensions(TEKST, Optioneel): Optionele dimensie om de gegevens naar te groeperen (bijv. ‘country’, ‘deviceCategory’, ‘pagePath’, ‘sessionSource’)pageFilter(TEKST, Optioneel): Optionele filter om alleen pagina’s op te nemen die deze tekst bevatten (bijv. ‘/de/pricing’, ‘/features’, ‘/blog’)
Uitvoer: Geeft analyserapportgegevens terug met de volgende structuur:
dimensionHeaders: Informatie over de dimensies in het rapportmetricHeaders: Informatie over de metrics in het rapportrows: Array van datarijen met dimensie- en metricwaardentotals: Samenvattende totalen voor het rapportrowCount: Aantal rijen in het rapport
Draai een draaitabelrapport
googleanalytics.runPivotReport
Genereer geavanceerde draaitabelrapporten voor data-analyse, het ontdekken van correlaties en het vergelijken van toppers/onderpresteerders over meerdere dimensies
Bevestiging vereist: Nee
Parameters:
propertyId(TEKST, Verplicht): De Google Analytics 4 property-id. Dit is de numerieke identificatie voor uw GA4-property (bijv. 123456789)startDate(TEKST, Verplicht): Begindatum voor het rapport in YYYY-MM-DD-formaat of relatieve datum (bijv. ‘30daysAgo’, ‘7daysAgo’)endDate(TEKST, Verplicht): Einddatum voor het rapport in YYYY-MM-DD-formaat of relatieve datum (bijv. ‘yesterday’, ‘today’)metrics(TEKST, Verplicht): Komma-gescheiden lijst van metrics om te analyseren (bijv. ‘sessions,activeUsers,screenPageViews,bounceRate’)dimensions(TEKST, Verplicht): Komma-gescheiden lijst van ALLE dimensies die u wilt analyseren. Opmerking: in draaitabelrapporten worden alleen dimensies gebruikt die ook zijn opgegeven in ‘Pivot dimensions’ om API-fouten te voorkomen.pivotDimensions(TEKST, Verplicht): Komma-gescheiden lijst van specifieke dimensies om te gebruiken als pivotkolommen/-rijen. Deze moeten een subset zijn van de bovenstaande dimensies (bijv. ‘deviceCategory’ of ‘deviceCategory,country’)
Uitvoer: Geeft draaitabelrapportgegevens terug met gekruiste resultaten
Metadata ophalen
googleanalytics.getMetadata
Haal alle beschikbare dimensies en metrics voor de property op, inclusief aangepaste dimensies en metrics
Bevestiging vereist: Nee
Parameters:
propertyId(TEKST, Verplicht): De Google Analytics 4 property-id. Dit is de numerieke identificatie voor uw GA4-property (bijv. 123456789)
Uitvoer: Geeft metadata terug inclusief alle beschikbare dimensies en metrics voor de property
Analyseer contentprestaties
googleanalytics.analyzeContentPerformance
Gespecialiseerd rapport voor het analyseren van pagina-/contentprestaties om toppers en onderpresteerders te identificeren, anomalieën te detecteren en de effectiviteit van onderwerpen te begrijpen
Bevestiging vereist: Nee
Parameters:
propertyId(TEKST, Verplicht): De Google Analytics 4 property-id. Dit is de numerieke identificatie voor uw GA4-property (bijv. 123456789)startDate(TEKST, Verplicht): Begindatum voor de analyse in YYYY-MM-DD-formaat of relatieve datum (bijv. ‘30daysAgo’, ‘7daysAgo’)endDate(TEKST, Verplicht): Einddatum voor de analyse in YYYY-MM-DD-formaat of relatieve datum (bijv. ‘yesterday’, ‘today’)sortBy(TEKST, Optioneel): Metric om de resultaten op te sorteren om top-/bodemprestaties te identificeren (bijv. ‘sessions’, ‘activeUsers’, ‘engagementRate’, ‘bounceRate’)limit(NUMMER, Optioneel): Maximaal aantal pagina’s/content om terug te geven (standaard: 50, max: 100)pageFilter(TEKST, Optioneel): Filter om alleen pagina’s op te nemen die deze tekst bevatten (bijv. ‘pricing’, ‘blog’, ‘features’). Laat leeg voor alle pagina’s.metrics(TEKST, Optioneel): Optionele komma-gescheiden lijst van metrics om op te nemen (bijv. ‘sessions,activeUsers,screenPageViews’)dimensions(TEKST, Optioneel): Optionele komma-gescheiden lijst van dimensies om op te groeperen (bijv. ‘pagePath,pageTitle’)
Uitvoer: Geeft contentprestatie-analyse terug met pageranglijsten en prestatiewaarden
Analyseer verkeersbronnen
googleanalytics.analyzeTrafficSources
Analyseer verkeersbronnen, acquisitiekanalen en marketingprestaties om anomalieën te detecteren en effectieve kanalen te identificeren
Bevestiging vereist: Nee
Parameters:
propertyId(TEKST, Verplicht): De Google Analytics 4 property-id. Dit is de numerieke identificatie voor uw GA4-property (bijv. 123456789)startDate(TEKST, Verplicht): Begindatum voor de analyse in YYYY-MM-DD-formaat of relatieve datum (bijv. ‘30daysAgo’, ‘7daysAgo’)endDate(TEKST, Verplicht): Einddatum voor de analyse in YYYY-MM-DD-formaat of relatieve datum (bijv. ‘yesterday’, ‘today’)groupBy(SELECT, Optioneel): Dimensie om verkeersbronnen op te groeperen (source, medium, campaign, channelGroup)metrics(TEKST, Optioneel): Optionele komma-gescheiden lijst van metrics om op te nemen (bijv. ‘sessions,activeUsers,newUsers,engagementRate’)sortBy(TEKST, Optioneel): Optionele metrische naam om de resultaten op te sorteren (bijv. ‘sessions’)
Uitvoer: Geeft verkeersbronanalyse terug met kanaalprestatiemetrics
Batchrapporten uitvoeren
googleanalytics.batchRunReports
Genereer meerdere aangepaste rapporten in één API-aanroep voor efficiënte data-analyse en vergelijking
Bevestiging vereist: Nee
Parameters:
propertyId(TEKST, Verplicht): De Google Analytics 4 property-id. Dit is de numerieke identificatie voor uw GA4-property (bijv. 123456789)reportRequests(MEERREGELS_TEKST, Verplicht): JSON-array van rapportconfiguraties. Elk rapport moet startDate, endDate, metrics en dimensions bevatten. Voorbeeld: [startDate’: ‘7daysAgo’, ‘endDate’: ‘yesterday’, ‘metrics’: ‘sessions’, ‘dimensions’: ‘country, startDate’: ‘30daysAgo’, ‘endDate’: ‘yesterday’, ‘metrics’: ‘activeUsers’, ‘dimensions’: ‘sessionSource]
Uitvoer: Geeft meerdere rapporten terug in één antwoord voor efficiënte data-analyse
Evenement toevoegen
googleanalytics.addEvent
Maakt een nieuw evenement aan in een specifieke agenda
Bevestiging vereist: Ja
Parameters:
sendUpdates(TEKST, Optioneel): Of er meldingen moeten worden verzonden (‘all’, ‘externalOnly’, ‘none’)startTijd(TEKST, Vereist): Starttijd in RFC3339-formaat (bijv. ‘2025-03-15T09:00:00+01:00’)beschrijving(TEKST, Optioneel): Beschrijving van het evenement (optioneel)attendees(TEKST, Optioneel): Lijst met e-mailadressen van deelnemers (optioneel)recurrence(TEKST, Optioneel): Lijst van RRULE-, EXRULE-, RDATE- en EXDATE-regels voor een terugkerend evenement, zoals gespecificeerd in RFC5545. Let op: DTSTART- en DTEND-regels zijn niet toegestaan. De scheiding tussen regels is een spatie.eindTijd(TEKST, Vereist): Eindtijd in RFC3339-formaat (bijv. ‘2025-03-15T10:00:00+01:00’)calendarId(TEKST, Vereist): De id van de agenda (bijv. ‘primary’ voor de hoofdagenda)location(TEKST, Optioneel): Locatie van het evenement (optioneel)timeZone(TEKST, Vereist): BELANGRIJK: Als je de tijdzone van de gebruiker niet weet, vraag het dan aan hem. RAADPLEEG DE TIJDZONE NIET (Voorbeeldformaat: ‘America/New_York’)titel(TEKST, Vereist): Titel van het evenementeventType(TEKST, Optioneel): Het type evenement. Toegestane waarden: default, focusTime, outOfOffice, workingLocation, enz. Zie de Google Calendar API-documentatie voor de volledige lijst. Geef slechts één evenementtype op
Uitvoer: Geeft het aangemaakte evenement terug met de volgende structuur:
id: Evenement-IDsummary: Evenementtitelbeschrijving: Evenementbeschrijvingstart: Starttijdinformatie met dateTime en timeZoneend: Eindtijdinformatie met dateTime en timeZonelocation: Evenementlocatieattendees: Array van deelnemerobjecten met e-mailadressenrecurrence: Herhalingsregels indien van toepassinghtmlLink: Link om het evenement te bekijken in Google Agendacreated: Aanmaak-tijdstempelupdated: Tijdstempel van de laatste update
Evenement bijwerken
googleanalytics.updateEvent
Werkt een evenement bij
Bevestiging vereist: Ja
Parameters:
eventId(TEKST, Vereist): id van het evenementeindTijd(TEKST, Optioneel): Eindtijd in RFC3339-formaat (bijv. ‘2025-03-15T10:00:00+01:00’)startTijd(TEKST, Optioneel): Nieuwe starttijd in RFC3339-formaat (bijv. ‘2025-03-15T09:00:00+01:00’)calendarId(TEKST, Vereist): De id van de agenda (bijv. ‘primary’ voor de hoofdagenda)timeZone(TEKST, Optioneel): Nieuwe tijdzone (bijv. ‘America/New_York’)eventTitle(TEKST, Optioneel): Nieuwe titel van het evenement (optioneel)attendees(TEKST, Optioneel): Nieuwe lijst met e-mailadressen van deelnemers (optioneel)beschrijving(TEKST, Optioneel): Nieuwe beschrijving van het evenement (optioneel)location(TEKST, Optioneel): Nieuwe locatie van het evenement (optioneel)sendUpdates(TEKST, Optioneel): Nieuw beleid voor het al dan niet verzenden van meldingen (‘all’, ‘externalOnly’, ‘none’) (optioneel)recurrence(TEKST, Optioneel): Nieuwe lijst van RRULE-, EXRULE-, RDATE- en EXDATE-regels voor een terugkerend evenement, zoals gespecificeerd in RFC5545. Let op: DTSTART- en DTEND-regels zijn niet toegestaan. De scheiding tussen regels is een spatie.eventType(TEKST, Optioneel): Het type evenement om bij te werken. Toegestane waarden: default, focusTime, outOfOffice, workingLocation, enz. Zie de Google Calendar API-documentatie voor de volledige lijst. Geef op als een door komma’s gescheiden lijst.
Uitvoer: Geeft het bijgewerkte evenement terug met de nieuwe details
Evenement ophalen
googleanalytics.getEvent
Haalt een evenement op
Bevestiging vereist: Nee
Parameters:
eventId(TEKST, Vereist): De id van het specifieke evenement dat opgehaald moet wordencalendarId(TEKST, Vereist): De id van de agenda (kan ‘primary’ gebruiken voor de primaire agenda van de gebruiker)
Uitvoer: Geeft de evenementgegevens terug inclusief alle eigenschappen en metadata
Zoek naar evenementen
googleanalytics.searchforEvents
Haalt agendagebeurtenissen op via zoekopdracht
Bevestiging vereist: Nee
Parameters:
maxResults(TEKST, Optioneel): Maximale aantal resultaten om terug te geven (optioneel, standaard: 10)searchQuery(TEKST, Optioneel): Bij gebruik van het zoekveld voor agendagebeurtenissen, voer specifieke en relevante trefwoorden in die waarschijnlijk voorkomen in de volgende velden:BELANGRIJK NIET IGNOREREN: als u gevraagd wordt om naar dingen te zoeken zoals een afspraak, vergadering, telefoongesprek, … voeg deze term dan niet toe aan de zoekopdracht aangezien dit synoniemen voor evenement zijn
Samenvatting of titel: Voeg trefwoorden toe die het evenement beschrijven, zoals “Projectvergadering”, “Kwartaalsreview” of “Teamlunch.”
Beschrijving: Gebruik termen die gerelateerd zijn aan de inhoud of het doel van het evenement, zoals “budgetbespreking” of “klantpresentatie.”
Locatie: Geef de naam van de locatie of het gebouw waar het evenement plaatsvindt, zoals “Vergaderzaal A” of “Hoofdkantoor.”
Deelnemers: Voeg namen of e-mailadressen van specifieke deelnemers toe, bijv. “[email protected]” of “Jane Smith.”
Organisator: Gebruik de naam of e-mail van de organisator om evenementen te vinden die zij hosten, zoals “[email protected]” of “Michael Johnson.”
Eigenschappen werkplek locatie: Indien van toepassing, gebruik identificatoren zoals kantoorlocatielabels of gebouw-ID’s.
endDate(TEKST, Optioneel): Einddatum van de periode die voor de zoekopdracht wordt doorzocht. Bovengrens (exclusief) voor de begintijd van een evenement om op te filteren. Moet een RFC3339-tijdstempel zijn met verplichte tijdzone-offset (bijv. 2011-06-03T10:00:00-07:00). Als Begindatum is ingesteld, moet Einddatum groter zijn dan Begindatum.calendarId(TEKST, Vereist): De id van de agenda om te doorzoeken (gebruik ‘primary’ voor de primaire agenda van de gebruiker)startDate(TEKST, Optioneel): Begindatum van de periode die voor de zoekopdracht wordt doorzocht. Ondergrens (exclusief) voor de eindtijd van een evenement om op te filteren. Moet een RFC3339-tijdstempel zijn met verplichte tijdzone-offset. Als Einddatum is ingesteld, moet Begindatum kleiner zijn dan Einddatum.desc(BOOLEAN, Optioneel): Selecteer of de resultaten in aflopende volgorde moeten worden weergegeven (starttijd).eventType(TEKST, Optioneel): Het type evenement om op te filteren. Toegestane waarden: default, focusTime, outOfOffice, workingLocation, enz. Zie de Google Calendar API-documentatie voor de volledige lijst. Geef slechts één enkel evenementtype op.
Uitvoer: Geeft een array met evenementen terug die voldoen aan de zoekcriteria
Evenement verwijderen
googleanalytics.deleteEvent
Verwijdert een evenement
Bevestiging vereist: Ja
Parameters:
eventId(TEKST, Verplicht): id van het evenement dat wordt verwijderd. Voor evenementenseries geldt dat als u een evenementinstance-id opgeeft, alleen die instantie wordt verwijderd, en als u de master-id van een terugkerend evenement opgeeft, de hele serie wordt verwijderd. Bij een evenementinstance-id van een terugkerend evenement zoals 7hagg0gtspd2b03lm8i3g4irr0_20250318T160000Z is het gedeelte tot de eerste _ de master-id van het evenement.calendarId(TEKST, Vereist): De id van de agenda (bijv. ‘primary’ voor de hoofdagenda)
Uitvoer: Geeft bevestiging van de verwijdering
Agenda’s weergeven
googleanalytics.listCalendars
Toont alle agenda’s die toegankelijk zijn voor de geauthenticeerde gebruiker via de Google Calendar API /users/me/calendarList endpoint.
Bevestiging vereist: Nee
Parameters:
maxResults(TEKST, Optioneel): Maximale aantal items om terug te geven op één resultaatpagina (standaard: 100, max: 250).minAccessRole(SELECT, Optioneel): Beperkt resultaten tot agenda’s waarbij de gebruiker ten minste deze toegangsrol heeft. Toegestane waarden: freeBusyReader, reader, writer, owner.pageToken(TEKST, Optioneel): Token dat specificeert welke resultaatpagina moet worden geretourneerd (voor paginering).showDeleted(BOOLEAN, Optioneel): Of verwijderde agenda-lijstitems moeten worden opgenomen in het resultaat (standaard: false).showHidden(BOOLEAN, Optioneel): Of verborgen items moeten worden weergegeven (standaard: false).syncToken(TEKST, Optioneel): Voor incrementele synchronisatie: retourneer alleen items die zijn gewijzigd sinds het vorige verzoek met deze token. Kan niet samen met minAccessRole worden gebruikt.
Uitvoer: Geeft een array van agenda’s terug met de volgende structuur:
id: Agenda-IDsummary: Agenda-naambeschrijving: Agenda-beschrijvingtimeZone: Agenda-tijdzoneaccessRole: Toegangsrol van de gebruiker voor deze agendabackgroundColor: Agenda-kleurforegroundColor: Tekstkleur voor deze agendaselected: Of deze agenda geselecteerd isprimary: Of dit de primaire agenda van de gebruiker is
Vrij/bezet voor agenda opvragen
googleanalytics.getFreeBusyforCalendar
Haalt vrij-/bezetinformatie op voor één of meerdere agenda’s over een opgegeven tijdsbereik met behulp van de Google Calendar API /freeBusy endpoint.
Bevestiging vereist: Nee
Parameters:
timeMin(TEKST, Vereist): RFC3339-tijdstempel voor het begin van het te controleren tijdsbereik (inclusief). Voorbeeld: 2025-05-15T08:00:00ZtimeMax(TEKST, Vereist): RFC3339-tijdstempel voor het einde van het te controleren tijdsbereik (exclusief). Voorbeeld: 2025-05-15T18:00:00ZtimeZone(TEKST, Optioneel): Tijdzone voor de reactie (optioneel, standaard UTC). Voorbeeld: Europe/Berlinitems(TEKST, Vereist): Lijst met agenda-IDs om te controleren (bijv. e-mails, resource-ID’s of ‘primary’). Voer in als een door komma’s gescheiden lijst.
Uitvoer: Geeft beschikbaarheid-/bezettingsinformatie terug met de volgende structuur:
kind: API-resourcetypetimeMin: Begin van het opgevraagde bereiktimeMax: Einde van het opgevraagde bereikcalendars: Object met beschikbaarheid-/bezettingsinformatie voor elke opgevraagde agendabusy: Array van tijdsintervallen waarin de agenda bezet iserrors: Eventuele fouten die voor deze agenda zijn opgetreden
Triggers
Nieuw evenement
googleanalytics.newEvent
Wordt geactiveerd wanneer nieuwe agendagebeurtenissen worden aangemaakt in opgegeven agenda’s
Bevestiging vereist: Nee
Parameters:
calendarId(TEKST, Optioneel): ID van de agenda om te controleren op nieuwe evenementen. Identificeert welke specifieke agenda gecontroleerd moet worden op nieuwe evenementendaysToInclude(TEKST, Optioneel): Aantal dagen in de toekomst om naar evenementen te zoeken. Standaard is 30 dagen
Uitvoer: Geeft informatie over nieuw aangemaakte evenementen terug
Evenement start
googleanalytics.eventStart
Wordt geactiveerd wanneer evenementen binnen een gespecificeerd tijdsvenster op het punt staan te beginnen
Bevestiging vereist: Nee
Parameters:
calendarId(TEKST, Optioneel): ID van de agenda om te bewaken. Standaard je primaire agenda als niet gespecificeerdminuteBefore(TEKST, Vereist): Aantal minuten voordat een evenement begint om de workflow te activeren. Standaard is 15 minuten
Uitvoer: Geeft informatie over komende evenementen terug
Nieuw evenement dat overeenkomt met zoekopdracht
googleanalytics.newEventMatchingSearch
Wordt geactiveerd wanneer nieuwe agendagebeurtenissen die overeenkomen met de opgegeven zoekopdracht worden aangemaakt
Bevestiging vereist: Nee
Parameters:
calendarId(TEKST, Optioneel): ID van de agenda om te controleren op nieuwe evenementen. Identificeert welke specifieke agenda gecontroleerd moet worden op nieuwe evenementendaysToInclude(NUMMER, Optioneel): Aantal dagen in de toekomst om naar evenementen te zoeken. Standaard is 30 dagensearchQuery(TEKST, Vereist): Tekst om in evenementonderwerpen te zoeken. Voorbeelden: ‘Meeting’, ‘Review’, ‘Project kickoff’
Uitvoer: Geeft informatie over evenementen die overeenkomen met de zoekcriteria terug
Veelvoorkomende gebruikssituaties
Gegevensbeheer: Beheer en organiseer uw Google Analytics-gegevens
Automatisering: Automatiseer workflows met Google Analytics
Rapportage: Genereer inzichten en rapporten
Integratie: Koppel Google Analytics met andere tools
Beste praktijken
Probleemoplossing
Authenticatie mislukt
Controleer uw OAuth-gegevens
Rate limit overschreden
Verminder de frequentie van verzoeken
Gegevens niet gevonden
Controleer machtigingen en beschikbaarheid van gegevens
Verbindingstime-out
Controleer netwerkconnectiviteit
Ondersteuning
Voor extra hulp bij de Google Analytics-integratie, neem contact op met [email protected]