Über Google Tag Manager für das Internet
Mit dem Google Tag Manager (GTM) können Sie per Fernzugriff Tags auf Ihrer Website hinzufügen, entfernen und bearbeiten, ohne dass eine Freigabe des Produktionscodes oder technische Ressourcen erforderlich sind. Braze bietet die folgenden Templates für das Internet-SDK an:
| Tag-Typ | Anwendungsfall |
|---|---|
| Initialisierungs-Tag | Mit diesem Tag können Sie das Braze Internet-SDK integrieren, ohne den Code Ihrer Website ändern zu müssen. |
| Aktions-Tag | Mit diesem Tag können Sie Content Cards erstellen, Nutzer:innen-Attribute festlegen und die Datenerfassung verwalten. |
Tag-Sequenzierung für Braze-Aktions-Tags
Das Braze-Initialisierungs-Tag muss vor allen Tags ausgelöst werden, die Braze-SDK-Methoden aufrufen (wie braze.getUser(), braze.logCustomEvent() oder braze.logPurchase()). Wenn diese Methoden ausgelöst werden, bevor das SDK initialisiert ist, können Fehler wie Uncaught TypeError: Cannot read properties of undefined (reading 'getUser') auftreten.
So konfigurieren Sie die Tag-Sequenzierung im Google Tag Manager:
- Öffnen Sie das Tag, das Braze-SDK-Methoden aufruft (z. B. ein Custom-HTML-Tag oder ein Braze-Aktions-Tag).
- Gehen Sie zu Advanced Settings > Tag Sequencing.
- Wählen Sie A tag that fires before [this tag] is fired.
- Wählen Sie Ihr Braze Initialization-Tag aus.
Dadurch wird sichergestellt, dass das SDK vollständig geladen ist, bevor andere Tags versuchen, Braze-Methoden aufzurufen.
Weitere Informationen finden Sie unter Tag-Sequenzierung für angepasste Events überprüfen.
Fehlerbehebung
Internet-SDK-Sitzungen werden der falschen Nutzer:in zugeordnet
Wenn GTM Braze-Initialisierungs- oder Event-Tags auslöst, bevor Ihre App die angemeldete Nutzer:in identifiziert, können Sitzungen und Events dem falschen Profil zugeordnet werden. Initialisieren Sie das Internet-SDK, rufen Sie changeUser() mit der external_id der angemeldeten Nutzer:in auf und rufen Sie dann openSession() auf, bevor Tags Events protokollieren oder Attribute festlegen. Verwenden Sie die GTM-Tag-Sequenzierung oder Consent-Trigger, damit Braze-Tags erst nach Abschluss Ihres Authentifizierungsflusses ausgelöst werden.
Internet-SDK-Konsolenprotokollierung mit Shopify oder Script-Tag-Installationen
Das Shopify-App-Embed lädt das Internet-SDK mit deaktivierter Konsolenprotokollierung. Aktivieren Sie die Protokollierung in Ihrem GTM-Initialisierungs-Tag oder in den initialize()-Optionen. Das Braze-Dashboard enthält keine Protokollierungssteuerung für diese Loader.
Wenn Braze-Protokolle in der Browser-Konsole erscheinen, entfernen Sie enableLogging: true aus dem GTM-Initialisierungs-Tag oder dem angepassten HTML, bevor Sie in die Produktion veröffentlichen. Verwenden Sie nach der Initialisierung toggleLogging() oder den URL-Parameter ?brazeLogging=true. Die vollständigen Optionen des Internet-SDK finden Sie unter Ausführliche Protokollierung.
Wenn Braze nicht initialisiert wird oder Events nicht wie erwartet angezeigt werden, überprüfen Sie, ob Ihr GTM-Container veröffentlicht ist, ob Trigger und Tag-Auslösereihenfolge mit Ihrer SDK-Lebenszyklus- und Initialisierungsstrategie übereinstimmen und ob Testgeräte keine Braze-Endpunkte blockieren.
Überprüfen Sie bei Initialisierungsfehlern, ob das Braze-Tag oder der angepasste Tag-Anbieter den erwarteten actionType und die erwarteten Parameter erhält (siehe die Tabs für Android, Swift und Internet auf dieser Seite). Um ausführliche Protokollierung bei der Validierung von GTM-ausgelösten Events zu aktivieren, schalten Sie die SDK-Debug-Protokollierung Ihrer Plattform ein, wie in den Plattform-Integrationsleitfäden beschrieben, die über diese Tabs verlinkt sind.