API- und SDK-Endpunkte

Finden Sie die richtige Dashboard-URL, den REST API-Endpunkt und den SDK-Endpunkt für Ihre Braze-Instanz. Sie benötigen diese URLs, um sich anzumelden, API-Aufrufe durchzuführen und das SDK zu integrieren.

Braze verwaltet eine Reihe verschiedener Instanzen für unser Dashboard, SDK und REST-Endpunkte, die wir „Cluster“ nennen. Ihr Braze-Onboarding-Manager:in wird Ihnen mitteilen, auf welchem Cluster Sie sich befinden. Um mehr über das Braze SDK zu erfahren, besuchen Sie den Braze 101 Braze-Lernkurs.

Wenn Sie sich unter dashboard.braze.com anmelden, werden Sie automatisch an die richtige Cluster-Adresse weitergeleitet.

Wichtig

Verwenden Sie bei der Integration Ihres SDK den SDK-Endpunkt. Verwenden Sie bei Aufrufen an unsere REST API den REST-Endpunkt.

Weitere Informationen zum Zugriff auf die API finden Sie in unserem Artikel zur API-Übersicht.

Angepasste URLs

Anstelle des Standard-SDK-Endpunkts für Ihren Cluster können Sie das Braze SDK so konfigurieren, dass es seine Netzwerkanfragen an eine angepasste URL sendet, etwa an einen Proxy oder eine angepasste Domain. Die folgenden SDKs unterstützen angepasste URLs:

• Braze Swift SDK: Version 11.8.0 und höher
• Braze Android SDK: Version 2.11 und höher

Eine angepasste URL konfigurieren

Legen Sie Ihre angepasste URL an der Stelle fest, an der Sie bei der Initialisierung des SDK Ihren SDK-Endpunkt festlegen. Die vollständigen Integrationsschritte finden Sie unter Braze SDK integrieren.

• swift
• android

1
2
3
4
5
6

let configuration = Braze.Configuration(
  apiKey: "YOUR_APP_IDENTIFIER_API_KEY",
  endpoint: "YOUR_CUSTOM_URL"
)
let braze = Braze(configuration: configuration)
AppDelegate.braze = braze

1
2
3
4

BRZConfiguration *configuration = [[BRZConfiguration alloc] initWithApiKey:@"YOUR_APP_IDENTIFIER_API_KEY"
                                                                  endpoint:@"YOUR_CUSTOM_URL"];
Braze *braze = [[Braze alloc] initWithConfiguration:configuration];
AppDelegate.braze = braze;

1
2
3
4
5

<?xml version="1.0" encoding="utf-8"?>
<resources>
  <string translatable="false" name="com_braze_api_key">YOUR_APP_IDENTIFIER_API_KEY</string>
  <string translatable="false" name="com_braze_custom_endpoint">YOUR_CUSTOM_URL</string>
</resources>

1
2
3
4
5

BrazeConfig brazeConfig = new BrazeConfig.Builder()
  .setApiKey("YOUR_APP_IDENTIFIER_API_KEY")
  .setCustomEndpoint("YOUR_CUSTOM_URL")
  .build();
Braze.configure(this, brazeConfig);

1
2
3
4
5

val brazeConfig = BrazeConfig.Builder()
  .setApiKey("YOUR_APP_IDENTIFIER_API_KEY")
  .setCustomEndpoint("YOUR_CUSTOM_URL")
  .build()
Braze.configure(this, brazeConfig)

Ihre Proxy-Konfiguration testen

Testen Sie, ob Ihr Proxy wie erwartet funktioniert, bevor Sie Ihre App in der Produktion veröffentlichen. Um zu bestätigen, dass das SDK Anfragen an Ihre angepasste URL sendet, verwenden Sie ausführliches Logging:

1. Aktivieren Sie in Ihrem Entwicklungs-Build das ausführliche Logging, bevor Sie das SDK initialisieren. Den Code für jedes SDK finden Sie unter Ausführliches Logging.
2. Führen Sie Ihre App auf einem Testgerät oder Simulator aus. Das SDK sendet eine Anfrage, wenn eine Session beginnt.
3. Suchen Sie in Ihren Logs nach den Anfrageeinträgen und überprüfen Sie, ob die Anfrage-URL mit Ihrer angepassten URL übereinstimmt.
4. Überprüfen Sie, ob Ihr Proxy die Anfragen des SDK empfängt.

Wenn Sie unter Android keine Anfragen an Ihre angepasste URL sehen, überprüfen Sie Ihren API-Schlüssel und Ihre Endpunkt-Konfiguration. Beispiele dafür, wie Anfrageeinträge in den Logs aussehen, finden Sie unter Ausführliche Logs lesen.

Wichtig

Deaktivieren Sie das ausführliche Logging, bevor Sie Ihre App in der Produktion veröffentlichen.