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

L'intégration basée sur les événements vous permet de récupérer des 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 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 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_COMPLETED	décrit l'utilisateur complétant son parcours à travers un seul placement
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
PLACEMENT_RESIZE	décrit chaque fois que les placements redimensionnent afin que le partenaire puisse réagir au changement de taille du placement
PLACEMENT_FAILURE	décrit chaque fois qu'un placement rencontre une erreur dont il ne peut pas se remettre

Exemples

// selection
const selection: Selection;

// Listen for when the placement becomes interactive/ready to display
selection.on('PLACEMENT_INTERACTIVE').subscribe(() => {
  // Logic to run after Placement has become interactive
});

// Listen for when the placement iframe resizes
selection.on('PLACEMENT_RESIZE').subscribe(function () {
  // Logic to run after Placement resizes
});

Exemple d'intégration Google Tag Manager

// Listen for when user engages positively or negatively with an offer
selection.on("OFFER_ENGAGEMENT").subscribe(() => {
  window.dataLayer?.push({
    ROKT_OFFER_ENGAGEMENT: true,
  });
});

// Listen for when user engages positively with an offer or catalog item
selection.on("POSITIVE_ENGAGEMENT").subscribe(() => {
  window.dataLayer?.push({
    ROKT_POSITIVE_ENGAGEMENT: true,
  });
});

// Listen for when user closes out of the placement
selection.on("PLACEMENT_CLOSED").subscribe(() => {
  window.dataLayer?.push({
    ROKT_PLACEMENT_CLOSED: true,
  });
});