Cas d’utilisation des sessions anonymes

Découvrez des cas d’utilisation de sessions anonymes avec les Actions.

Lorsqu’un utilisateur s’authentifie dans votre application, les sessions anonymes et les Actions vous permettent de transférer les données de sa session anonyme, comme le contenu du panier, les préférences et l’historique de navigation, vers son profil utilisateur authentifié.

Vous pouvez faire référence à l’objet event.anonymous_session dans les Actions :

{
  user_id: string;     // ID de l'utilisateur anonyme 
  session_id: string;  // ID du jeton de session anonyme
  created_at: number;  // horodatage de création de la session anonyme
  expires_at: number;  // horodatage d'expiration de la session anonyme
  metadata: {          // objet de métadonnées de la session anonyme
    [key: string]: string
  };
}

​

Cas d’utilisation des sessions anonymes et des Actions

​

Enregistrer les métadonnées de session anonyme dans le profil d’un nouvel utilisateur

Vous pouvez utiliser un déclencheur d’Action pre-user-registration pour copier les métadonnées anonymes dans le profil du nouvel utilisateur lorsqu’il s’inscrit :

exports.onExecutePreUserRegistration = async (event, api) => {
  if (event.anonymous_session) {
    // Conserver une référence à la session anonyme
    api.user.setAppMetadata(
      'linked_anonymous_id',
      event.anonymous_session.user_id
    );

    // Migrer les données du panier
    if (event.anonymous_session.metadata.cart) {
      api.user.setAppMetadata(
        'migrated_cart',
        event.anonymous_session.metadata.cart
      );
    }

    // Copier les préférences dans les métadonnées de l'utilisateur
    if (event.anonymous_session.metadata.preferences) {
      api.user.setUserMetadata(
        'preferences',
        event.anonymous_session.metadata.preferences
      );
    }
  }
};

​

Enregistrer les métadonnées de session anonyme pour un utilisateur existant

Vous pouvez utiliser un déclencheur d’Action post-login pour enregistrer des métadonnées anonymes pour les utilisateurs existants lorsqu’ils se connectent :

exports.onExecutePostLogin = async (event, api) => {
  if (event.anonymous_session) {
    // Conserver la référence de la dernière session anonyme
    api.user.setAppMetadata(
      'last_anonymous_session',
      event.anonymous_session.user_id
    );

    // Ajouter le panier anonyme à l'access token afin que votre API puisse le traiter
    api.accessToken.setCustomClaim(
      'anonymous_cart',
      event.anonymous_session.metadata.cart
    );

    // Faire le suivi de toutes les sessions liées (facultatif)
    const linkedSessions =
      event.user.app_metadata?.linked_sessions || [];
    if (!linkedSessions.includes(event.anonymous_session.user_id)) {
      api.user.setAppMetadata('linked_sessions', [
        ...linkedSessions,
        event.anonymous_session.user_id,
      ]);
    }
  }
};

​

Fusionner les métadonnées et anonymes

Vous pouvez utiliser un déclencheur d’Action post-login pour fusionner des métadonnées anonymes avec les métadonnées d’un utilisateur existant, par exemple les renseignements sur un panier, lorsqu’il se connecte :

exports.onExecutePostLogin = async (event, api) => {
  if (!event.anonymous_session?.metadata?.cart) {
    return; // Aucun panier anonyme à fusionner
  }

  const anonymousCart = event.anonymous_session.metadata.cart;
  const existingCart = event.user.app_metadata?.cart || { items: [] };

  // Fusionner les articles du panier en additionnant les quantités des UGS identiques
  const mergedItems = [...existingCart.items];
  for (const anonItem of anonymousCart.items) {
    const existingIndex = mergedItems.findIndex(
      (item) => item.sku === anonItem.sku
    );
    if (existingIndex >= 0) {
      mergedItems[existingIndex].qty += anonItem.qty;
    } else {
      mergedItems.push(anonItem);
    }
  }

  api.user.setAppMetadata('cart', { items: mergedItems });
  api.accessToken.setCustomClaim('cart', { items: mergedItems });
};

​

Gérer plusieurs sessions anonymes

Vous pouvez utiliser un déclencheur d’Action post-login pour gérer les métadonnées des sessions anonymes sur différents appareils lorsque l’utilisateur se connecte :

exports.onExecutePostLogin = async (event, api) => {
  if (!event.anonymous_session) return;

  const linkedSessions =
    event.user.app_metadata?.linked_sessions || [];

  // Option 1 : conserver toutes les sessions liées
  api.user.setAppMetadata('linked_sessions', [
    ...linkedSessions,
    {
      user_id: event.anonymous_session.user_id,
      linked_at: new Date().toISOString(),
      device: event.request.user_agent,
    },
  ]);

  // Option 2 : ne conserver que la plus récente
  api.user.setAppMetadata('last_anonymous_session', {
    user_id: event.anonymous_session.user_id,
    metadata: event.anonymous_session.metadata,
  });
};

​

En savoir plus

• Configurer les sessions anonymes Découvrez comment configurer les sessions anonymes.
• Sessions anonymes Découvrez les sessions anonymes.