View a markdown version of this page

Risoluzione dei problemi relativi al flusso MediaTailor degli eventi - AWS Elemental MediaTailor
Flussi incompletiAnalisi della tempisticaProblemi comuniLe migliori pratiche di monitoraggioRisorse aggiuntive

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Risoluzione dei problemi relativi al flusso MediaTailor degli eventi

La comprensione del flusso AWS Elemental MediaTailor degli eventi fornisce una solida base per la risoluzione dei problemi di inserimento degli annunci. Analizzando la sequenza, la tempistica e i modelli degli eventi, puoi identificare rapidamente dove si verificano i problemi e implementare soluzioni mirate.

Questa sezione fornisce una guida pratica per l'utilizzo dell'analisi del flusso di eventi per diagnosticare i problemi. Per comprendere i concetti di base del flusso di eventi, vedereFlusso degli eventi di inserimento degli annunci.

Identificazione dei flussi di eventi incompleti

I flussi di eventi incompleti si verificano quando la sequenza di eventi prevista si interrompe prima di raggiungere con successo la personalizzazione del manifesto (il processo di MediaTailor inserimento di informazioni pubblicitarie personalizzate nel manifesto). Identificare dove si interrompe il flusso aiuta a individuare la causa principale degli errori di inserimento degli annunci.

Schemi di flusso incompleti comuni

Diversi punti di errore nel flusso di eventi indicano tipi specifici di problemi, come i seguenti.

  • Il flusso si interrompe dopo il rilevamento di un'opportunità pubblicitaria: indica problemi con gli indicatori degli annunci o con il manifesto stesso che MediaTailor impediscono di effettuare una richiesta ADS. Dopo la richiesta ADS si verificherebbero problemi di connettività, configurazione o timeout ADS.

  • Il flusso si interrompe dopo la richiesta ADS: suggerisce problemi di risposta ADS, problemi di analisi VAST, errori di elaborazione creativa, timeout ADS, errori di connettività o problemi di configurazione come URL ADS non validi che vengono scoperti solo quando viene effettuata la richiesta.

  • Beacon di tracciamento mancante: potrebbe indicare problemi di configurazione del tracciamento, problemi di segnalazione sul lato server o lacune nell'implementazione sul lato client.

CloudWatch domande per un'analisi del flusso incompleta

Usa queste query Amazon CloudWatch Logs Insights per identificare flussi di eventi incompleti. Esegui queste query sui gruppi di log appropriati in base al tipo di analisi necessaria.

Selezione del gruppo di log:

  • MediaTailor/AdDecisionServerInteractions- Utilizzato per le domande che analizzano le decisioni pubblicitarie, le interazioni con i server, le opportunità pubblicitarie e ADS-related gli errori.

  • MediaTailor/TranscodeService- Utilizzato per analizzare i problemi in cui gli annunci non sono stati inseriti a causa di problemi di transcodifica, errori di elaborazione creativa o altri problemi non correlati agli annunci.

Esempio- Identifica le opportunità pubblicitarie senza una corretta personalizzazione dei manifesti

Gruppo di log: MediaTailor/AdDecisionServerInteractions

La seguente query identifica le opportunità pubblicitarie che non hanno portato a una corretta personalizzazione del manifesto:

fields @timestamp, eventType, avail.availId, sessionId
| filter eventType = "AD_MARKER_FOUND"
| stats count() as total_opportunities by avail.availId
| join (
    fields @timestamp, eventType, avail.availId
    | filter eventType = "FILLED_AVAIL"
    | stats count() as successful_fills by avail.availId
) on avail.availId
| where ispresent(total_opportunities) and not ispresent(successful_fills)
| sort total_opportunities desc
Esempio analizza i tassi di completamento del flusso di eventi

Gruppo di log: MediaTailor/AdDecisionServerInteractions

La seguente query analizza i tassi di completamento tra diversi tipi di eventi:

fields @timestamp, eventType, avail.availId
| filter eventType in ["AD_MARKER_FOUND", "MAKING_ADS_REQUEST", "VAST_RESPONSE", "FILLED_AVAIL", "BEACON_FIRED"]
| stats count() by eventType, avail.availId
| sort avail.availId, eventType
Esempio trova sessioni con eventi beacon mancanti

Gruppo di log: MediaTailor/AdDecisionServerInteractions

La seguente query identifica le sessioni che hanno completato gli avali ma nessun evento beacon corrispondente:

