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.
Pre-ads demande
Quand ça se déclenche
MediaTailor exécute la fonction mappée à PRE_ADS_REQUEST une fois par pause publicitaire, juste 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 provenant de PRE_SESSION_INITIALIZATIONavail.*, plusscte.*,asset.*, et adsRequest.* (URL, méthode, en-têtes, corps). 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 |
|---|---|---|
player_params.* |
Chaînes, nombres, booléens | Remplace les paramètres du lecteur de session pour cette pause publicitaire. Accessible à l'URL de la 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. Accessible à l'URL de la demande ADS par substitution dynamique de variables. |
avail.* |
Chaînes, nombres, booléens | Remplace les variables disponibles pour cette pause publicitaire. Accessible à l'URL de la demande ADS par substitution dynamique de variables. |
scte.* |
Chaînes, nombres, booléens | Remplace les variables SCTE pour cette pause publicitaire. Accessible à l'URL de la demande ADS par substitution dynamique de variables. |
asset.* |
Chaînes, nombres, booléens | Remplace les variables de métadonnées des actifs (issues des EXT-X-ASSET balises) pour cette pause publicitaire. Accessible à l'URL de la demande ADS par substitution dynamique de variables. Pour plus d'informations sur les marqueurs publicitaires HLS, consultez la section Marqueurs publicitaires HLS. |
adsRequest.* |
Chaîne | 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
Toutes les sorties du PRE_ADS_REQUEST hook sont des remplacements transitoires : elles s'appliquent uniquement à la demande ADS de la pause publicitaire en cours et ne sont pas conservées pendant la session.
Exemple : réécriture de la requête 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 de l'ADS et ajoute un en-tête personnalisé pour la pause publicitaire en cours.
Cas d'utilisation typiques
-
Réécrivez l'URL de la 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 de disponibilité.
Comportement de défaillance
Si une fonction associé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.
