Skip to content

Configuration initiale du SDK

Découvrez comment installer le SDK Braze pour Xamarin. L’installation du SDK Braze vous fournira des fonctionnalités d’analytique de base ainsi que des messages in-app opérationnel avec lesquels vous pouvez engager vos utilisateurs.

Étape 1 : Obtenir la liaison Xamarin

Une liaison Xamarin est une manière d’utiliser les bibliothèques natives dans les applications Xamarin. L’implémentation d’une liaison consiste à créer une interface C# avec la bibliothèque, puis à utiliser cette interface dans votre application. Consultez la documentation de Xamarin. Il existe deux façons d’inclure la liaison du SDK de Braze : en utilisant NuGet ou en compilant à partir de la source.

La méthode d’intégration la plus simple consiste à obtenir le SDK de Braze à partir du référentiel central NuGet.org. Dans la barre latérale Visual Studio, cliquez avec le bouton droit de la souris le dossier Packages et cliquez sur Add Packages.... Recherchez « Braze » et installez le package BrazePlatform.BrazeAndroidBinding dans votre projet.

La deuxième méthode d’intégration consiste à inclure la source de liaison. Sous appboy-component/src/androidnet6, vous trouverez notre code de source de liaison. Si vous ajoutez une référence de projet à BrazeAndroidBinding.csproj dans votre application Xamarin, cela entraînera la création de la liaison avec votre projet et vous fournira un accès au SDK Android Braze.

Une liaison Xamarin est une manière d’utiliser les bibliothèques natives dans les applications Xamarin. L’implémentation d’une liaison consiste à créer une interface C# avec la bibliothèque, puis à utiliser cette interface dans votre application. Il existe deux façons d’inclure la liaison du SDK de Braze : en utilisant NuGet ou en compilant à partir de la source.

La méthode d’intégration la plus simple consiste à obtenir le SDK de Braze à partir du référentiel central NuGet.org. Dans la barre latérale Visual Studio, cliquez avec le bouton droit de la souris le dossier Packages et cliquez sur Add Packages.... Recherchez « Braze » et installez les derniers packages NuGet pour Xamarin iOS : Braze.iOS.BrazeKit, Braze.iOS.BrazeUIet [Braze.iOS.BrazeLocation]https://www.nuget.org/packages/Braze.iOS.BrazeLocation dans votre projet.

Nous fournissons également les packages de bibliothèques de compatibilité : Braze.iOS.BrazeKitCompat et Braze.iOS.BrazeUICompat pour faciliter votre migration vers .NET MAUI.

La deuxième méthode d’intégration consiste à inclure la source de liaison. Sous appboy-component/src/iosnet6, vous trouverez notre code de source de liaison. Si vous ajoutez une référence de projet à BrazeiOSBinding.csproj dans votre application Xamarin, cela entraînera la création de la liaison avec votre projet et vous fournira un accès au SDK Android Braze. Assurez-vous que BrazeiOSBinding.csproj apparaît dans le dossier « Référence » de votre projet.

Étape 2 : Configurez votre instance Braze

Étape 2.1 : Configurez le SDK de Braze dans Braze.xml

Maintenant que les bibliothèques ont été intégrées, vous devez créer un fichier Braze.xml dans le dossier Resources/values de votre projet. Le contenu de ce fichier devrait ressembler à l’extrait de code suivant :

1
2
3
4
5
6
7
8
9

  <?xml version="1.0" encoding="utf-8"?>
  <resources>
    <string translatable="false" name="com_braze_api_key">YOUR_API_KEY</string>
    <string translatable="false" name="com_braze_custom_endpoint">YOUR_CUSTOM_ENDPOINT_OR_CLUSTER</string>
    <string-array name="com_braze_internal_sdk_metadata">
      <item>XAMARIN</item>
      <item>NUGET</item>
    </string-array>
  </resources>

Si vous incluez manuellement la source de la liaison, retirez <item>NUGET</item> de votre code.

Étape 2.2 : Ajouter les autorisations requises au manifeste Android

Maintenant que vous avez ajouté votre clé API, vous devez ajouter les autorisations suivantes à votre fichier AndroidManifest.xml :

1

<uses-permission android:name="android.permission.INTERNET" />

Pour obtenir un exemple de votre AndroidManifest.xml, voir l’exemple d’application Android MAUI.

Étape 2.3 : Suivre les sessions des utilisateurs et l’enregistrement des messages in-app.

Pour activer le suivi de session utilisateur et enregistrer votre application pour les messages in-app, ajoutez l’appel suivant à la méthode de cycle de vie OnCreate() de la classe Application dans votre application :

1

RegisterActivityLifecycleCallbacks(new BrazeActivityLifecycleCallbackListener());

Lors de la configuration de votre instance Braze, ajoutez l’extrait de code suivant pour configurer votre instance :

1
2
3

var configuration = new BRZConfiguration("YOUR_API_KEY", "YOUR_ENDPOINT");
configuration.Api.AddSDKMetadata(new[] { BRZSDKMetadata.Xamarin });
braze = new Braze(configuration);

Voir le fichier App.xaml.cs dans l’exemple d’application iOS MAUI.

Étape 3 : Tester l’intégration

Vous pouvez désormais lancer votre application et voir les sessions enregistrées dans le tableau de bord de Braze (ainsi que les informations relatives à l’appareil et d’autres analyses/analytiques). Pour obtenir une explication approfondie des bonnes pratiques pour l’intégration SDK de base, consultez les instructions d’intégration Android.

Vous pouvez maintenant lancer votre application et voir les sessions enregistrées dans le tableau de bord de Braze. Pour obtenir une explication approfondie des bonnes pratiques pour l’intégration SDK de base, consultez les instructions d’intégration iOS.

Github   Modifier cette page sur GitHub
CETTE PAGE A-T-ELLE ÉTÉ UTILE?
New Stuff!