View a markdown version of this page

Post-ads réponse - AWS Elemental MediaTailor
Quand ça se déclencheInputEspace de noms de sortie autoriséCe que ce crochet ne voit pasCas d'utilisation typiquesComportement de défaillance

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Post-ads réponse

Quand ça se déclenche

MediaTailor exécute la fonction mappée POST_ADS_RESPONSE après avoir reçu et analysé une réponse de l'ADS, y compris la résolution des redirections du wrapper VAST. La fonction examine les publicités analysées avant de MediaTailor sélectionner les annonces à insérer. Les modifications apportées ici influent donc sur les publicités qui remplissent la pause publicitaire.

Le hook se déclenche pour tous les protocoles de streaming (HLS et DASH) et tous les modes de lecture (live, VOD et pre-roll). Il se déclenche généralement une fois par pause publicitaire. Pour les réponses ADS qui couvrent plusieurs pauses publicitaires à la fois (telles que les réponses VMAP) et pour les réponses publicitaires prélues, le hook se déclenche lors du traitement de la réponse MediaTailor et l'espace de noms avail d'entrée n'est pas présent. $exists(avail)À utiliser pour vérifier avant d'accéder aux champs disponibles.

Input

event.*, session.*adsRequest.*, etadsResponse.*, plus avail.* lorsque la réponse s'applique à une seule pause publicitaire. Pour tous les champs disponibles, consultezRéférence du champ de saisie.

Espace de noms de sortie autorisé

Namespace Types acceptés Comment la sortie est utilisée
adsResponse.ads Tableau d'objets publicitaires Remplace la liste d'annonces analysée pour cette réponse. MediaTailor associe chaque annonce renvoyée aux annonces d'origine adId et procède à la sélection des annonces à l'aide de la liste renvoyée.
temp.* N’importe lequel Données temporaires permettant de transmettre des valeurs entre les étapes d'un exécuteur. N'a pas persisté.

Réécrivez la liste d'annonces modifiée àadsResponse.ads. Vous pouvez effectuer les actions suivantes :

  • Filtre  : renvoie un sous-ensemble des publicités d'origine. Les annonces que vous omettez ne sont pas prises en compte pour l'insertion, et la durée qu'elles ont occupée devient disponible pour les autres annonces.

  • Réorganiser  : renvoyez les annonces dans un ordre différent. L'ordre influe sur les annonces qui apparaissent en premier dans le spot publicitaire.

  • Modifier  : modifiezdurationSeconds,adSystem, adTitlemediaFiles, ou trackingEvents sur une annonce. Les publicités renvoyées inchangées conservent toutes leurs métadonnées VAST d'origine.

  • Injecter  : ajoutez des publicités qui ne figuraient pas dans la réponse initiale. Une nouvelle entrée doit inclure adIddurationSeconds, etmediaFiles. Les publicités récupérées à l'aide d'une VAST_REQUEST fonction lors de l'invocation du même hook constituent une exception : il suffit d'ajouter une telle annonce par elle-mêmeadId, car elle MediaTailor restaure les données VAST analysées complètes de l'annonce. Pour de plus amples informations, veuillez consulter Demande Vaste.

Important

Utilisez toujours un constructeur de tableau JSonata ou une coercition de tableau lors du filtrage. Une expression de filtre telle que « adsResponse.ads[adSystem != 'BLOCKED'] produit un seul objet quand exactement une annonce correspond ». Il ne produit aucune valeur lorsqu'aucune annonce ne correspond. Dans ce cas, la touche de sortie est omise et le filtre n'a aucun effet. Placez l'expression entre crochets ou ajoutez : []

{
    "Output": {
        "adsResponse.ads": "{%adsResponse.ads[adSystem != 'BLOCKED'][]%}"
    }
}

Les règles suivantes s'appliquent à la liste d'annonces renvoyée :

  • Si deux entrées partagent unadId, la première occurrence l'emporte.

  • Les entrées non valides sont rejetées individuellement. Les entrées valides dans la même sortie s'appliquent toujours.

  • Si une entrée injectée adId entre en collision avec une annonce provenant de la réponse ADS, l'annonce d'origine est utilisée comme base et les modifications apportées aux champs sont appliquées par-dessus.

Ce que ce crochet ne voit pas

Ce hook s'exécute avant la sélection des annonces. Il ne voit donc pas les publicités proposées par d'autres MediaTailor fonctionnalités ultérieurement, et il ne peut pas déterminer quelles annonces seront finalement insérées, car les décisions relatives à l'état du transcodage et au remplissage sont prises par la suite. Pour les publicités préchargées, le hook se déclenche lorsque MediaTailor la réponse de prélecture est traitée elle-même. Lors d'une pause publicitaire ultérieure, les publicités précédemment préchargées sont fusionnées après l'exécution de ce hook, de sorte que le hook ne les voit pas là. Pour agir sur le set d'annonces final, utilisezPRE_MANIFEST_INSERTION.

Cas d'utilisation typiques

  • Filtrez les publicités par métadonnées, par exemple en supprimant les publicités des systèmes publicitaires concurrents afin qu'elles n'apparaissent pas dans la même pause publicitaire (séparation concurrentielle).

  • Récupérez des publicités supplémentaires à partir d'un serveur publicitaire secondaire doté d'une VAST_REQUEST fonction lorsque la réponse principale est courte, et ajoutez-les à la liste des annonces.

  • Réorganisez les annonces de manière à ce que les annonces préférées apparaissent en premier dans la pause publicitaire.

  • Modifiez les événements de suivi ou les métadonnées des annonces avant leur insertion.

Comportement de défaillance

Si une fonction associée à POST_ADS_RESPONSE échoue pour une raison quelconque, telle qu'un délai d'attente, une erreur d'expression ou une sortie non valide, la sortie MediaTailor de la fonction est supprimée. La demande se poursuit avec la réponse ADS d'origine, comme si aucune fonction n'était attachée. Si l'entrée sérialisée dépasse la limite de taille d'entrée, MediaTailor ignore complètement l'invocation du hook. Pour connaître les limites applicables, consultezRestrictions.