Firebase SDK stuurt nu app-data naar server-side GTM: wat je moet weten en doen
Een recente update van de Firebase SDK maakt het mogelijk om iOS- en Android-app-data rechtstreeks naar een server-side Google Tag Manager-container te routeren. Dit geeft analytics- en tagging-specialisten eindelijk zicht op de Firebase-meetstroom én de mogelijkheid om app-events via sGTM door te sturen naar GA4, Meta CAPI of andere platformen. De implementatie vereist aanpassingen op vier plekken: de app-codebase, de GA4-datastreamconfiguratie, de sGTM-container en optioneel de Xcode-buildconfiguratie.
Wat er veranderd is
De Firebase SDK voor Android en iOS ondersteunt nu integratie met server-side Tag Manager. App-measurement-verzoeken die voorheen rechtstreeks naar Google-servers gingen, kunnen voortaan worden omgeleid naar een eigen sGTM-endpoint. Voor web-implementaties was dit al jaren mogelijk; voor app-contexten is dit een wezenlijk nieuwe mogelijkheid. De Firebase Analytics SDK blijft het dispatch-mechanisme verzorgen, maar de bestemming is nu zelf in te stellen.
Vier stappen om de koppeling werkend te krijgen
Stap één: pas Info.plist aan in de iOS-app. Voeg een CFBundleURLTypes-entry toe met het bundle-ID van de app als URL-identifier en stel het URL-scheme in als tagmanager.sgtm.c.<bundle ID>. Voeg daarnaast de sleutel GOOGLE_ANALYTICS_SGTM_UPLOAD_ENABLED in op true. Stap twee: voeg code toe aan een lifecycle-methode — bijvoorbeeld SceneDelegate.swift — zodat de app geopend kan worden via een QR-code vanuit de sGTM-preview. Dit activeert de preview-modus voor app-requests. Stap drie: ga in de GA4-property naar Admin → Data collection and modification → Data streams, selecteer de app-datastream, open Configure SDK settings en vervolgens Configure server-side Tag Manager. Zet de toggle aan, vul de server-container-URL in en kies voor welk aandeel van het verkeer de omleiding geldt. Begin met debug-apparaten en schaal daarna op naar 25%, 50%, 75% of 100% van het totale verkeer. Stap vier: voeg in de sGTM-container een ingebouwde GA4 (App) Client toe. Deze vereist geen verdere configuratie en verwerkt inkomende app-measurement-verzoeken automatisch.
Wat er in de event data zit
De inkomende verzoeken zijn POST-requests met een geserialiseerde protobuf-body. De GA4 (App) Client deserialiseert deze automatisch en zet ze om naar event-data-objecten. Per event zijn velden beschikbaar zoals app_id, app_version, event_name, firebase_id, ip_override, language, x-ga-device_model, x-ga-platform, x-ga-os_version en uitgebreide systeemeigenschappen inclusief consent-diagnostics en DMA-velden. Dit is informatie die voorheen alleen met speciale proxy-tools zichtbaar te maken was.
Beperkingen die je nu al moet kennen
Er is een harde afhankelijkheid van een actieve GA4-property: de Firebase SDK haalt zijn configuratiesignalen — inclusief de server-container-URL — op uit GA4. Een volledig geïsoleerde setup zonder GA4 is niet mogelijk. Dat verschilt fundamenteel van web-implementaties, waar een dummy Measurement ID volstaat om events naar sGTM te sturen. De GA4-koppeling moet actief blijven, ook als je vanuit sGTM geen hits terugstuurt naar GA4. Verder werken tags die afhankelijk zijn van first-party cookies of data van de Google Tag — zoals veel Facebook CAPI- en Piwik PRO-templates — niet out-of-the-box met Firebase-data. Voor Meta CAPI geldt specifiek dat een Campaign ID-parameter als extra parameter in de app-code verzameld moet worden om app-sessies te koppelen aan deep links of kliks vanuit de Facebook-app.
Praktische aandachtspunten voor GTM- en GA4-beheerders
Propagatie van de GA4-configuratiewijziging naar de Firebase SDK kan tijd kosten; verschijnt er geen data in sGTM, wacht dan een uur en probeer opnieuw. In Xcode kun je Firebase-logging inschakelen via het productschema om te controleren of verzoeken inderdaad naar het sGTM-endpoint worden gestuurd. Controleer daarnaast de server-side logboeken — bijvoorbeeld Logs Explorer in Google Cloud Platform — op binnenkomende app-measurement-requests. De GA4-tag in sGTM converteert app-measurement-payloads automatisch naar GA4-formaat en stuurt ze naar het app-measurement.com-endpoint, niet naar het reguliere /collect-endpoint. Transformations in sGTM werken ook op app-events: je kunt event-namen en parameters aanpassen voordat de tag de payload verstuurt.