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 rapport

  • metricHeaders: Informatie over de metrics in het rapport

  • rows: Array van datarijen met dimensie- en metricwaarden

  • totals: Samenvattende totalen voor het rapport

  • rowCount: 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 evenement

    • eventType (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-ID

  • summary: Evenementtitel

  • beschrijving: Evenementbeschrijving

  • start: Starttijdinformatie met dateTime en timeZone

  • end: Eindtijdinformatie met dateTime en timeZone

  • location: Evenementlocatie

  • attendees: Array van deelnemerobjecten met e-mailadressen

  • recurrence: Herhalingsregels indien van toepassing

  • htmlLink: Link om het evenement te bekijken in Google Agenda

  • created: Aanmaak-tijdstempel

  • updated: Tijdstempel van de laatste update

Evenement bijwerken

googleanalytics.updateEvent

Werkt een evenement bij

Bevestiging vereist: Ja

Parameters:

  • eventId (TEKST, Vereist): id van het evenement

    • eindTijd (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 worden

    • calendarId (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-ID

  • summary: Agenda-naam

  • beschrijving: Agenda-beschrijving

  • timeZone: Agenda-tijdzone

  • accessRole: Toegangsrol van de gebruiker voor deze agenda

  • backgroundColor: Agenda-kleur

  • foregroundColor: Tekstkleur voor deze agenda

  • selected: Of deze agenda geselecteerd is

  • primary: 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:00Z

    • timeMax (TEKST, Vereist): RFC3339-tijdstempel voor het einde van het te controleren tijdsbereik (exclusief). Voorbeeld: 2025-05-15T18:00:00Z

    • timeZone (TEKST, Optioneel): Tijdzone voor de reactie (optioneel, standaard UTC). Voorbeeld: Europe/Berlin

    • items (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-resourcetype

  • timeMin: Begin van het opgevraagde bereik

  • timeMax: Einde van het opgevraagde bereik

  • calendars: Object met beschikbaarheid-/bezettingsinformatie voor elke opgevraagde agenda

    • busy: Array van tijdsintervallen waarin de agenda bezet is

    • errors: 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 evenementen

    • daysToInclude (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 gespecificeerd

    • minuteBefore (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 evenementen

    • daysToInclude (NUMMER, Optioneel): Aantal dagen in de toekomst om naar evenementen te zoeken. Standaard is 30 dagen

    • searchQuery (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

1

Aan de slag

  • Schakel de Google Analytics-integratie in uw werkruimte-instellingen in

  • Authenticeer met OAuth

  • Test de verbinding met een eenvoudige leesbewerking

  • Verken beschikbare acties voor uw gebruikssituatie

2

Belangrijke overwegingen

  • Zorg voor de juiste authenticatiegegevens

  • Respecteer rate limits en API-quotums

  • Controleer instellingen voor gegevensprivacy

  • Test bewerkingen eerst in een veilige omgeving

Probleemoplossing

Probleem
Oplossing

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]

VorigeGoogle AgendaVolgendePinecone