SDK-Übersicht für Entwickler:innen
Bevor Sie mit der Integration der Braze SDKs beginnen, werden Sie sich vielleicht fragen, was genau Sie da eigentlich entwickeln und integrieren. Vielleicht sind Sie neugierig, wie Sie das SDK weiter an Ihre Bedürfnisse anpassen können. Dieser Artikel hilft Ihnen, alle Ihre Fragen zum SDK zu beantworten.
Sind Sie ein Marketer, der einen grundlegenden Überblick über das SDK benötigt? Sehen Sie sich stattdessen unsere Übersicht für Marketer an.
Kurz gesagt, das Braze SDK:
- Sammelt und synchronisiert Nutzerdaten in einem konsolidierten Nutzerprofil
- Sammelt automatisch Sitzungsdaten, Geräteinformationen und Push-Tokens
- Erfasst Marketingdaten und angepasste Daten speziell für Ihr Unternehmen
- Unterstützt Push-Benachrichtigungen, In-App Messages und Content-Card-Nachrichtenkanäle
Sehen Sie sich das folgende Video an, um eine kurze Einführung in die Grundlagen der Braze SDK-Integration und die Kernfunktionalität zu erhalten.
App-Performance
Braze sollte keine negativen Auswirkungen auf die Performance Ihrer App haben.
Die Braze SDKs haben einen sehr geringen Platzbedarf. Wir ändern die Flush-Rate der Nutzerdaten automatisch in Abhängigkeit von der Qualität des Netzwerks und ermöglichen darüber hinaus eine manuelle Netzwerksteuerung. Wir stapeln API-Anfragen aus dem SDK automatisch, um sicherzustellen, dass die Daten schnell erfasst werden und gleichzeitig die maximale Netzwerkeffizienz erhalten bleibt. Und schließlich ist die Menge der Daten, die bei jedem API-Aufruf vom Client an Braze gesendet wird, äußerst gering.
SDK-Kompatibilität
Das Braze SDK ist so konzipiert, dass es andere SDKs in Ihrer App nicht beeinträchtigt. Sollten Sie Probleme feststellen, die Ihrer Meinung nach auf Inkompatibilität mit einem anderen SDK zurückzuführen sind, wenden Sie sich bitte an den Braze-Support.
Standard-Analytics und Sitzungsbehandlung
Bestimmte Nutzerdaten werden von unserem SDK automatisch erfasst, z. B. die zuerst verwendete App, die zuletzt verwendete App, die Gesamtzahl der Sitzungen, das Betriebssystem des Geräts usw. Wenn Sie unseren Integrationsleitfäden folgen, um unsere SDKs zu implementieren, können Sie die Vorteile dieser Standard-Datenerfassung nutzen. Wenn Sie diese Liste überprüfen, können Sie vermeiden, die gleichen Informationen über Nutzer:innen mehrfach zu speichern. Mit Ausnahme des Sitzungsbeginns und des Sitzungsendes werden alle anderen automatisch erfassten Daten nicht auf Ihre Datenpunkt-Nutzung angerechnet.
Alle unsere Features sind konfigurierbar, aber es empfiehlt sich, das Standardmodell für die Datenerfassung vollständig zu implementieren.
Falls erforderlich können Sie nach Abschluss der Integration die Erfassung bestimmter Daten beschränken.
Daten hoch- und herunterladen
Das Braze SDK speichert Daten (Sitzungen, angepasste Events usw.) im Cache und lädt sie in regelmäßigen Abständen hoch. Erst nachdem die Daten hochgeladen wurden, werden die Werte im Dashboard aktualisiert. Das Upload-Intervall berücksichtigt den Zustand des Geräts und richtet sich nach der Qualität der Netzwerkverbindung:
| Qualität der Netzwerkverbindung | Data-Flush-Intervall |
|---|---|
| Sehr gut | 10 Sekunden |
| Gut | 30 Sekunden |
| Schlecht | 60 Sekunden |
Wenn keine Netzwerkverbindung besteht, werden die Daten lokal auf dem Gerät zwischengespeichert, bis die Netzwerkverbindung wiederhergestellt ist. Wenn die Verbindung wiederhergestellt ist, werden die Daten auf Braze hochgeladen.
Braze sendet zu Beginn einer Sitzung Daten an das SDK, die darauf basieren, in welche Segmente die Nutzer:innen zum Zeitpunkt der Sitzung fallen. Die neuen In-App-Nachrichten werden während der Sitzung nicht aktualisiert. Allerdings werden die Nutzerdaten während der Sitzung kontinuierlich verarbeitet, wenn sie vom Client gesendet werden. Inaktive Nutzer:innen (die die App das letzte Mal vor mehr als 7 Tagen genutzt haben) erhalten zum Beispiel bei ihrer ersten Sitzung in der App immer noch gezielte Inhalte.
Sperrung der Datenerfassung
Es ist möglich (wird aber nicht empfohlen), die automatische Erfassung bestimmter Daten aus Ihrer SDK-Integration zu blockieren bzw. Prozesse, die dies tun, zuzulassen.
Die Sperrung der Datenerfassung ist nicht empfehlenswert, da die Entfernung von analytischen Daten die Kapazität Ihrer Plattform für Personalisierung und Targeting verringert. Zum Beispiel:
- Wenn Sie keine vollständige Integration für den Standort auf einem der SDKs vornehmen, können Sie Ihre Nachrichten nicht anhand von Sprache oder Standort personalisieren.
- Wenn Sie die Integration für die Zeitzone nicht wählen, können Sie möglicherweise keine Nachrichten innerhalb der Zeitzone von Nutzer:innen versenden.
- Wenn Sie sich dafür entscheiden, keine visuellen Informationen für bestimmte Geräte zu integrieren, wird der Inhalt der Nachrichten möglicherweise nicht für dieses Gerät optimiert.
Wir empfehlen Ihnen dringend, die SDKs vollständig zu integrieren, um die Möglichkeiten unseres Produkts voll auszuschöpfen.
Sie können entweder bestimmte Teile des SDK einfach nicht integrieren oder disableSDK für spezifische Nutzer:innen verwenden. Diese Methode synchronisiert die Daten, die vor dem Aufruf von disableSDK() aufgezeichnet wurden, und führt dazu, dass alle nachfolgenden Aufrufe des Braze Web SDK für diese Seite und zukünftige Seitenladungen ignoriert werden. Wenn Sie die Datenerfassung zu einem späteren Zeitpunkt wieder aufnehmen möchten, können Sie mit der Methode enableSDK() die Datenerfassung fortsetzen. Mehr dazu erfahren Sie in unserem Artikel Deaktivieren von Web-Tracking.
Sie können mit setDeviceObjectAllowlist das SDK so konfigurieren, dass es nur eine Teilmenge der Schlüssel oder Werte des Geräteobjekts gemäß einer festgelegten Allowlist sendet. Dies muss über setDeviceObjectAllowlistEnabled aktiviert werden.
Eine leere Allowlist führt dazu, dass keine Gerätedaten an Braze gesendet werden.
Sie können die zulässigen Felder zu configuration.devicePropertyAllowList in Ihrer Braze.Configuration zuweisen, um eine Allowlist für Gerätefelder anzulegen, die vom SDK erfasst werden. Die vollständige Liste der Felder ist definiert in Braze.Configuration.DeviceProperty. Um die Erfassung aller Gerätefelder zu deaktivieren, setzen Sie den Wert dieser Eigenschaft auf ein leeres Set ([]).
Standardmäßig werden alle Felder durch das Braze Swift SDK erfasst. Das Entfernen einiger Geräteeigenschaften kann SDK-Features deaktivieren.
Weitere Einzelheiten zur Verwendung finden Sie unter Speicherung in der Dokumentation zum Swift SDK.
Welche Version des SDK verwende ich?
Sie können die SDK-Version einer bestimmten App im Dashboard unter Einstellungen > App-Einstellungen sehen. Unter Live SDK Version finden Sie die höchste Braze SDK-Version, die von Ihrer letzten Live-App für mindestens 5 % Ihrer Nutzer:innen verwendet wurde.
Wenn Sie eine iOS-App haben, können Sie sich vergewissern, dass Sie das Swift SDK anstelle des alten Objective-C iOS SDK verwenden, wenn Ihre Live SDK Version gleich oder höher als 5.0.0 ist, was die erste veröffentlichte Version des Swift SDK war.