View a markdown version of this page

Filtrage AWS Elemental MediaTailor journaux et événements - AWS Elemental MediaTailor

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.

Filtrage AWS Elemental MediaTailor journaux et événements

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 vous 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 la journalisation 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 en fonction de la 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 séparé par des virgules :

  • aws.adsInteractionLogPublishOptInEventTypespour recevoir des journaux relatifs à des interactions spécifiques avec le serveur de décision publicitaire (ADS).

  • aws.adsInteractionLogExcludeEventTypespour ne plus recevoir les journaux relatifs à des interactions ADS spécifiques.

  • aws.manifestServiceLogExcludeEventTypespour arrêter de recevoir les journaux relatifs à des interactions spécifiques avec les services de manifeste.

Pour obtenir la liste des types de journaux et d'événements qui MediaTailor émettent, consultez Journaux des manifestesJournaux ADS, etJournaux de transcodage.

Si vous ne transmettez aucun paramètre de requête pour le filtrage des journaux, MediaTailor écrit tous les journaux vers votre destination de livraison.

Exemple initialisation de session côté serveur à l'aide de filtres de journalisation

Pour exclure GENERATED_MANIFEST PARSING_ERROR des événements de vos journaux manifestes et MAKING_ADS_REQUEST des journaux ADS, la demande d'initialisation de session devrait se présenter comme suit :

GET <mediatailorURL>/v1/master/<hashed-account-id>/<origin-id>/index.m3u8?aws.logMode=DEBUG&aws.manifestServiceLogExcludeEventTypes=GENERATED_MANIFEST,PARSING_ERROR&aws.adsInteractionLogExcludeEventTypes=MAKING_ADS_REQUEST

Pour 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_RESPONSE
Exemple initialisation de session côté client à l'aide de filtres de journalisation

Pour exclure les événements de journal 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 adressée à. MediaTailor Pour plus d'informations sur la création d'une demande de session de lecture côté client, consultez Client-side suivi des publicités. L'exemple suivant exclut CONFIG_SECURITY_ERROR des PARSING_ERROR événements de vos journaux manifestes 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 qui MediaTailor sont émis par défaut à partir de cette configuration de lecture. MediaTailor utilise ces paramètres de filtrage des journaux 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 de procéder comme suit :

  • Recevez des journaux pour des interactions spécifiques avec le serveur de décision publicitaire (ADS).

  • Excluez les journaux pour des interactions ADS spécifiques.

  • Excluez les journaux pour des interactions spécifiques avec les services de manifeste.

Pour définir ces paramètres depuis la MediaTailor console, consultezCréation d'une configuration. Pour l' MediaTailor API, voir PutPlaybackConfiguration la référence de l'AWS Elemental MediaTailor API.

Pour obtenir la liste des types de journaux et d'événements qui MediaTailor émettent, consultez Journaux des manifestesJournaux ADS, etJournaux de transcodage.