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 Kundenprofil
- Sammelt automatisch Sitzungsdaten, Geräteinformationen und Push-Token
- 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 Ressourcenverbrauch. Wir passen automatisch die Rate an, mit der Nutzerdaten übertragen werden, abhängig von der Netzwerkqualität, und ermöglichen zusätzlich eine manuelle Netzwerksteuerung. Wir fassen API-Anfragen aus dem SDK automatisch in Batches zusammen, um sicherzustellen, dass Daten schnell protokolliert werden und gleichzeitig eine maximale Netzwerkeffizienz gewährleistet ist. Zudem ist die Datenmenge, 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 sich sehr gut verhält und nicht mit anderen SDKs in Ihrer App interferiert. Wenn Sie Probleme feststellen, die möglicherweise auf eine Inkompatibilität mit einem anderen SDK zurückzuführen sind, wenden Sie sich an den Braze-Support.
Standard-Analytics und Sitzungsbehandlung
Bestimmte Nutzerdaten werden automatisch von unserem SDK erfasst – zum Beispiel „Erste App-Nutzung“, „Letzte App-Nutzung“, „Gesamtanzahl der Sitzungen“, „Geräte-Betriebssystem“ usw. Wenn Sie unsere Integrationsleitfäden befolgen, um unsere SDKs zu implementieren, können Sie von dieser standardmäßigen Datenerfassung profitieren. Ein Blick auf diese Liste kann Ihnen helfen, die gleichen Informationen über Nutzer:innen nicht mehrfach zu speichern. Mit Ausnahme von Sitzungsstart und Sitzungsende zählen alle anderen automatisch erfassten Daten nicht zu Ihrer Datenpunkt-Nutzung.
Alle unsere Features sind konfigurierbar, aber es empfiehlt sich, das standardmäßige Datenerfassungsmodell vollständig zu implementieren.
Falls es für Ihren Anwendungsfall erforderlich ist, können Sie die Erfassung bestimmter Daten nach Abschluss der Integration einschränken.
Daten-Upload und -Download
Das Braze SDK speichert Daten (Sitzungen, angepasste Events usw.) zwischen und lädt sie regelmäßig hoch. Erst nachdem die Daten hochgeladen wurden, werden die Werte im Dashboard aktualisiert. Das Upload-Intervall berücksichtigt den Zustand des Geräts und wird durch die Qualität der Netzwerkverbindung bestimmt:
| Qualität der Netzwerkverbindung | Intervall für Datenübertragung |
|---|---|
| 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. Sobald die Verbindung wiederhergestellt ist, werden die Daten an Braze hochgeladen.
Braze sendet zu Beginn einer Sitzung Daten an das SDK, basierend darauf, in welche Segmente die Nutzer:innen zum Zeitpunkt der Sitzung fallen. Die neuen In-App Messages werden während der Sitzung nicht aktualisiert. Nutzerdaten, die während der Sitzung erfasst werden, werden jedoch kontinuierlich verarbeitet, sobald sie vom Client gesendet werden. Zum Beispiel erhalten inaktive Nutzer:innen (die die App seit mehr als 7 Tagen nicht mehr genutzt haben) bei ihrer ersten Sitzung nach der Rückkehr in die App weiterhin Inhalte, die auf inaktive Nutzer:innen ausgerichtet sind.
Datenerfassung blockieren
Es ist möglich (jedoch nicht empfohlen), die automatische Erfassung bestimmter Daten aus Ihrer SDK-Integration zu blockieren oder Prozesse, die dies tun, auf eine Zulassungsliste zu setzen.
Das Blockieren der Datenerfassung wird nicht empfohlen, da das Entfernen analytischer Daten die Fähigkeit Ihrer Plattform zur Personalisierung und zum Targeting verringert. Zum Beispiel:
- Wenn Sie die Standortintegration bei einem der SDKs nicht vollständig vornehmen, können Sie Ihr Messaging nicht basierend auf Sprache oder Standort personalisieren.
- Wenn Sie die Zeitzonenintegration nicht vornehmen, können Sie möglicherweise keine Nachrichten innerhalb der Zeitzone der Nutzer:innen senden.
- Wenn Sie bestimmte visuelle Geräteinformationen nicht integrieren, werden Nachrichteninhalte möglicherweise nicht für das jeweilige Gerät optimiert.
Wir empfehlen dringend, die SDKs vollständig zu integrieren, um die Funktionen unseres Produkts voll auszuschöpfen.
Sie können bestimmte Teile des SDK einfach nicht integrieren oder disableSDK für eine:n Nutzer:in verwenden. Diese Methode synchronisiert Daten, die vor dem Aufruf von disableSDK() protokolliert wurden, und bewirkt, dass alle nachfolgenden Aufrufe des Braze Web SDK für diese Seite und zukünftige Seitenladevorgänge ignoriert werden. Wenn Sie die Datenerfassung zu einem späteren Zeitpunkt wieder aufnehmen möchten, können Sie die Methode enableSDK() verwenden, um die Datenerfassung fortzusetzen. Weitere Informationen finden Sie in unserem Artikel Web-Tracking deaktivieren.
Sie können setDeviceObjectAllowlist verwenden, um das SDK so zu konfigurieren, dass nur eine Teilmenge der Geräteobjekt-Schlüssel oder -Werte gemäß einer festgelegten Zulassungsliste gesendet wird. Dies muss über setDeviceObjectAllowlistEnabled aktiviert werden.
Eine leere Zulassungsliste führt dazu, dass keine Gerätedaten an Braze gesendet werden.
Sie können eine Gruppe zulässiger Felder configuration.devicePropertyAllowList in Ihrer Braze.Configuration zuweisen, um eine Zulassungsliste für Gerätefelder festzulegen, die vom SDK erfasst werden. Die vollständige Liste der Felder ist in Braze.Configuration.DeviceProperty definiert. Um die Erfassung aller Gerätefelder zu deaktivieren, setzen Sie den Wert dieser Eigenschaft auf ein leeres Set ([]).
Standardmäßig werden alle Felder vom Braze Swift SDK erfasst. Das Entfernen einiger Geräteeigenschaften kann SDK-Features deaktivieren.
Weitere Details zur Verwendung finden Sie unter Speicher in der Swift-SDK-Dokumentation.
Welche SDK-Version verwende ich?
Sie können über das Dashboard die SDK-Version einer bestimmten App einsehen, indem Sie Einstellungen > App-Einstellungen aufrufen. Die Live-SDK-Version zeigt die höchste Braze-SDK-Version an, die von Ihrer aktuellsten Live-Anwendung bei mindestens 5 % Ihrer Nutzer:innen verwendet wird.
Wenn Sie eine iOS-App haben, können Sie bestätigen, dass Sie das Swift SDK anstelle des veralteten Objective-C iOS SDK verwenden, wenn Ihre Live-SDK-Version 5.0.0 oder höher ist – das war die erste veröffentlichte Version des Swift SDK.