Web Push - Implémenter l'enregistrement des appareil

Dans ce guide, nous approfondirons la manière dont vous devez gérer l'enregistrement de l'appareil. Lorsque vous launch() Notificare, l'appareil sera enregistré comme périphérique non-push.

Lorsqu'un enregistrement réussi de l'appareil a lieu, nous émettons un événement. Vous pouvez écouter ces enregistrements comme suit.

import { onDeviceRegistered } from 'notificare-web/core';

onDeviceRegistered((device) => {
  // more code ...
});

Vous pouvez également vérifier les détails de l'appareil actuellement enregistré.

import { getCurrentDevice } from 'notificare-web/core';

const device = getCurrentDevice();

L'événement onReady() sera déclenché lorsque tous les modules Notificare auront été lancés, y compris un enregistrement réussi de l'appareil.

De plus, vous pouvez vérifier si Notificare est prêt à tout moment en appelant isReady() ou en écoutant l'événement onReady() n'importe où dans votre code comme décrit ci-dessous.

import { isReady, onReady } from 'notificare-web/core';

onReady((application) => {
  // more code ...
});

Attribuer un utilisateur à l'appareil

Par défaut, un appareil est enregistré en tant qu'utilisateur anonyme. Cependant, pour utiliser pleinement les notifications push dans votre stratégie omni-canale Actito, le simple enregistrement d'un appareil anonyme n'est pas ce que vous souhaitez. Vous devrez donc indiquer à la bibliothèque que vous souhaitez vous inscrire en tant qu'utilisateur spécifique.

import { registerDevice } from 'notificare-web/core';

await registerDevice({
  userId: '7f42bedc-d74b-4c64-a5cf-76bcc5130b05',
  userName: 'John Doe',
});

Après cela, l'appareil restera enregistré avec ce userId / userName jusqu'à ce que vous l'enregistriez explicitement comme anonyme. Selon la manière dont vous authentifiez les utilisateurs, vous souhaiterez peut-être vérifier l'état de connexion au lancement (dans onReady) et le modifier si nécessaire. Forcer l'enregistrement en tant qu'anonyme peut être mieux réalisé en définissant userId et userName sur null.

astuce

Seul le userId sera utilisé pour faire correspondre les appareils aux profils dans votre base de données Actito.
Le userName est uniquement utilisé pour fournir des informations supplémentaires.

import { registerDevice } from 'notificare-web/core';

await registerDevice({
  userId: null,
  userName: null,
});

Pour choisir le bon userId :

• Les données doivent être disponibles sous forme de clé dans Actito grâce à la synchronisation des données entre votre système et Actito.
• Les données doivent être disponibles sur votre site internet (en vous connectant à un espace client).

Veuillez utiliser un attribut déjà défini comme unique sur votre table de profil Actito.

info

Si vous devez ajouter un nouvel attribut unique, cela est possible, mais soyez prudent car cela pourrait avoir des impacts sur votre processus de synchronisation des données entre votre système et Actito. Demandez à votre expert en intégration si nécessaire.

Remplacer la langue de l'appareil

Par défaut, nous collecterons automatiquement la langue et la région d'un appareil en fonction des paramètres régionaux de l'appareil. Dans la plupart des cas, cela suffira, mais dans les cas où vous souhaitez remplacer la combinaison langue/région de l'appareil par une sélection stricte de langues, vous pouvez le faire en appelant la méthode suivante :

import { updatePreferredLanguage } from 'notificare-web/core';

await updatePreferredLanguage('en-US');

Finalement, vous pouvez toujours récupérer la langue préférée en appelant la méthode suivante :

import { getPreferredLanguage } from 'notificare-web/core';

const preferredLanguage = getPreferredLanguage();