Last updated 16 juil. 2024

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

L'intégration basée sur les événements vous permet de récupérer les placements 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 placement dans la sélection. Alternativement, chaque placement 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 se résout avec des placements une fois le processus de sélection terminé mais avant qu'ils ne soient chargés sur une page

Types d'événements

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

Titre de l'événement	Définition
OFFER_ENGAGEMENT	décrit l'engagement de l'utilisateur avec une offre, soit positivement soit négativement
POSITIVE_ENGAGEMENT	décrit l'engagement positif de l'utilisateur avec une offre ou un article de catalogue
PLACEMENT_CLOSED	décrit quand un placement se ferme
PLACEMENT_INTERACTIVE	décrit le moment où le placement a été rendu et est interactif
PLACEMENT_READY	décrit quand le placement est prêt à être affiché mais n'a pas encore rendu de contenu

Exemples

// selection
const selection: Selection;

// Écouter lorsque le placement devient interactif/prêt à afficher
selection.on('PLACEMENT_INTERACTIVE').subscribe(() => {
  // Logique à exécuter après que le placement soit devenu interactif
});

// Écouter lorsque l'iframe du placement redimensionne
selection.on('PLACEMENT_RESIZE').subscribe(function () {
  // Logique à exécuter après le redimensionnement du placement
});

Exemple d'intégration Google Tag Manager

// Écouter lorsque l'utilisateur interagit positivement ou négativement avec une offre
selection.on("OFFER_ENGAGEMENT").subscribe(() => {
  window.dataLayer?.push({
    ROKT_OFFER_ENGAGEMENT: true,
  });
});

// Écouter lorsque l'utilisateur interagit positivement avec une offre ou un article de catalogue
selection.on("POSITIVE_ENGAGEMENT").subscribe(() => {
  window.dataLayer?.push({
    ROKT_POSITIVE_ENGAGEMENT: true,
  });
});

// Écouter lorsque l'utilisateur ferme le placement
selection.on("PLACEMENT_CLOSED").subscribe(() => {
  window.dataLayer?.push({
    ROKT_PLACEMENT_CLOSED: true,
  });
});