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 vous permettant d’attribuer correctement le début de leur parcours utilisateur et de les connecter via des deep links à l’emplacement souhaité.

Conseil

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

Intégration

Suivez le guide d’intégration SDK de Branch pour configurer votre intégration Branch. Consultez les sections suivantes pour des cas d’usage supplémentaires.

Prise en charge des liens universels iOS

Pour prendre en charge l’envoi de liens universels iOS en tant que deep links 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 vers le 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 : Router 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 App Links ou la documentation de Branch pour configurer la création de liens profonds à partir des e-mails envoyés via Braze.

L’ajout de liens vers des numéros de téléphone (en ajoutant tel à href) n’est pas pris en charge dans l’application Gmail pour iOS, sauf si l’utilisateur accorde les autorisations d’appel à l’application.

Selon votre fournisseur de services d’e-mailing, une personnalisation supplémentaire peut être nécessaire pour prendre en charge les liens universels avec suivi de 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 dans les Campaigns 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 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 Branch et consultez le tableau de bord Branch pour les événements de clic sur les liens.
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 d’autres scénarios de résolution des problèmes de deep linking, consultez Résolution des problèmes de deep linking.