View a markdown version of this page

Filtern AWS Elemental MediaTailor Protokolle und Ereignisse - AWS Elemental MediaTailor

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Filtern AWS Elemental MediaTailor Protokolle und Ereignisse

Protokolle, die von einer Wiedergabekonfiguration in ausgegeben werden, MediaTailor enthalten Informationen über eine Vielzahl von Aktivitäten, die während der Wiedergabesitzung stattfinden. Diese Aktivitäten werden im Ereignistyp der Protokolle identifiziert. Viele Ereignisse werden standardmäßig protokolliert. Um die Kosten für Protokolle in Amazon unter Kontrolle zu halten CloudWatch, können Sie angeben, welche Protokolle ausgegeben MediaTailor werden.

MediaTailor bietet Ihnen die Kontrolle über die Protokollfilterung, sodass Sie Folgendes tun können:

  • Geben Sie die Protokollereignisse an, die Sie aus den Protokollen ausschließen möchten

  • Aktivieren Sie die Protokollierung von unbearbeiteten Antworten vom Ad Decision Server (ADS)

Sie können diese Einstellungen für die Protokollfilterung unabhängig für jede Wiedergabesitzung oder als Standard für alle Wiedergabesitzungen für eine Wiedergabekonfiguration festlegen.

  • Um Protokolle pro Sitzung zu filtern, nehmen Sie Abfrageparameter in die Initialisierungsanforderung für die Wiedergabesitzung auf.

  • Um Protokolle pro Wiedergabekonfiguration zu filtern, verwenden Sie die MediaTailor Konsole oder die API, um Ihre Präferenzen in den Wiedergabekonfigurationseinstellungen anzugeben.

Die folgenden Abschnitte enthalten Anweisungen zur Aktivierung der Protokollfilterung für Sitzungen und Wiedergabekonfigurationen.

Um eine benutzerdefinierte Ebene der Protokolldetails für jede Sitzung zu definieren, hängen Sie die folgenden Parameter an Ihre erste serverseitige oder clientseitige Wiedergabeanforderung an. Fügen Sie den Parametern Werte in einem kommagetrennten Format hinzu, um die Ereignisse darzustellen, die Sie ein- oder ausschließen möchten:

  • aws.adsInteractionLogPublishOptInEventTypesum Protokolle für bestimmte Interaktionen mit dem Ad Decision Server (ADS) zu erhalten.

  • aws.adsInteractionLogExcludeEventTypesum den Empfang von Protokollen für bestimmte ADS-Interaktionen zu beenden.

  • aws.manifestServiceLogExcludeEventTypesum den Empfang von Protokollen für bestimmte Interaktionen mit dem Manifestdienst zu beenden.

Eine Liste der Protokoll- und MediaTailor Ereignistypen, die ausgegeben werden, finden Sie unter Manifest-ProtokolleADS-Protokolle, undProtokolle transkodieren.

Wenn Sie keine Abfrageparameter für die Protokollfilterung übergeben, werden alle Protokolle an Ihr Lieferziel MediaTailor geschrieben.

Beispiel serverseitige Sitzungsinitialisierung mit Protokollfiltern

Um PARSING_ERROR Ereignisse aus Ihren Manifestprotokollen und MAKING_ADS_REQUEST aus den ADS-Protokollen auszuschließenGENERATED_MANIFEST, würde die Anforderung zur Sitzungsinitialisierung wie folgt aussehen:

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

Um Rohprotokolle aus Ihren ADS zu aktivieren, geben Sie den RAW_ADS_RESPONSE Wert für den AdsInteractionPublishOptInEventType Parameter an:

GET <mediatailorURL>/v1/master/<hashed-account-id>/<origin-id>/index.m3u8?aws.adsInteractionPublishOptInEventType=RAW_ADS_RESPONSE
Beispiel clientseitige Sitzungsinitialisierung mit Protokollfiltern

Um Protokollereignisse bei der clientseitigen Sitzungsinitialisierung auszuschließen, fügen Sie in der POST-Anfrage Ihres Kunden Parameter vom Typ „availSuppressionUnd protokollieren“ ein. MediaTailor Weitere Hinweise zum Erstellen einer clientseitigen Wiedergabesitzungsanforderung finden Sie unter Client-side Tracking von Werbeanzeigen. Im folgenden Beispiel werden PARSING_ERROR Ereignisse aus Ihren Manifest CONFIG_SECURITY_ERROR - und ADS-Protokollen ausgeschlossen. MAKING_ADS_REQUEST

POST parent.m3u8
   {
       "adsInteractionLog": {
           ...
           "excludeEventTypes": [
               "MAKING_ADS_REQUEST"
           ]
       },
       "manifestServiceLog": {
           ...
           "excludeEventTypes": [
               "GENERATED_MANIFEST",
               "PARSING_ERROR"
           ]
       },
      "logMode": "DEBUG"
   }

Um Rohprotokolle aus Ihren ADS zu aktivieren, geben Sie den RAW_ADS_RESPONSE Wert für den publishOptInEventTypes Parameter an: 

POST parent.m3u8
   {
       "adsInteractionLog": {
           "publishOptInEventTypes": ["RAW_ADS_RESPONSE"],
           "excludeEventTypes": [
               "MAKING_ADS_REQUEST"
           ]
       },
       "manifestServiceLog": {
           ...
           "excludeEventTypes": [
               "GENERATED_MANIFEST",
               "PARSING_ERROR"
           ]
       },
       "logMode": "DEBUG"
   }

Verwenden Sie die Einstellungen der Wiedergabekonfiguration, um die Protokoll-Ereignistypen zu definieren, die MediaTailor standardmäßig aus dieser Wiedergabekonfiguration ausgegeben werden. MediaTailor verwendet diese Standardeinstellungen für die Protokollfilterung für alle Sitzungen, die in der Anforderung zur Sitzungsinitialisierung keine Filterabfrageparameter enthalten.

Sie können wählen, ob Sie Folgendes tun möchten:

  • Empfangen Sie Protokolle für bestimmte Interaktionen mit dem Ad Decision Server (ADS).

  • Schließen Sie Protokolle für bestimmte ADS-Interaktionen aus.

  • Schließt Protokolle für bestimmte Interaktionen mit dem Manifestdienst aus.

Informationen zum Festlegen dieser Einstellungen von der MediaTailor Konsole aus finden Sie unterEine Konfiguration erstellen. Informationen zur MediaTailor API finden Sie PutPlaybackConfiguration in der AWS Elemental MediaTailor API-Referenz.

Eine Liste der Protokoll- und MediaTailor Ereignistypen, die ausgegeben werden Manifest-ProtokolleADS-Protokolle, finden Sie unter undProtokolle transkodieren.