Skip to content

Messagerie électronique des appareils Amazon

Cet article de référence couvre l’intégration de notifications push Amazon Android pour la plateforme Unity.

Une notification push est une alerte hors application qui apparaît sur l’écran de l’utilisateur lorsqu’une mise à jour importante se produit. Les notifications push constituent un moyen précieux de fournir à vos utilisateurs un contenu urgent et pertinent, ou de les réengager dans votre application.

ADM (Amazon Device Messaging) n’est pas pris en charge sur les appareils ne faisant pas partie d’Amazon. Pour tester la poussée Kindle, vous devez avoir un appareil FireOS. Consultez la section d’aide pour des pratiques exemplaires supplémentaires.

Braze envoie des notifications push aux appareils Amazon en utilisant Amazon Device Messaging (ADM).

Étape 1 : Activer ADM

  1. Créez un compte avec le Portail des développeurs d’applications et de jeux Amazon si vous ne l’avez pas encore fait.
  2. Obtenez les identifiants OAuth (ID client et secret client) et une clé API ADM.
  3. Activez Enregistrement ADM automatique activé dans la fenêtre de configuration de Braze Unity.
    • Vous pouvez également ajouter la ligne suivante à votre res/values/braze.xml pour activer l’enregistrement ADM :
1

  <bool name="com_braze_push_adm_messaging_registration_enabled">true</bool>

Étape 2 : Mettre à jour Unity 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
34
35
36
37

<?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" />
  <permission
    android:name="REPLACE_WITH_YOUR_PACKAGE_NAME.permission.RECEIVE_ADM_MESSAGE"
    android:protectionLevel="signature" />
  <uses-permission android:name="REPLACE_WITH_YOUR_PACKAGE_NAME.permission.RECEIVE_ADM_MESSAGE" />
  <uses-permission android:name="com.amazon.device.messaging.permission.RECEIVE" />

  <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: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>

    <receiver android:name="com.braze.push.BrazeAmazonDeviceMessagingReceiver" android:permission="com.amazon.device.messaging.permission.SEND">
      <intent-filter>
          <action android:name="com.amazon.device.messaging.intent.RECEIVE" />
          <action android:name="com.amazon.device.messaging.intent.REGISTRATION" />
          <category android:name="REPLACE_WITH_YOUR_PACKAGE_NAME" />
      </intent-filter>
    </receiver>
  </application>
</manifest>

Étape 3 : Stocker votre clé API ADM

Tout d’abord, obtenez une clé API ADM pour votre application. Ensuite, enregistrez votre clé API ADM dans un fichier nommé api_key.txt et enregistrez-le dans le dossier Assets/ de votre projet.

Amazon ne reconnaîtra pas votre clé si api_key.txt contient des caractères blancs, comme un saut de ligne.

Ajoutez à votre fichier mainTemplate.gradle :

1
2
3
4
5
6
7

task copyAmazon(type: Copy) {
    def unityProjectPath = $/file:///**DIR_UNITYPROJECT**/$.replace("\\", "/")
    from unityProjectPath + '/Assets/api_key.txt'
    into new File(projectDir, 'src/main/assets')
}

preBuild.dependsOn(copyAmazon)

Étape 4 : Ajouter un Jar ADM

Le fichier Jar ADM requis peut être placé n’importe où dans votre projet, conformément à la documentation JAR d’Unity.

Étape 5 : Ajouter un identifiant secret client et un identifiant client à votre tableau de bord de Braze

Enfin, vous devez ajouter le Secret Client et l’ID Client que vous avez obtenus dans l’Étape 1 à la page Gérer les paramètres du tableau de bord de Braze.

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