Party record data naar Google Tag Manager sturen

Gegevens over een herkende organisatie, oftewel de party record data, kunnen worden verstuurd naar Google Tag Manager.

Wanneer SalesFeed een bedrijf herkent op jouw website, worden alle beschikbare gegevens over dat bedrijf opgeslagen in het zogenaamde party record. Dit bevat waardevolle informatie zoals de bedrijfsnaam, SBI-code, vestigingsplaats en meer. Je kunt deze data automatisch doorsturen naar Google Tag Manager, om vervolgens bijvoorbeeld analyses te verrijken of custom dimensions te vullen in Google Adwords en Google Analytics.

Op deze pagina leer je welke velden beschikbaar zijn in het party record en hoe je deze data via een trigger en een JavaScript-actie naar Google Tag Manager stuurt.

Welke gegevens zitten in het party record?

Het party record bevat alle beschikbare informatie over een herkend bedrijf. Voor een volledig overzicht van alle beschikbare velden, zie de pagina Bedrijfsinformatie.

De velden in het party record zijn onder andere:

• Bedrijfsnaam (party.name)

• Vestigingsplaats (party.plaats)

• Kamer van Koophandel nummer (party.kvknummer)

• Rechtsvorm (party.rechtsvorm)

• SBI-code (party.sbi)

• SBI omschrijving (party.sbiomschrijving)

• Aantal medewerkers (party.fte)

Hoe stuur je party record data naar Google Tag Manager?

Om gegevens uit het party record naar Google Tag Manager te sturen, doorloop je de volgende stappen:

Stap 1: Maak een datalayer aan in Google Tag Manager

Zorg ervoor dat je in Google Tag Manager een datalayer hebt aangemaakt waarin SalesFeed de bedrijfsgegevens kan plaatsen. Dit is een structuur waarin data tijdelijk wordt opgeslagen zodat Google Tag Manager deze kan oppikken en gebruiken in tags.

Stap 2: Maak een trigger aan in SalesFeed

Bepaal wanneer je de party record data wilt versturen. Dit doe je door een trigger aan te maken in SalesFeed.

Tip: Stel de trigger bijvoorbeeld in op de eerste pageview van een bezoek in combinatie met een rate limit, zodat de data niet bij elke heartbeat opnieuw wordt verstuurd (zie verderop bij "Let op").

Stap 3: Koppel een "Code Uitvoeren" actie

Koppel aan jouw trigger een actie van het type Code Uitvoeren. Dit is een JavaScript-actie waarmee je data uit het party record kunt selecteren en naar de datalayer van Google Tag Manager kunt pushen.

Meer informatie over de actie "Code Uitvoeren" vind je op de pagina JavaScript code uitvoeren.

try {
  var party = {{{@party.json}}};
  if (party.sbi) {
    dataLayer.push({
      event: 'bedrijf_herkend',
      sbi: party.sbi,
      bedrijfsnaam: party.name,
      plaats: party.city
    });
  }
} catch(e) {}

Uitleg van de code:

• var party = {{{@party.json}}}: haalt alle gegevens op uit het party record

• if (party.sbi): controleert of er een SBI-code aanwezig is (zo weet je dat er een bedrijf is herkend)

• dataLayer.push({...}): stuurt de geselecteerde velden naar de datalayer van Google Tag Manager

• event: 'bedrijf_herkend': dit is de naam van het event dat je in Google Tag Manager kunt gebruiken om een tag te triggeren

• Je kunt naar wens extra velden toevoegen, bijvoorbeeld medewerkers: party.fte

Party record bekijken via console (voor testen)

Wil je eerst zien welke gegevens er precies in het party record zitten voordat je data gaat doorsturen? Dan kun je onderstaande testcode gebruiken:

Stap 1: Maak een trigger aan met als expressie jouw IP-adres (zo wordt de code alleen bij jou uitgevoerd).

Stap 2: Koppel een "Code Uitvoeren" actie aan deze trigger en plaats daarin de volgende code:

try {
  var party = {{{@party.json}}};
  if (party.sbi) {
    console.log(party);
    // dataLayer.push({event:'bedrijf_herkend', sbi: party.sbi})
  }
} catch(e) {}

Let op: Deze code stuurt géén data naar Google Tag Manager. In plaats daarvan toont het de inhoud van het party record in de console van je browser (open met F12 > Console). Zo zie je precies welke velden beschikbaar zijn en welke waarden erin staan.

Zodra je de console-uitvoer hebt gezien, kun je de regel dataLayer.push({...}) activeren door de comment-tekens (//) te verwijderen.

Let op: heartbeat en rate limiting

SalesFeed controleert standaard elke 5 seconden (via de zogenaamde heartbeat) of triggers actief moeten worden. Dit betekent dat jouw "Code Uitvoeren" actie mogelijk meerdere keren per bezoek en per pageview, wordt uitgevoerd.

Om te voorkomen dat dezelfde data ongewent meerdere keren naar Google Tag Manager wordt gestuurd, kun je het volgende doen:

• Stel een rate limit in op de Actie (bijvoorbeeld: maximaal eens per dag). Lees hier meer over rate limit.

• Voeg aan de trigger een extra conditie toe, zoals "alleen bij de eerste pageview van een bezoek" (kies hier voor de expressie: de eerste event van een sessie).

Meer informatie over de heartbeat vind je op de pagina Introductie trigger module - Realtime heartbeat.

Veelgestelde vragen

Kan ik alle bedrijfsgegevens naar Google Tag Manager sturen? Ja, je kunt zoveel velden uit het party record doorsturen als je wilt. Voeg deze toe aan het dataLayer.push({...}) commando. Controleer via de console welke velden beschikbaar zijn en neem alleen mee wat je echt nodig hebt.

Hoe voorkom ik dat data meerdere keren wordt verstuurd? Gebruik een rate limit op de trigger of stel een conditie in zoals "alleen bij de eerste pageview van een bezoek". Dit voorkom je dat de heartbeat de actie elke 5 seconden opnieuw triggert.