fields @timestamp, eventType, sessionId, avail.availId
| filter eventType = "FILLED_AVAIL"
| stats count() as filled_avails by sessionId
| join (
    fields @timestamp, eventType, sessionId
    | filter eventType = "BEACON_FIRED"
    | stats count() as beacon_events by sessionId
) on sessionId
| where filled_avails > 0 and (not ispresent(beacon_events) or beacon_events = 0)
| sort filled_avails desc
Esempio identificare gli errori di inserimento degli annunci relativi alla transcodifica

Gruppo di log: MediaTailor/TranscodeService

La seguente query identifica i problemi di transcodifica che impediscono il corretto inserimento degli annunci:

fields @timestamp, eventType, sessionId, requestId
| filter eventType in ["TRANSCODE_IN_PROGRESS", "INTERNAL_ERROR", "MISSING_VARIANTS", "PROFILE_NOT_FOUND"]
| stats count() as transcode_issues by eventType, sessionId
| sort transcode_issues desc

Analisi dei problemi di tempistica degli eventi

L'analisi della tempistica degli eventi aiuta a identificare i colli di bottiglia nelle prestazioni e a ottimizzare i flussi di lavoro di inserimento degli annunci. Gli schemi temporali insoliti spesso indicano problemi di fondo che influiscono sull'esperienza degli spettatori.

Soglie temporali delle prestazioni

Utilizza queste soglie temporali per identificare potenziali problemi di prestazioni.

  • Durata totale del flusso superiore a 5 secondi: può influire sull'esperienza dell'utente e può indicare problemi di prestazioni ADS, problemi del server di origine (come i timeout di recupero del manifesto) o problemi interni, inclusi MediaTailor problemi di infrastruttura con NAT Gateway, DynamoDB, EC2 o altri componenti di sistema.

  • Tempo di risposta ADS superiore a 2 secondi: suggerisce problemi di prestazioni ADS o problemi di latenza di rete.

  • Personalizzazione del manifesto per più di 1 secondo: può indicare ritardi nell'elaborazione creativa, problemi del server di origine (come i timeout per il recupero del manifesto) o problemi interni del MediaTailor sistema, inclusi vincoli di infrastruttura con NAT Gateway, DynamoDB, EC2 o altri componenti.

Interrogazioni di analisi dei tempi

Usa queste query per analizzare i modelli di temporizzazione degli eventi.

Esempio misura la durata totale del flusso di eventi

La seguente query misura la durata totale dei flussi di eventi e identifica quelli superiori a 5 secondi:

fields @timestamp, eventType, avail.availId
| filter avail.availId = "your-avail-id"
| filter eventType in ["AD_MARKER_FOUND", "FILLED_AVAIL"]
| sort @timestamp asc
| stats min(@timestamp) as start_time, max(@timestamp) as end_time by avail.availId
| eval duration_seconds = (end_time - start_time) / 1000
| where duration_seconds > 5
Esempio analizzare i tempi di risposta dell'ADS

La seguente query analizza i tempi di risposta di ADS e identifica quelli superiori a 2 secondi:

fields @timestamp, eventType, avail.availId
| filter avail.availId = "your-avail-id"
| filter eventType in ["MAKING_ADS_REQUEST", "VAST_RESPONSE"]
| sort @timestamp asc
| stats min(@timestamp) as request_time, max(@timestamp) as response_time by avail.availId
| eval ads_response_seconds = (response_time - request_time) / 1000
| where ads_response_seconds > 2
Esempio identifica la personalizzazione lenta dei manifesti

La seguente query identifica i processi di personalizzazione dei manifesti che richiedono più di 1 secondo:

fields @timestamp, eventType, avail.availId
| filter avail.availId = "your-avail-id"
| filter eventType in ["VAST_RESPONSE", "FILLED_AVAIL"]
| sort @timestamp asc
| stats min(@timestamp) as response_time, max(@timestamp) as filled_time by avail.availId
| eval personalization_seconds = (filled_time - response_time) / 1000
| where personalization_seconds > 1

Problemi e soluzioni comuni relativi al flusso di eventi

Questa sezione fornisce soluzioni per i problemi più frequenti relativi al flusso di eventi, organizzate per tipo di problema e sintomi.

Errori relativi alle richieste del server Ad Decision

Sintomi: il flusso di eventi si interrompe dopo il rilevamento di un'opportunità pubblicitaria. Nessun evento di richiesta ADS registrato.

