Branch für Deeplinking

Branch ist eine mobile Verknüpfungsplattform für die Akquise, das Engagement und die Messung über Geräte, Kanäle und Plattformen hinweg, die einen ganzheitlichen Blick auf die Touchpoints der Nutzer:innen bietet.

Diese Integration wird von Branch gepflegt.

Über die Integration

Die Integration von Braze und Branch ermöglicht es Ihnen, Ihren Kund:innen bessere Erlebnisse zu bieten, indem Sie den Beginn ihrer User Journey richtig attributieren und sie über Deeplinks mit dem gewünschten Zielort verbinden können.

Tipp

Hilfe bei der Wahl des richtigen Deeplinking-Ansatzes für Ihren Anwendungsfall finden Sie im iOS-Deeplinking-Leitfaden.

Integration

Folgen Sie dem Leitfaden zur SDK-Integration von Branch, um Ihre Branch-Integration zum Laufen zu bringen. Im Folgenden finden Sie weitere Anwendungsfälle.

Unterstützung von iOS Universal Links

Zur Unterstützung des Versendens von iOS Universal Links als Deeplinks aus Braze heraus:

1. Schritt: Branch Universal Links einrichten

Folgen Sie der Dokumentation von Branch, um Universal Links einzurichten. Im Rahmen dieser Einrichtung hostet Branch die AASA-Datei automatisch auf Ihrer Branch-Link-Domain (zum Beispiel yourapp.app.link).

2. Schritt: Associated Domains konfigurieren

Navigieren Sie in Xcode zu Ihrem App-Target > Signing & Capabilities und fügen Sie Ihre Branch-Link-Domain unter Associated Domains hinzu:

1
2
applinks:yourapp.app.link
applinks:yourapp-alternate.app.link

Falls Sie eine benutzerdefinierte Branch-Domain verwenden, fügen Sie diese ebenfalls hinzu.

3. Schritt: Universal Links in Braze weiterleiten

Setzen Sie forwardUniversalLinks in Ihrer Braze-SDK-Konfiguration auf true, damit das SDK Universal Links an den AppDelegate Ihrer App weiterleitet:

• swift
• objective-c

1
2
3
let configuration = Braze.Configuration(apiKey: "<BRAZE_API_KEY>", endpoint: "<BRAZE_ENDPOINT>")
configuration.forwardUniversalLinks = true
let braze = Braze(configuration: configuration)

1
2
3
4
BRZConfiguration *configuration = [[BRZConfiguration alloc] initWithApiKey:@"<BRAZE_API_KEY>"
                                                                  endpoint:@"<BRAZE_ENDPOINT>"];
configuration.forwardUniversalLinks = YES;
Braze *braze = [[Braze alloc] initWithConfiguration:configuration];

4. Schritt: Branch-Links mit BrazeDelegate routen

Implementieren Sie BrazeDelegate, um Branch-Links abzufangen, bevor Braze sie verarbeitet. So kann Branch den Link verarbeiten und sein eigenes Routing durchführen:

• swift
• objective-c

1
2
3
4
5
6
7
8
9
10
func braze(_ braze: Braze, shouldOpenURL context: Braze.URLContext) -> Bool {
  if let host = context.url.host,
     host.contains("app.link") || host.contains("yourdomain.com") {
    // Let Branch handle this link
    Branch.getInstance.handleDeepLink(context.url)
    return false
  }
  // Let Braze handle all other links
  return true
}

1
2
3
4
5
6
7
8
- (BOOL)braze:(Braze *)braze shouldOpenURL:(BRZURLContext *)context {
  NSString *host = context.url.host;
  if (host && ([host containsString:@"app.link"] || [host containsString:@"yourdomain.com"])) {
    [[Branch getInstance] handleDeepLink:context.url];
    return NO;
  }
  return YES;
}

Ersetzen Sie yourdomain.com gegebenenfalls durch Ihre benutzerdefinierte Branch-Domain.

Deeplinking in E-Mails

Lesen Sie die Dokumentation zu Universal Links und App Links oder die Dokumentation von Branch, um Deeplinking aus E-Mails einzurichten, die über Braze gesendet werden.

Das Verknüpfen mit Telefonnummern (Anhängen von tel an href) wird in der Gmail-App für iOS nicht unterstützt, es sei denn, Nutzer:innen gewähren der App Anrufberechtigungen.

Abhängig von Ihrem ESP sind möglicherweise zusätzliche Anpassungen erforderlich, um Universal Links mit Klick-Tracking zu unterstützen. Diese Informationen finden Sie in unserem entsprechenden Artikel. Sie können auch die folgenden Referenzen heranziehen, um mehr zu erfahren:

• SendGrid
• SparkPost

Fehlerbehebung

Wenn Branch-Links aus Braze-Campaigns nicht wie erwartet funktionieren, folgen Sie diesen Schritten.

Überprüfen, ob der Link außerhalb von Braze funktioniert

Öffnen Sie den Branch-Link aus der Notizen-App auf einem physischen iOS-Gerät. Wenn Ihre App nicht geöffnet wird:

• Das Problem liegt in Ihrer Branch- oder AASA-Konfiguration, nicht bei Braze.
• Validieren Sie Ihre Branch-AASA unter https://yourapp.app.link/.well-known/apple-app-site-association.
• Prüfen Sie, ob Ihre Bundle-ID und Team-ID im Branch-Dashboard übereinstimmen.

Duales Logging aktivieren

1. Braze: Aktivieren Sie ausführliches Logging und suchen Sie nach Opening '<URL>':-Einträgen. Dies bestätigt, dass das SDK den Link empfangen hat.
2. Branch: Aktivieren Sie den Branch-Testmodus und prüfen Sie das Branch-Dashboard auf Link-Klick-Ereignisse.
3. Vergleich: Wenn Braze den Link protokolliert, Branch aber keinen Klick registriert, fängt die BrazeDelegate-Routing-Logik den Link wahrscheinlich nicht korrekt ab. Prüfen Sie, ob der Domain-Abgleich in shouldOpenURL Ihre Branch-Domain enthält.

Häufige Probleme

Weitere Szenarien zur Deeplinking-Fehlerbehebung finden Sie unter Deeplinking-Fehlerbehebung.