Skip to content

Intégration SDK Android

Cet article de référence couvre l’intégration SDK Android pour la plateforme Unity. Suivez ces instructions pour utiliser Braze dans votre application Unity.

Étape 1 : Choisissez votre package Braze Unity

Le .unitypackage Braze regroupe des liaisons natives pour les plateformes Android et iOS, ainsi qu’une interface C#.

Plusieurs paquets de Braze Unity peuvent être téléchargés sur la page des versions de Braze Unity:

  • Appboy.unitypackage
    • Ce package regroupe les SDK Android et iOS Braze et la dépendance SDWebImage du SDK iOS, nécessaire pour le fonctionnement approprié des messages in-app de Braze et des fonctionnalités de cartes de contenu sur iOS. L’infrastructure SDWebImage est utilisée pour télécharger et afficher des images, y compris des GIF. Si vous avez l’intention d’utiliser la fonctionnalité Braze dans son intégralité, téléchargez et importez ce package.
  • Appboy-nodeps.unitypackage
    • Ce package est similaire à Appboy.unitypackage, à l’exception du framework SDWebImage qui n’est pas présent. Ce package est utile si vous ne souhaitez pas que l’infrastructure SDWebImage soit présente dans votre application iOS.

iOS: Pour savoir si vous avez besoin de la dépendance SDWebimage pour votre projet iOS, consultez le site iOS in-app message documentation.
Android: À partir d’Unity 2.6.0, l’artefact groupé du SDK Braze Android nécessite les dépendances AndroidX. Si vous utilisiez auparavant un jetified unitypackage, alors vous pouvez effectuer une transition en toute sécurité vers le unitypackage correspondant.

Étape 2 : Importer le package

Dans Unity Editor, importez le package dans votre projet Unity en sélectionnant Actifs > Importer un package > Personnaliser le package. Cliquez ensuite sur Importer.

Vous pouvez également suivre les instructions pour Importer un package d’actifs Unity pour accéder à un guide plus détaillé sur l’importation des packages Unity personnalisés.

Étape 3 : Mise à jour de votre AndroidManifest.xml

Les projets Android Unity nécessitent un AndroidManifest.xml pour exécuter l’application. De plus, Braze nécessite plusieurs ajouts à votre AndroidManifest.xml pour fonctionner.

Configurer le AndroidManifest.xml

Si votre application n’a pas de AndroidManifest.xml, vous pouvez utiliser ce qui suit comme modèle. Sinon, si vous avez déjà un AndroidManifest.xml, assurez-vous que l’une des sections manquantes suivantes est ajoutée à votre AndroidManifest.xml existant.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
          package="REPLACE_WITH_YOUR_PACKAGE_NAME">

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

  <application android:icon="@drawable/app_icon" 
               android:label="@string/app_name">

    <!-- Calls the necessary Braze methods to ensure that analytics are collected and that push notifications are properly forwarded to the Unity application. -->
    <activity android:name="com.braze.unity.BrazeUnityPlayerActivity" 
      android:theme="@style/UnityThemeSelector"
      android:label="@string/app_name" 
      android:configChanges="fontScale|keyboard|keyboardHidden|locale|mnc|mcc|navigation|orientation|screenLayout|screenSize|smallestScreenSize|uiMode|touchscreen" 
      android:screenOrientation="sensor">
      <meta-data android:name="android.app.lib_name" android:value="unity" />
      <meta-data android:name="unityplayer.ForwardNativeEventsToDalvik" android:value="true" />
      <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
      </intent-filter>
    </activity>

    <!-- A Braze specific FirebaseMessagingService used to handle push notifications. -->
    <service android:name="com.braze.push.BrazeFirebaseMessagingService"
      android:exported="false">
      <intent-filter>
        <action android:name="com.google.firebase.MESSAGING_EVENT" />
      </intent-filter>
    </service>
  </application>
</manifest>

Votre AndroidManifest.xml doit présent dans Assets/Plugins/Android/AndroidManifest.xml. Consultez la documentation d’Unity AndroidManifest pour plus d’informations.

Toutes les classes d’activités enregistrées dans votre AndroidManifest.xml doit être entièrement intégrées au SDK Braze pour Android. Si vous ajoutez votre propre classe d’activités, vous devez suivre les Instructions d’intégration d’activités Unity pour vous assurer que les analyses sont collectées.

Mettez à jour le site AndroidManifest.xml avec le nom de votre paquet

Pour trouver le nom de votre paquet, cliquez sur Fichier > Paramètres de création > Paramètres du lecteur > Onglet Android.

Dans votre AndroidManifest.xml, toutes les instances de REPLACE_WITH_YOUR_PACKAGE_NAME doivent être remplacées par Package Name par rapport à l’étape précédente.

Étape 4 : Ajouter des dépendances gradle

Pour ajouter des dépendances gradle à votre projet Unity, activez d’abord “Custom Main Gradle Template” dans vos paramètres de publication. Ceci créera un modèle gradle que votre projet utilisera. Un fichier gradle gère la mise en place des dépendances et d’autres paramètres du projet au moment de la création. Pour plus d’informations, consultez l’exemple d’application Braze Unity à la rubrique mainTemplate.gradle.

Les dépendances suivantes sont requises :

1
2
3
4
5
6

implementation 'com.google.firebase:firebase-messaging:22.0.0'
implementation "androidx.swiperefreshlayout:swiperefreshlayout:1.1.0"
implementation "androidx.recyclerview:recyclerview:1.2.1"
implementation "org.jetbrains.kotlin:kotlin-stdlib:1.6.0"
implementation "org.jetbrains.kotlinx:kotlinx-coroutines-android:1.6.1"
implementation 'androidx.core:core:1.6.0'

Vous pouvez également définir ces dépendances à l’aide du gestionnaire de dépendances externes.

Étape 5 : Configurer le SDK Braze

Braze fournit une solution Unity native pour l’automatisation de l’intégration Unity Android.

  1. Dans Unity Editor, ouvrez les paramètres de configuration de Braze en sélectionnant Braze > Configuration Braze.
  2. Cochez la case Automatiser l’intégration d’Unity Android.
  3. Dans le champ Clé API Braze, saisissez la clé API de votre application qui se trouve dans Gérer les paramètres depuis le tableau de bord de Braze.

Intégration SDK de base terminée

Braze devrait maintenant collecter des données depuis votre application et votre intégration de base devrait être terminée. Pour plus d’informations sur l’intégration des notifications push, consultez les articles suivants : Android et iOS, les messages in-app et les cartes de contenu.

Pour en savoir plus sur les options d’intégration SDK avancées, consultez la rubrique Implémentation avancée.

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