Cause e soluzioni comuni

  • Errori di configurazione dell'URL ADS: verifica che l'URL ADS nella configurazione di riproduzione sia corretto e accessibile. Nel registro delle interazioni con gli annunci, vedrai un evento di richiesta ADS (MAKING_ADS_REQUEST) ma nessuna risposta VAST corrispondente, spesso accompagnata da un evento di errore ERROR_UNKNOWN o simile.

  • Problemi di connettività di rete: verifica la connettività di rete tra MediaTailor e il tuo ADS, comprese le regole del firewall e la risoluzione DNS.

  • SSL/TLS problemi relativi ai certificati: assicurati che il tuo ADS utilizzi certificati SSL validi emessi da un'autorità di certificazione affidabile. Per Google Ad Manager, in particolare, potresti dover contattare AWS Support per abilitare un flag di configurazione che accetti i certificati SSL di Google.

Query diagnostica

La seguente query consente di diagnosticare gli errori delle richieste ADS monitorando la sequenza degli eventi:

fields @timestamp, eventType, sessionId
| filter sessionId = "your-session-id"
| filter eventType in ["AD_MARKER_FOUND", "MAKING_ADS_REQUEST", "ERROR_ADS_IO", "ERROR_UNKNOWN_HOST"]
| sort @timestamp asc

Errori di risposta del server Ad Decision

Sintomi: le richieste ADS hanno esito positivo ma MediaTailor non ricevono risposta o si verificano errori di analisi.

Cause e soluzioni comuni

  • Formato VAST non valido: convalida le tue risposte ADS VAST rispetto agli standard delle specifiche VAST.

  • Problemi di timeout ADS: aumenta le impostazioni di timeout ADS o ottimizza i tempi di risposta ADS.

  • Inventario pubblicitario vuoto: verifica la disponibilità dell'inventario pubblicitario e i criteri di targeting nella configurazione ADS.

Query diagnostica

La seguente query consente di diagnosticare gli errori di risposta ADS esaminando gli eventi di richiesta e risposta:

fields @timestamp, eventType, sessionId
| filter sessionId = "your-session-id"
| filter eventType in ["MAKING_ADS_REQUEST", "VAST_RESPONSE", "EMPTY_VAST_RESPONSE", "ERROR_ADS_RESPONSE_PARSE", "ERROR_ADS_TIMEOUT"]
| sort @timestamp asc

Errori di personalizzazione manifesti

Sintomi: sono state ricevute risposte VAST ma la personalizzazione del manifesto non riesce o gli annunci vengono ignorati.

Cause e soluzioni comuni:

  • Problemi di transcodifica creativa: controlla se l'annuncio è un annuncio che richiede NEW_CREATIVE la transcodifica prima dell'inserimento. Puoi anche verificare la presenza di errori di transcodifica esaminando il MediaTailor/TranscodeService registro per eventuali eventi di errore come, o. INTERNAL_ERROR MISSING_VARIANTS, PROFILE_NOT_FOUND

  • Problemi di mancata corrispondenza tra le durate degli annunci: verifica che le durate degli annunci corrispondano alle durate disponibili delle interruzioni pubblicitarie.

  • Problemi relativi alle soglie di personalizzazione: rivedi le impostazioni delle soglie di personalizzazione nella configurazione di riproduzione.

Query diagnostica

La seguente query aiuta a diagnosticare gli errori di personalizzazione manifesti esaminando le risposte VAST e i risultati ottenuti:

fields @timestamp, eventType, sessionId, skippedAds
| filter sessionId = "your-session-id"
| filter eventType in ["VAST_RESPONSE", "FILLED_AVAIL", "WARNING_NO_ADVERTISEMENTS"]
| sort @timestamp asc

Interroga i motivi dell'annuncio ignorato

La seguente query fornisce informazioni dettagliate sul motivo per cui gli annunci sono stati ignorati:

fields @timestamp, eventType, sessionId, skippedAds.reason, skippedAds.creativeUniqueId
| filter sessionId = "your-session-id"
| filter eventType = "WARNING_NO_ADVERTISEMENTS" or ispresent(skippedAds)
| sort @timestamp asc

Richiedi i motivi degli annunci ignorati e gli ID univoci creativi

La seguente query fornisce informazioni dettagliate sugli annunci ignorati, inclusi i motivi e gli ID creativi univoci per i primi due annunci di ciascuna disponibilità:

