Branch pour la création de liens profonds

Branch est une plateforme de liaison mobile utilisée pour acquérir, engager et mesurer à travers les appareils, les canaux et les plateformes en fournissant une vue globale des points de contact utilisateur.

Cette intégration est maintenue par Branch.

À propos de l’intégration

L’intégration de Braze et Branch vous permet d’offrir de meilleures expériences à vos clients en attribuant correctement le début de leur parcours utilisateur et en les connectant par des liens profonds à l’emplacement prévu.

Conseil

Pour vous aider à choisir la bonne approche de création de liens profonds pour votre cas d’utilisation, consultez le guide de création de liens profonds iOS.

Intégration

Consultez le guide d’intégration du SDK de Branch pour mettre en place votre intégration Branch. Reportez-vous aux sections suivantes pour des cas d’utilisation supplémentaires.

Prise en charge des liens universels iOS

Pour prendre en charge l’envoi de liens universels iOS en tant que liens profonds depuis Braze :

Étape 1 : Configurer les liens universels Branch

Suivez la documentation de Branch pour configurer les liens universels. Dans le cadre de cette configuration, Branch héberge automatiquement le fichier AASA sur votre domaine de lien Branch (par exemple, yourapp.app.link).

Étape 2 : Configurer les domaines associés

Dans Xcode, accédez à la cible de votre application > Signing & Capabilities et ajoutez votre domaine de lien Branch sous Associated Domains :

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

Si vous utilisez un domaine Branch personnalisé, ajoutez-le également.

Étape 3 : Transférer les liens universels dans Braze

Définissez forwardUniversalLinks sur true dans la configuration de votre SDK Braze afin que le SDK transfère les liens universels au AppDelegate de votre application :

• 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];

Étape 4 : Acheminer les liens Branch avec BrazeDelegate

Implémentez BrazeDelegate pour intercepter les liens Branch avant que Braze ne les traite. Cela permet à Branch de traiter le lien et d’effectuer son propre routage :

• 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;
}

Remplacez yourdomain.com par votre domaine Branch personnalisé, le cas échéant.

Création de liens profonds dans les e-mails

Consultez la documentation sur les liens universels et les liens applicatifs ou consultez la documentation de Branch pour mettre en place la création de liens profonds à partir d’e-mails envoyés par l’intermédiaire de Braze.

La liaison avec des numéros de téléphone (en ajoutant tel à href) n’est pas prise en charge dans l’application Gmail pour iOS, sauf si l’utilisateur accorde des autorisations d’appel à l’application.

En fonction de votre ESP, une personnalisation supplémentaire peut être nécessaire pour prendre en charge les liens universels avec suivi des clics. Ces informations sont détaillées dans notre article dédié. Vous pouvez également consulter les références suivantes pour en savoir plus :

• SendGrid
• SparkPost

Résolution des problèmes

Si les liens Branch ne fonctionnent pas comme prévu depuis les campagnes Braze, suivez ces étapes.

Vérifier que le lien fonctionne en dehors de Braze

Ouvrez le lien Branch depuis l’application Notes sur un appareil iOS physique. S’il n’ouvre pas votre application :

• Le problème se situe dans votre configuration Branch ou AASA, pas dans Braze.
• Validez votre fichier AASA Branch à l’adresse https://yourapp.app.link/.well-known/apple-app-site-association.
• Vérifiez que votre Bundle ID et votre Team ID correspondent dans le tableau de bord Branch.

Activer la double journalisation

1. Braze : Activez la journalisation détaillée et recherchez les entrées Opening '<URL>':. Cela confirme que le SDK a reçu le lien.
2. Branch : Activez le mode test de Branch et vérifiez les événements de clic sur les liens dans le tableau de bord Branch.
3. Comparez : Si Braze enregistre le lien mais que Branch ne détecte pas de clic, la logique de routage du BrazeDelegate n’intercepte probablement pas le lien correctement. Vérifiez que la correspondance de domaine dans shouldOpenURL inclut votre domaine Branch.

Problèmes courants

Pour plus de scénarios de résolution des problèmes de liens profonds, consultez Résolution des problèmes de liens profonds.