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 di MediaTailor eventi
La comprensione del flusso di AWS Elemental MediaTailor eventi fornisce una solida base per la risoluzione dei problemi di inserimento degli annunci. Analizzando la sequenza, la tempistica e gli schemi degli eventi, puoi identificare rapidamente dove si verificano i problemi e implementare soluzioni mirate.
Questa sezione fornisce indicazioni pratiche per l'utilizzo dell'analisi del flusso di eventi per diagnosticare i problemi. Per comprendere i concetti di base sul flusso di eventi, vedereFlusso degli eventi di inserimento degli annunci.
Identificazione di flussi di eventi incompleti
I flussi di eventi incompleti si verificano quando la sequenza di eventi prevista si interrompe prima di raggiungere la corretta 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
Punti di errore diversi 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 relativi ai marcatori degli annunci o al manifesto stesso che MediaTailor impediscono di effettuare una richiesta ADS. Dopo l'invio della 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 ADS non valido URLs che vengono scoperti solo quando viene effettuata la richiesta.
-
Beacon di tracciamento mancante: potrebbe indicare problemi di configurazione del tracciamento, problemi di segnalazione lato server o lacune di implementazione sul lato client.
CloudWatch interrogazioni per un'analisi del flusso incompleta
Usa queste query di 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 query che analizzano le interazioni con il server decisionale pubblicitario, le opportunità pubblicitarie e gli errori relativi agli annunci.
-
MediaTailor/TranscodeService- Utilizzalo 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 personalizzazione del manifesto efficace
Gruppo di log:/ MediaTailorAdDecisionServerInteractions
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:/ MediaTailorAdDecisionServerInteractions
La seguente query identifica le sessioni che hanno esaurito i posti disponibili ma non gli eventi beacon corrispondenti:
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 identifica 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 relativi alla tempistica degli eventi
L'analisi della tempistica degli eventi aiuta a identificare gli ostacoli alle prestazioni e a ottimizzare i flussi di lavoro di inserimento degli annunci. Schemi temporali insoliti spesso indicano problemi di fondo che influiscono sull'esperienza degli spettatori.
Soglie di tempistica delle prestazioni
Utilizzate queste soglie temporali per identificare potenziali problemi di prestazioni.
-
Durata totale del flusso superiore a 5 secondi: può influire sull'esperienza degli spettatori 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 o altri componenti del sistema. EC2
-
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 di elaborazione creativa, problemi del server di origine (come i timeout di recupero del manifesto) o problemi interni del MediaTailor sistema, inclusi vincoli di infrastruttura con NAT Gateway, DynamoDB o altri componenti. EC2
Interrogazioni di analisi temporale
Utilizza queste query per analizzare i modelli di tempistica 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 che superano i 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 analizza i tempi di risposta di ADS
La seguente query analizza i tempi di risposta ADS e identifica quelli che superano i 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 del manifesto
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 di flusso di eventi più frequenti, organizzate per tipo di problema e sintomi.
Errori delle richieste del server decisionale pubblicitario
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 erroreERROR_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.
-
Problemi con i certificati SSL/TLS: assicurati che il tuo ADS utilizzi certificati SSL validi emessi da un'autorità di certificazione affidabile. In particolare, per Google Ad Manager, potrebbe essere necessario contattare AWS Support
per abilitare un flag di configurazione che accetti i certificati SSL di Google.
Domanda diagnostica
La seguente query aiuta a diagnosticare gli errori delle richieste ADS tracciando 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 decisionale pubblicitario
Sintomi: le richieste ADS hanno esito positivo ma MediaTailor non ricevono risposta oppure 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.
-
Svuota l'inventario degli annunci: verifica la disponibilità dell'inventario degli annunci e i criteri di targeting nella configurazione ADS.
Domanda diagnostica
La seguente query aiuta a 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
Manifesti errori di personalizzazione
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: verifica 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 alla ricerca di eventi di errore come, o.INTERNAL_ERROR
MISSING_VARIANTS,
PROFILE_NOT_FOUND
-
Problemi di mancata corrispondenza della durata: verifica che le durate degli annunci corrispondano alle durate delle interruzioni pubblicitarie disponibili.
-
Problemi relativi alla soglia di personalizzazione: rivedi le impostazioni delle soglie di personalizzazione nella configurazione di riproduzione.
Domanda diagnostica
La seguente query aiuta a diagnosticare gli errori di personalizzazione del manifesto esaminando le risposte VAST e gli avallamenti completi:
fields @timestamp, eventType, sessionId, skippedAds | filter sessionId = "your-session-id" | filter eventType in ["VAST_RESPONSE", "FILLED_AVAIL", "WARNING_NO_ADVERTISEMENTS"] | sort @timestamp asc
Query per motivi di annuncio ignorati
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
Interrogazione per motivi relativi all'annuncio ignorato e per motivi creativi unici IDs
La seguente query fornisce informazioni dettagliate sugli annunci ignorati, compresi i motivi e la creatività unica IDs per i primi due annunci di ciascuna pubblicazione:
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
-
Problemi di implementazione lato client: la maggior parte dei problemi relativi ai beacon di tracciamento derivano da problemi di implementazione lato client, ad esempio la scarsa URLs frequenza del tracciamento dei sondaggi per il tracciamento lato client, o problemi di logica di attivazione dei beacon specifici giocatori.
-
Monitoraggio dei problemi di accessibilità degli URL: verifica che il tracciamento nelle risposte VAST sia accessibile e restituisci risposte appropriate. URLs I problemi possono verificarsi quando non URLs sono raggiungibili o quando si MediaTailor riscontrano problemi interni che impediscono il corretto invio delle risposte di tracciamento.
-
Problemi relativi alla richiesta del segmento di giocatore: possono verificarsi apparenti errori nel tracciamento dei beacon quando il giocatore client non richiede effettivamente alcun segmento. Ciò non comporta l'invio di beacon, il che sembra un errore di tracciamento ma in realtà è un problema di implementazione del giocatore piuttosto che un problema di beacon.
Domanda diagnostica
La seguente query aiuta a diagnosticare gli errori di tracciamento dei beacon esaminando gli avail pieni e gli eventi 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 sulla percentuale di completamento del flusso: avvisa quando il rapporto tra la riuscita della personalizzazione del manifesto e le opportunità pubblicitarie scende al di sotto delle soglie accettabili.
-
Allarme sui tempi di risposta ADS: monitora i tempi di risposta medi di ADS e avvisa quando superano le soglie di performance.
-
Allarme relativo al tasso di errore: monitora la frequenza degli eventi di errore e segnala picchi insoliti di tipi di errore specifici.
Interrogazioni 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 per ora 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-transcodifica gli annunci creativi per adattarli ai tuoi profili di contenuto e ridurre i ritardi di elaborazione.
-
Ottimizzazione della configurazione: regola 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:
-
Per informazioni dettagliate sul formato del registro e sulle specifiche tecniche, vedereVisualizzazione dei registri.
-
Per una risoluzione completa dei problemi più comuni relativi all'inserimento degli annunci, consultaRisoluzione dei problemi più comuni.
-
Per indicazioni sulla configurazione del monitoraggio e degli avvisi, consulta. Monitoraggio AWS Elemental MediaTailor con i CloudWatch parametri di Amazon
-
Per le procedure di registrazione del debug, vedere. Generazione di registri di debug