fields @timestamp, eventType
| filter sessionId = "your-session-id"
| filter eventType = "FILLED_AVAIL"
| fields avail.skippedAds.0.vastDuration as SkippedDur_Ad0, avail.skippedAds.0.skippedReason as Ad0_SkipReason, avail.skippedAds.0.creativeUniqueId as SkippedCreative0_UID
| fields avail.skippedAds.1.vastDuration as SkippedDur_Ad1, avail.skippedAds.1.skippedReason as Ad1_SkipReason, avail.skippedAds.1.creativeUniqueId as SkippedCreative1_UID
| sort @timestamp desc

Monitoraggio degli errori dei beacon

Sintomi: personalizzazione del manifesto riuscita ma beacon di tracciamento mancanti o non riusciti.

Cause e soluzioni comuni

  • Client-side Problemi di implementazione: la maggior parte dei problemi relativi ai beacon di tracciamento derivano da problemi di implementazione sul lato client, come la mancata frequenza del polling degli URL di tracciamento per il tracciamento sul lato client o problemi di logica di attivazione dei beacon specifici del giocatore.

  • Problemi di accessibilità degli URL di monitoraggio: verifica che gli URL di tracciamento nelle risposte VAST siano accessibili e restituiscano risposte appropriate. Possono verificarsi problemi quando gli URL non sono raggiungibili o quando si verificano problemi interni che impediscono il MediaTailor corretto invio delle risposte di tracciamento.

  • Problemi con le richieste relative ai segmenti di giocatori: quando il giocatore cliente non richiede effettivamente alcun segmento, possono verificarsi guasti apparenti. Ciò comporta l'invio di nessun beacon, il che appare come un errore di tracciamento, ma in realtà è un problema di implementazione del giocatore piuttosto che un problema di beacon.

Query diagnostica

La seguente query consente di diagnosticare i guasti dei beacon di tracciamento esaminando i dati esauriti e gli eventi dei beacon:

fields @timestamp, eventType, sessionId
| filter sessionId = "your-session-id"
| filter eventType in ["FILLED_AVAIL", "BEACON_FIRED", "ERROR_FIRING_BEACON_FAILED"]
| sort @timestamp asc

Best practice per il monitoraggio del flusso di eventi

Implementa queste pratiche di monitoraggio per identificare e risolvere in modo proattivo i problemi relativi al flusso di eventi:

Impostazione degli allarmi CloudWatch

Crea CloudWatch allarmi Amazon per monitorare le metriche chiave del flusso di eventi.

  • Allarme sul tasso di completamento del flusso: avvisa quando il rapporto tra la personalizzazione riuscita dei manifesti e le opportunità pubblicitarie scende al di sotto delle soglie accettabili.

  • Allarme sul tempo di risposta ADS: monitora i tempi di risposta medi di ADS e avvisa quando superano le soglie di rendimento.

  • Allarme relativo al tasso di errore: tieni traccia delle frequenze degli eventi di errore e segnala picchi insoliti in tipi di errore specifici.

Domande di monitoraggio regolari

Esegui queste query regolarmente per mantenere la visibilità sullo stato del flusso di eventi:

Esempio percentuale di successo del flusso di eventi giornaliero

La seguente query fornisce una panoramica giornaliera delle percentuali di successo del flusso di eventi per tipo di evento:

fields @timestamp, eventType
| filter @timestamp > datefloor(@timestamp, 1d)
| stats count() as total_events by eventType
| sort total_events desc
Esempio tendenza del tasso di errore orario

La seguente query tiene traccia dei tassi di errore su base oraria per identificare i problemi di tendenza:

fields @timestamp, eventType
| filter eventType like /ERROR_/
| stats count() as error_count by datefloor(@timestamp, 1h) as hour
| sort hour desc

Guida all'ottimizzazione delle prestazioni

Utilizza l'analisi del flusso di eventi per ottimizzare le prestazioni di inserimento degli annunci.

  • Ottimizzazione ADS: collabora con il tuo provider ADS per ottimizzare i tempi di risposta e ridurre la latenza.

  • Preparazione creativa: Pre-transcode aggiungi creatività in base ai tuoi profili di contenuto e riduci i ritardi di elaborazione.

  • Ottimizzazione della configurazione: modifica le impostazioni di timeout, le soglie di personalizzazione e altri parametri di configurazione in base all'analisi del flusso di eventi.

Altre risorse per la risoluzione dei problemi

Per ulteriori indicazioni sulla risoluzione dei problemi oltre all'analisi del flusso di eventi: