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 dans 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 se résout avec les emplacements 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 emplacement se ferme
PLACEMENT_INTERACTIVE	décrit le moment où l'emplacement a été rendu et est interactif
PLACEMENT_READY	décrit quand l'emplacement est prêt à être affiché mais n'a pas encore rendu le contenu

Exemples

// sélection
const selection: Selection;

// Écouter lorsque le placement devient interactif/prêt à être affiché
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 avec 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,
  });
});