Last updated 24 oct. 2023

Intégration basée sur les événements

L'intégration basée sur les événements vous permet de récupérer les emplacements chargés et d'écouter les événements qu'ils émettent.

Le processus de sélection expose une méthode appelée Selection.on qui vous permet de vous abonner aux événements émis par n'importe quel emplacement de la sélection. Alternativement, chaque emplacement peut être abonné séparément après avoir obtenu leurs instances à partir d'une promesse retournée par la méthode Selection.getPlacements. Cela résout les emplacements une fois que le processus de sélection est terminé mais avant qu'ils ne soient chargés sur une page.

Types d'événements

Rokt prend en charge différents types d'événements auxquels les utilisateurs peuvent s'abonner :

Titre de l'événement	Définition
OFFER_ENGAGEMENT	décrit l'engagement positif de l'utilisateur avec une offre
POSITIVE_ENGAGEMENT	décrit l'engagement positif de l'utilisateur avec une offre ou un élément de catalogue
PLACEMENT_CLOSED	décrit la fermeture d'un emplacement
PLACEMENT_INTERACTIVE	décrit le moment où l'emplacement a été rendu et est interactif
PLACEMENT_READY	décrit le moment où l'emplacement est prêt à être affiché mais n'a pas encore rendu de contenu

Exemples

// sélection
const sélection: Sélection;

// Écoutez lorsque le placement devient interactif/prêt à être affiché
sélection.on('PLACEMENT_INTERACTIF').subscribe(() => {
  // Logique à exécuter après que le placement est devenu interactif
});

// Écoutez lorsque l'iframe du placement change de taille
sélection.on('PLACEMENT_REDIMENSION').subscribe(function () {
  // Logique à exécuter après que le placement a changé de taille
});

Exemple d'intégration avec Google Tag Manager

// Écoutez lorsque l'utilisateur interagit positivement avec une offre
sélection.on("ENGAGEMENT_OFFRE").subscribe(() => {
  window.dataLayer?.push({
    ROKT_ENGAGEMENT_OFFRE: true,
  });
});

// Écoutez lorsque l'utilisateur interagit positivement avec une offre ou un élément de catalogue
sélection.on("ENGAGEMENT_POSITIF").subscribe(() => {
  window.dataLayer?.push({
    ROKT_ENGAGEMENT_POSITIF: true,
  });
});

// Écoutez lorsque l'utilisateur ferme le placement
sélection.on("PLACEMENT_FERMÉ").subscribe(() => {
  window.dataLayer?.push({
    ROKT_PLACEMENT_FERMÉ: true,
  });
});