Sélection
Vue d'ensemble
Objet représentant une sélection Rokt disponible en tant que résultat de IntegrationLauncher.selectPlacements.
Méthodes
close
▸ close(): Promise<void>
Ferme toutes les placements dans la sélection. Selon si le processus de sélection de Rokt est toujours en cours, la méthode soit :
- supprime les placements déjà ajoutés sur une page
- empêche les placements d'être ajoutés en premier lieu
Retourne : Promise<void>
getPlacements
▸ getPlacements(): Promise<Array<Placement>>
Récupère tous les placements retournés pour la sélection. La méthode retourne dès que le processus de sélection de Rokt a conclu qu'il y a des placements disponibles à afficher sur une page, mais avant que les placements ne soient chargés sur la page.
Dans le cas où il n'y a pas de placements disponibles pour la page, la méthode se résout avec un tableau vide. Si pour une raison quelconque le processus de sélection échoue, la méthode rejette la promesse avec une erreur.
Retourne : Promise<void>
on
▸ on<T>(event: string): Subscriber<SelectionEvent<T>>
Permet de s'abonner à des événements avec un nom spécifique provenant de n'importe quel emplacement dans la sélection. La méthode s'abonne effectivement à Placement.on invoqué pour chacun des emplacements.
Paramètres :
| Nom | Type | Description |
|---|---|---|
event | string | Nom de l'événement auquel s'abonner |
Renvoie : Subscriber<T>
ready
▸ ready(): Promise<T>
Permet d'attendre que chaque emplacement soit prêt. C'est effectivement la même chose que d'attendre que chaque Placement's ready dans la sélection soit résolu.
Si l'un des emplacements dans la sélection échoue pour une raison quelconque à être chargé, la promesse sera rejetée avec une erreur.
Renvoie : Promise<void>
send
▸ send<T>(name: string, data?: T): Promise<void>
Permet d'envoyer un événement à chaque emplacement (placement). Fonctionnellement, cela équivaut à invoquer Placement.send pour chaque emplacement dans la sélection.
La promesse retournée sera résolue une fois que tous les emplacements auront traité le message.
Paramètres :
| Nom | Type | Description |
|---|---|---|
name | string | Nom de l'événement |
data | T | Charge utile attendue pour un événement donné |
Retourne : Promise<void>
setAttributes
▸ setAttributes(): Promise<void>
Permet de définir des attributs supplémentaires pour la sélection.
Pour des raisons de pertinence, tous les attributs doivent être envoyés lors de la sélection.
Retourne : Promise<void>
Propriétés
context
• context : SelectionContext
Contexte de la sélection effectuée par Rokt.