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.
DEMANDE PRÉALABLE AUX ANNONCES
Quand il se déclenche
MediaTailor exécute la fonction mappée PRE_ADS_REQUEST une fois par pause publicitaire, immédiatement avant d'envoyer la demande à l'ADS. La fonction s'exécute chaque fois qu'une opportunité publicitaire est rencontrée pendant le traitement du manifeste.
Input
Tous les champs dePRE_SESSION_INITIALIZATION, plus avail.*scte.*, et adsRequest.* (url, méthode, en-têtes, corps). Pour tous les champs disponibles, voirRéférence du champ de saisie.
Espace de noms de sortie autorisé
| Namespace | Types acceptés | Comment la sortie est utilisée |
|---|---|---|
player_params.* |
Chaînes, nombres, booléens | Remplace les paramètres du lecteur de session pour cette pause publicitaire. Accessible à l'URL de demande ADS viaMediaTailor variables publicitaires dynamiques pour les demandes ADS. |
session.* |
Chaînes, nombres, booléens | Remplace les variables de session pour cette pause publicitaire. Disponible pour l'URL de demande ADS via une substitution dynamique de variables. |
avail.* |
Chaînes, nombres, booléens | Les remplacements utilisent des variables pour cette pause publicitaire. Disponible pour l'URL de demande ADS via une substitution dynamique de variables. |
scte.* |
Chaînes, nombres, booléens | Remplace les variables SCTE pour cette pause publicitaire. Disponible pour l'URL de demande ADS via une substitution dynamique de variables. |
adsRequest.* |
String | Remplace la demande ADS pour cette pause publicitaire uniquement. Champs pris en charge : urlmethod,headers.<name>,body. La url valeur est traitée comme un modèle et est prise en charge MediaTailor variables publicitaires dynamiques pour les demandes ADS après l'exécution de la fonction. N'a pas persisté. |
Note
Tous les résultats du PRE_ADS_REQUEST hook sont des dérogations transitoires : ils ne s'appliquent qu'à la demande ADS du break publicitaire en cours et ne sont pas conservés pendant la session.
Exemple : réécriture de la demande ADS :
{ "Output": { "adsRequest.url": "{%'https://ads.example.com/v1/vast?sid=' & session.id & '&genre=' & player_params.genre%}", "adsRequest.headers.X-Custom-Token": "{%player_params.auth_token%}" } }
Cela remplace l'URL ADS et ajoute un en-tête personnalisé pour le break publicitaire en cours.
Cas d'utilisation typiques
-
Réécrivez l'URL de demande ADS pour acheminer le trafic entre les différents serveurs publicitaires à des fins de A/B test.
-
Ajoutez des données d'enrichissement (segments d'audience, jetons d'identité) à l'URL ou aux en-têtes de la demande ADS.
-
Modifiez de manière conditionnelle les paramètres de demande ADS en fonction des données de SCTE-35 signal ou de l'indice d'utilisation.
Comportement de défaillance
Si une fonction attachée à PRE_ADS_REQUEST échoue pour une raison quelconque, MediaTailor supprime la sortie de la fonction et procède comme si aucune fonction n'était attachée. La demande ADS est envoyée en utilisant les paramètres de session et de demande d'origine sans modification.
