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.
Les journaux émis par une configuration de lecture MediaTailor incluent des informations sur diverses activités qui se produisent pendant la session de lecture. Ces activités sont identifiées dans le type d'événement des journaux. De nombreux événements sont enregistrés par défaut. Pour aider à contrôler le coût des journaux sur Amazon CloudWatch, vous pouvez spécifier les journaux qui sont MediaTailor émis.
MediaTailor vous permet de contrôler le filtrage des journaux afin que vous puissiez effectuer les opérations suivantes :
-
Spécifiez les événements de journal que vous souhaitez exclure des journaux
-
Activer l'enregistrement des réponses brutes depuis le serveur de décision publicitaire (ADS)
Vous pouvez définir ces préférences de filtrage des journaux indépendamment pour chaque session de lecture, ou par défaut pour toutes les sessions de lecture pour une configuration de lecture.
-
Pour filtrer les journaux par session, incluez les paramètres de requête dans la demande d'initialisation de la session de lecture.
-
Pour filtrer les journaux par configuration de lecture, utilisez la MediaTailor console ou l'API pour indiquer vos préférences dans les paramètres de configuration de lecture.
Les sections suivantes fournissent des instructions pour activer le filtrage des journaux sur les sessions et les configurations de lecture.
Pour définir un niveau personnalisé de détails du journal pour chaque session, ajoutez les paramètres suivants à votre demande initiale de session de lecture côté serveur ou côté client. Ajoutez des valeurs aux paramètres pour représenter les événements que vous souhaitez inclure ou exclure, dans un format délimité par des virgules :
-
aws.adsInteractionLogPublishOptInEventTypespour recevoir des journaux pour des interactions spécifiques avec le serveur de décision publicitaire (ADS). -
aws.adsInteractionLogExcludeEventTypespour arrêter de recevoir des journaux pour des interactions ADS spécifiques. -
aws.manifestServiceLogExcludeEventTypespour arrêter de recevoir des journaux pour des interactions spécifiques avec le service de manifeste.
Pour obtenir la liste des types de journaux et d'événements qui MediaTailor émettent, voir Journaux du manifestejournaux ADS, etJournaux de transcodage.
Si vous ne transmettez aucun paramètre de requête pour le filtrage des journaux, MediaTailor écrit tous les journaux sur votre destination de livraison.
Exemple initialisation de session côté serveur avec filtres de journal
Pour exclure GENERATED_MANIFEST PARSING_ERROR des événements de vos journaux de manifeste et MAKING_ADS_REQUEST des journaux ADS, la demande d'initialisation de session devrait ressembler à ceci :
GET <mediatailorURL>/v1/master/<hashed-account-id>/<origin-id>/index.m3u8?aws.logMode=DEBUG&aws.manifestServiceLogExcludeEventTypes=GENERATED_MANIFEST,PARSING_ERROR&aws.adsInteractionLogExcludeEventTypes=MAKING_ADS_REQUESTPour activer les journaux bruts à partir de votre ADS, incluez la RAW_ADS_RESPONSE valeur du AdsInteractionPublishOptInEventType paramètre :
GET <mediatailorURL>/v1/master/<hashed-account-id>/<origin-id>/index.m3u8?aws.adsInteractionPublishOptInEventType=RAW_ADS_RESPONSEExemple initialisation de session côté client avec des filtres de journal
Pour exclure les événements de journalisation lors de l'initialisation de la session côté client, incluez availSuppression et enregistrez les paramètres dans la requête POST de votre client à. MediaTailor Pour plus d'informations sur la création d'une demande de session de lecture côté client, consultez Suivi des publicités côté client. L'exemple suivant exclut CONFIG_SECURITY_ERROR des PARSING_ERROR événements de vos journaux de manifeste et MAKING_ADS_REQUEST des journaux ADS.
POST parent.m3u8
{
"adsInteractionLog": {
...
"excludeEventTypes": [
"MAKING_ADS_REQUEST"
]
},
"manifestServiceLog": {
...
"excludeEventTypes": [
"GENERATED_MANIFEST",
"PARSING_ERROR"
]
},
"logMode": "DEBUG"
} Pour activer les journaux bruts à partir de votre ADS, incluez la RAW_ADS_RESPONSE valeur du publishOptInEventTypes paramètre :
POST parent.m3u8
{
"adsInteractionLog": {
"publishOptInEventTypes": ["RAW_ADS_RESPONSE"],
"excludeEventTypes": [
"MAKING_ADS_REQUEST"
]
},
"manifestServiceLog": {
...
"excludeEventTypes": [
"GENERATED_MANIFEST",
"PARSING_ERROR"
]
},
"logMode": "DEBUG"
}Utilisez les paramètres de la configuration de lecture pour définir les types d'événements de journal MediaTailor émis par défaut à partir de cette configuration de lecture. MediaTailor utilise ces paramètres de filtrage de journal par défaut pour toutes les sessions qui n'incluent pas de paramètres de requête de filtrage dans la demande d'initialisation de session.
Vous pouvez choisir d'effectuer les opérations suivantes :
-
Recevez des journaux pour des interactions spécifiques avec le serveur de décision publicitaire (ADS).
-
Exclure les journaux pour des interactions ADS spécifiques.
-
Excluez les journaux pour des interactions spécifiques avec le service de manifeste.
Pour définir ces paramètres depuis la MediaTailor console, voirCréation d'une configuration. Pour l' MediaTailor API, voir PutPlaybackConfiguration dans la Référence d'API AWS Elemental MediaTailor
Pour obtenir la liste des types de journaux et d'événements qui MediaTailor émettent, voir Journaux du manifestejournaux ADS, etJournaux de transcodage.
