Segment

Segment is een krachtig analysetool dat product- en marketingteams helpt gebruikersgedrag te begrijpen. Het stelt bedrijven in staat om hun first-party klantgegevens effectiever te verzamelen, transformeren, verzenden en opslaan. Segment vereenvoudigt databeheer en maakt het makkelijker om klantdata te koppelen aan andere tools in je stack, waardoor je minder tijd besteedt aan de installatie en meer tijd aan het analyseren van betekenisvolle data.

Door Segment te integreren met Document360 kun je bezoekersdata van de kennisbank naar Segment sturen en deze doorsturen naar elke analytics- of marketingbestemming in je stack.

Voordat je begint

• Je hebt een Segment-account nodig.
• Je hebt je Segment Write Key nodig. In Document360 wordt dit aangeduid als de Segment ID. Bekijk hieronder hoe je je Segment Write Key vindt .

Hoe vind je je Segment Schrijf Sleutel

Om Segment te integreren met Document360, moet je een bron aanmaken in Segment en de Write Key kopiëren.

1. Log in op je Segment-account.
2. Navigeer naar Verbindingen > Bronnen en klik vervolgens op Bron toevoegen.
3. Kies Javascript als brontype. Je kunt ernaar zoeken via de zoekbalk rechtsboven.
4. Klik op de Javascript-bronpagina op Bron toevoegen.
5. Op de pagina Bron-instellingen voer je een Naam in voor je bron. Je kunt optioneel een label (zoals dev of prod) en een website-URL toevoegen. Deze velden zijn optioneel en worden alleen gebruikt voor identificatie.

6. Na het aanmaken van de broncode vind je je Write Key op een van de volgende locaties:

   • Overzicht-tabblad: Zoek in het integratiecodeblok naar de regel analytics.load("YOUR_WRITE_KEY"). De waarde tussen aanhalingstekens is je Write Key.
   
   • Instellingen-tab: Kopieer onder API-sleutels de Write Key die daar wordt vermeld.
   

7. Gebruik deze schrijfsleutel in Document360 bij het configureren van de segmentintegratie (in het segment ID-veld ).

Hoe integreer je Segment met Document360

1. Navigeer in het Document360-portaal naar Connections () > Integraties () in de linker navigatiebalk.

2. Selecteer Segment uit de lijst met integraties en klik op Toevoegen.

3. Kies in het panel Nieuwe integratie toevoegen een configuratietype:

   Basisconfiguratie: gebruik dit om Segment snel te verbinden met je kennisbasis.

   • Beschrijving (optioneel): voeg een label toe om de integratie te identificeren.
   • Segment-ID: plak hier je Segment Write Key.

   Aangepaste configuratie: gebruik dit om aangepaste JavaScript-code toe te voegen voor geavanceerde tracking.

   • Beschrijving (optioneel): voeg een label toe om de integratie te identificeren.
   • Code: plak het volledige segmentfragment met je schrijfsleutel. Je kunt ook aangepaste evenementen toevoegen met behulp van analytics.track() of analytics.page().

4. Optioneel kunt u code-inclusie/uitsluitingsvoorwaarden uitbreiden om te bepalen waar de segmentintegratie van toepassing is op IP-adres, werkruimte of taal.

5. Klik op Toevoegen om de integratie te voltooien.

Controleer de integratie

Zodra je de integratie hebt voltooid, volg je deze stappen om te bevestigen dat Segment gegevens ontvangt uit je kennisbank van Document360.

1. Open je kennisbanksite op Document360 in een nieuw tabblad. Dit activeert een page gebeurtenis die Segment zou moeten vastleggen.
2. Ga in een apart tabblad naar je Segment-werkruimte.
3. Navigeer naar Connections > Sources en selecteer de bron die je voor Document360 hebt aangemaakt.
4. Ga naar het tabblad Debugger .
5. Je zou een page gebeurtenis in de debugger moeten zien verschijnen. Als je aangepaste gebeurtenissen zoals knoppenklikken hebt ingesteld, voer die acties dan nu uit en controleer of de bijbehorende gebeurtenissen verschijnen.

Als er geen gebeurtenissen in de Debugger verschijnen, controleer dan het volgende:

• Write Key is onjuist: controleer dubbel of je de juiste waarde hebt geplakt in het segment ID-veld.
• JavaScript-fout op de pagina: open de browserconsole en controleer op fouten die de scriptuitvoering kunnen blokkeren.
• Browserextensie blokkeert trackingscripts: probeer privacy-extensies zoals uBlock Origin of Ghostery uit te schakelen en laad de pagina opnieuw.
• Code-inclusie/uitsluitingsvoorwaarden die voorkomen dat het script kan draaien: bekijk eventuele IP-adres-, werkruimte- of taalfilters die in de integratie-instellingen zijn toegepast.

Best practices

• Gebruik de basisconfiguratie voor standaard paginaweergave-tracking. Het invoeren van je schrijfsleutel onder de Basic-configuratie is de snelste manier om data naar Segment te sturen. Gebruik Custom configuratie alleen wanneer je specifieke event tracking moet toevoegen naast paginaweergaven.
• Noem je Segment-bron duidelijk. Gebruik een beschrijvende naam zoals "Document360 Production" zodat het gemakkelijk te herkennen is in je Segment-werkruimte wanneer meerdere bronnen verbonden zijn.
• Gebruik de Segment Debugger om gebeurtenissen na eventuele wijzigingen te verifiëren. Telkens wanneer je de integratie-instellingen bijwerkt of nieuwe aangepaste events toevoegt, controleer dan het tabblad Debugger om te bevestigen dat de gebeurtenissen correct doorlopen.
• Routeer Segment-data naar je analytics- en marketingbestemmingen. Zodra Segment data van Document360 ontvangt, verbind deze dan met downstreamtools zoals Amplitude, Mixpanel of je CRM om de prestaties van de kennisbank te analyseren naast je andere productdata.
• Gebruik Code-inclusie/uitsluitingsvoorwaarden om intern verkeer uit te sluiten. Voeg je kantoor-IP-adres toe als uitsluiting om te voorkomen dat teambezoeken je analysegegevens vertekenen.

FAQ