Risoluzione dei problemi e salto da MediaTailor - AWS Elemental MediaTailor
CaratteristicheCauseFasi per la risoluzione dei problemiVariabili di sessioneQuery avanzateBest practiceRisorse correlate

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 e salto da MediaTailor

L'ignoramento degli annunci è uno dei problemi più comuni segnalati dai clienti. MediaTailor Questa sezione fornisce un'analisi dettagliata del motivo per cui gli annunci potrebbero essere ignorati durante la riproduzione e offre soluzioni per garantire il corretto inserimento degli annunci.

Sintomi e impatto

Quando si verifica il salto degli annunci, è possibile che si verifichino i seguenti sintomi:

  • Annunci non visualizzati durante le interruzioni pubblicitarie previste

  • Interruzioni pubblicitarie piene di contenuti anziché di pubblicità

  • Riproduzione degli annunci non coerente tra diverse sessioni di visualizzazione

  • CloudWatch registri che mostrano AdSkipped eventi con vari motivi di salto

L'omissione degli annunci ha un impatto diretto sulla generazione di entrate e può portare a esperienze negative per gli spettatori se non viene affrontata tempestivamente.

Cause comuni

MediaTailor registra i motivi specifici per cui gli annunci vengono ignorati nel messaggio del registro FILLED_AVAIL eventi del gruppo di log. MediaTailor/AdDecisionServerInteractions La comprensione di questi motivi del salto è fondamentale per un'efficace risoluzione dei problemi.

Motivi comuni di salto degli annunci
Salta il motivo Descrizione
NEW_CREATIVE L'annuncio non è stato ancora transcodificato. Ciò si verifica quando MediaTailor incontra una nuova creatività pubblicitaria che richiede la transcodifica prima dell'inserimento.
PROFILE_NOT_FOUND Il profilo di MediaConvert transcodifica associato alla configurazione della sessione non esiste, il che impedisce la preparazione degli annunci.
TRANSCODE_ERROR Il processo di transcodifica degli annunci ha riscontrato un errore e non è stato completato.
TRANSCODE_IN_PROGRESS La transcodifica dell'annuncio è ancora in corso e non è ancora pronta per l'inserimento.
INTERNAL_ERROR Si è verificato un MediaTailor errore interno durante la gestione dell'annuncio, che ne ha impedito l'inserimento.
AVAIL_DURATION_EXCEEDED L'annuncio non rientra nella durata residua dell'interruzione pubblicitaria.
LEFTOVER_AVAIL_EXCEEDED_THRESHOLD La durata cumulativa di tutti gli annunci che avrebbero potuto essere inseriti non soddisfa la soglia di personalizzazione configurata per la sessione.
VAST_PARSING_ERROR La risposta VAST dell'ad decision server contiene errori o non è valida.
ADS_TIMEOUT L'ad decision server non ha risposto entro il periodo di timeout configurato.
MEDIA_FILE_UNAVAILABLE I file multimediali pubblicitari specificati nella risposta VAST non sono accessibili.
SESSION_INITIALIZATION_FAILED La MediaTailor sessione non è stata inizializzata correttamente, spesso a causa di variabili di sessione errate.
EARLY_CUE_IN L'interruzione dell'annuncio è terminata prima del previsto a causa di un segnale di attivazione anticipato, che ha impedito l'inserimento completo dell'annuncio.
NO_VARIANT_MATCH La creatività pubblicitaria non dispone di una variante che corrisponda ai parametri di codifica del flusso di contenuti (bitrate, risoluzione, codec).
NO_MODEL_CREATIVE_MATCH La creatività pubblicitaria non soddisfa i requisiti di modello o formato previsti per la configurazione di riproduzione corrente.
REJECTED_REPLICA_VAST La risposta VAST è stata rifiutata a causa della replica o delle politiche di rilevamento dei contenuti duplicati.
INVALID_VAST_WRAPPER_AD L'annuncio wrapper VAST contiene elementi wrapper non validi o non corretti che impediscono il corretto inserimento dell'annuncio.
IMPORT_ERROR Si è verificato un errore durante il processo di importazione dell'annuncio, che ha impedito l'elaborazione dell'annuncio per l'inserimento.
IMPORT_IN_PROGRESS Il processo di importazione degli annunci è attualmente in corso e non è ancora stato completato.

Oltre a questi motivi specifici per saltare, altre cause comuni includono:

  • Configurazione errata delle variabili di sessione

  • Problemi di connettività dell'Ad Decision Server (ADS)

  • Creatività incoerente IDs per lo stesso contenuto pubblicitario

  • Problemi di compatibilità del lettore con il formato manifesto

  • Problemi di configurazione CDN che influiscono sulla distribuzione dei segmenti di annunci

Fasi per la risoluzione dei problemi

Segui questi passaggi per diagnosticare e risolvere i problemi relativi al salto degli annunci:

  1. Identifica il motivo specifico del salto

    Usa CloudWatch Logs Insights per interrogare il gruppo di MediaTailor/AdDecisionServerInteractions log per individuare gli annunci ignorati:

    
fields @timestamp, avail.availId, skippedAds.0.skippedReason, skippedAds.0.creativeUniqueId
| filter eventType = "FILLED_AVAIL" and ispresent(skippedAds.0.skippedReason)
| sort @timestamp desc

    Questa query restituisce gli eventi di salto degli annunci più recenti con i relativi motivi specifici, aiutandoti a identificare i modelli.

  2. Controlla la configurazione delle variabili di sessione

    Le variabili di sessione errate sono una causa comune di salto degli annunci. Verificare che:

    • Tutte le variabili di sessione obbligatorie sono configurate correttamente nel modello di URL ADS

    • Le variabili dinamiche sono formattate correttamente (vedi MediaTailor variabili pubblicitarie dinamiche per la sintassi corretta)

    • I parametri del giocatore vengono passati correttamente a MediaTailor

    Esempio di un URL ADS correttamente configurato con variabili di sessione:

    
https://my-ads-server.com/ads?
sessionId=[session.id]&
playerParams=[player_params.param1]&
deviceType=[player_params.device]&
correlator=[session.avail_duration_ms]

  3. Risolvi i problemi relativi a NEW_CREATIVE

    Se gli annunci vengono ignorati indicando il motivo: NEW_CREATIVE

    MediaTailor transcodifica gli annunci in base a tre fattori chiave: ID creativo, ID account AWS e set di varianti di transcodifica (le rappresentazioni di riproduzione per il flusso di contenuti sottostante). Se una parte del Creative ID o del set di varianti di transcodifica è diversa, MediaTailor riconosce l'annuncio come una nuova variante che richiede la transcodifica. Ciò include le variazioni del bitrate quando viene arrotondato agli 8.000 bit più vicini, il che può verificarsi quando il flusso di contenuti sottostante cambia il manifest principale.

    Per informazioni dettagliate sugli scenari NEW_CREATIVE, tra cui le modifiche al bitrate e i conflitti tra ID creativi, consultate la sezione che segue questa procedura. Analisi NEW_CREATIVE dettagliata

    1. Verifica che il tuo Ad Decision Server restituisca contenuti creativi coerenti IDs per lo stesso contenuto pubblicitario

    2. Verifica se il flusso di contenuti mantiene bitrate e set di varianti coerenti

    3. Valuta la possibilità di implementare la prelettura degli annunci per garantire che gli annunci vengano transcodificati prima della riproduzione (vedi) Prefetching degli annunci

    4. Per problemi persistenti, contatta AWS Support per ulteriore assistenza nella risoluzione dei problemi

  4. Risolvere i problemi di connettività ADS

    Se gli annunci vengono ignorati per motivi correlati ADS_TIMEOUT o per motivi correlati:

    • Verifica che il tuo server decisionale sugli annunci sia accessibile da MediaTailor

    • Verifica se il tuo ADS risponde entro il periodo di timeout configurato

    • Assicurati che il tuo ADS sia in grado di gestire il volume delle richieste durante i periodi di punta

    • Prendi in considerazione l'implementazione di una strategia pubblicitaria alternativa per quando il tuo ADS principale non è disponibile

  5. Risolvi i problemi di risposta VAST

    Se gli annunci vengono ignorati con VAST_PARSING_ERROR oMEDIA_FILE_UNAVAILABLE:

    • Convalida il formato di risposta VAST rispetto alla specifica VAST

    • Assicurati che tutti i file multimediali URLs nella risposta VAST siano accessibili al pubblico

    • Verifica la corretta codifica dei caratteri speciali nel tuo XML VAST

    • Verifica che la tua risposta VAST includa file multimediali in formati compatibili con MediaTailor

  6. Risolvi i problemi di mancata corrispondenza della durata

    Se gli annunci vengono ignorati con AVAIL_DURATION_EXCEEDED o: LEFTOVER_AVAIL_EXCEEDED_THRESHOLD

    • Assicurati che il tuo ADS pubblichi annunci che rientrano nella durata dell'interruzione pubblicitaria disponibile

    • Verifica se i marker delle interruzioni pubblicitarie presenti nei contenuti segnalano correttamente la durata prevista

    • Valuta la possibilità di modificare la soglia di personalizzazione, se appropriata per il tuo caso d'uso

  7. Monitora le metriche CloudWatch

    Imposta CloudWatch allarmi per le MediaTailor metriche chiave per rilevare in modo proattivo i problemi relativi alla saltazione degli annunci:

    • AdDecisionServer.Ads.Skipped- Numero di annunci ignorati

    • AdDecisionServer.Timeouts- Conteggio dei timeout ADS

    • Avail.FilledDuration- Durata delle interruzioni pubblicitarie riempite

    • Avail.SlateOnly- Numero di interruzioni pubblicitarie riempite solo con ardesia

    Per ulteriori informazioni sui parametri disponibili, consulta Monitoraggio AWS Elemental MediaTailor con i CloudWatch parametri di Amazon.

  8. Risolvi i problemi relativi alla corrispondenza delle varianti e al formato

    Se gli annunci vengono ignorati per motivi legati NO_VARIANT_MATCH al formato o per EARLY_CUE_IN motivi legati al formato: NO_MODEL_CREATIVE_MATCH

    • NO_VARIANT_MATCH: assicurati che i tuoi contenuti creativi pubblicitari siano disponibili in varianti che corrispondono ai parametri di codifica del flusso di contenuti (bitrate, risoluzione, codec). Configura il tuo server pubblicitario per fornire annunci in formati compatibili.

    • NO_MODEL_CREATIVE_MATCH: rivedi i requisiti del modello creativo della configurazione di riproduzione e assicurati che il tuo server pubblicitario fornisca annunci che corrispondano al formato e alle specifiche previsti.

    • EARLY_CUE_IN: Verifica che i segnali di ingresso del flusso di contenuti siano programmati correttamente e che le interruzioni pubblicitarie abbiano una durata sufficiente per l'inserimento dell'annuncio. Verifica la presenza di EXT-X-CUE-IN tag prematuri o di messaggi SCTE-35 splice_insert.

  9. Risolvete i problemi relativi al wrapper e all'importazione di VAST

    Se gli annunci vengono ignorati conREJECTED_REPLICA_VAST,INVALID_VAST_WRAPPER_AD, o: IMPORT_ERROR IMPORT_IN_PROGRESS

    • REJECTED_REPLICA_VAST: controlla la configurazione del tuo server pubblicitario per verificare le politiche di rilevamento dei contenuti duplicati. Assicurati che le risposte VAST contengano contenuti creativi unici ed evita di pubblicare annunci identici all'interno della stessa sessione.

    • INVALID_VAST_WRAPPER_AD: Convalida le risposte del wrapper VAST rispetto alle specifiche VAST. Assicurati che tutti gli elementi del wrapper siano formattati correttamente e contengano un TagURI valido. VASTAd

    • IMPORT_ERROReIMPORT_IN_PROGRESS: questi indicano problemi con il processo di importazione degli annunci. Controlla l'accessibilità e la compatibilità dei formati nei file sorgente della creatività pubblicitaria. Monitora l'avanzamento dell'importazione e riprova le importazioni non riuscite.

Analisi NEW_CREATIVE dettagliata

Questa sezione fornisce informazioni complete sugli scenari di omissione degli annunci NEW_CREATIVE, incluse le cause sottostanti e le tecniche avanzate di risoluzione dei problemi.

Scenario di modifiche al bitrate

Le modifiche al bitrate possono far sì che NEW_CREATIVE salti quando il bitrate non corrisponde dopo essere stato arrotondato agli 8.000 bit più vicini. Ciò si verifica in genere quando:

  • Il flusso di contenuti sottostante modifica il manifesto principale

  • Le nuove sessioni vengono create con varianti diverse rispetto alle sessioni esistenti

  • I bitrate del flusso di contenuti non sono coerenti tra le sessioni di riproduzione

Conflitti tra ID creativi

Quando MediaTailor rileva un ID creativo diverso per un file multimediale che è già stato transcodificato, si verifica la seguente sequenza:

  1. L'annuncio viene ignorato con il motivo NEW_CREATIVE

  2. Ciò comporta un tentativo di transcodifica non necessario

  3. La creatività è contrassegnata come DUPLICATE_TRANSCODE o COPY_DEDUP

Nota

MediaTailor non scade né elimina gli annunci transcodificati. Vengono archiviati in un bucket S3 di MediaTailor proprietà a tempo indeterminato.

Elaborazione ETAG

L'ETAG è un identificatore univoco associato a una versione specifica di una playlist o di un manifesto pubblicitario. MediaTailor utilizza l'ID creativo per identificare una risorsa pubblicitaria, ma se l'ID creativo cambia a ogni richiesta, l'annuncio può essere contrassegnato come nuova creatività, impedendone l'inserimento.

avvertimento

Non è garantito che l'ID creativo sia univoco, il che può comportare la visualizzazione di annunci errati.

Problemi relativi al formato della durata

Server-Side Ad Insertion (SSAI) richiede formati di parametri di durata specifici nei file manifest. Formati di durata errati possono causare errori di inserimento degli annunci.

EXT-X-CUE-OUT parametro di durata

Il parametro di durata del EXT-X-CUE-OUT tag deve essere formattato come valore intero, non come formato di durata ISO 8601.

Requisiti del formato della durata
Formato Esempio Stato
Numero intero (corretto) 32 Supportato: rappresenta 32 secondi
Decimale (corretto) 30.000 Supportato: rappresenta 30 secondi
ISO 8601 (errato) PT32S Non supportato: causa errori di inserimento

Esempio di formato manifesto corretto:


#EXTM3U
#EXT-X-VERSION:3
#EXT-X-TARGETDURATION:10
#EXTINF:10.0,
segment1.ts
#EXT-X-CUE-OUT:30
#EXTINF:10.0,
segment2.ts
#EXT-X-CUE-IN
#EXTINF:10.0,
segment3.ts
Importante

Assicurati che tutti i parametri di EXT-X-CUE-OUT durata utilizzino il formato intero per evitare problemi di inserimento degli annunci.

Convalida dei formati degli indicatori pubblicitari

Per convalidare il formato degli indicatori degli annunci e identificare problemi di analisi della durata:

  1. Controlla il formato degli indicatori pubblicitari nei registri sotto gli eventi CloudWatch AD_MARKER_FOUND

  2. Cerca i motivi per FORMAT_ERROR saltare negli eventi FILLED_AVAIL

  3. Verifica che i valori di durata nel tuo manifesto dei contenuti utilizzino formati supportati

  4. Esegui test con diversi formati di durata per identificare problemi di compatibilità

Ottimizzazione del flusso VOD

Gli stream Video On Demand (VOD) possono generare più richieste ADS, il che può influire sulle prestazioni. MediaTailor fornisce funzionalità di ottimizzazione per affrontare questo comportamento.

Problema con più richieste ADS

Per impostazione predefinita, i flussi VOD possono generare più eventi MAKING_ADS_REQUEST nei log. MediaTailor Ciò si verifica perché ogni interruzione pubblicitaria nel contenuto VOD attiva una richiesta ADS separata al server decisionale degli annunci.

Per determinare se i tuoi stream VOD generano un numero eccessivo di richieste ADS, utilizza questa CloudWatch query di Logs Insights:


fields @timestamp, sessionId, eventType, adBreakIndex
| filter eventType = "MAKING_ADS_REQUEST"
| stats count() by sessionId
| sort count desc
| limit 20

Funzione di parallelizzazione VOD

MediaTailor offre una funzionalità di parallelizzazione per ottimizzare la gestione delle richieste ADS per i contenuti VOD. Questa funzione può essere configurata utilizzando il maxConcurrentAdsRequests parametro nella configurazione di riproduzione.

Configurazione di esempio:


{
  "Name": "OptimizedVODConfig",
  "VideoContentSourceUrl": "https://example.com/content/",
  "AdDecisionServerUrl": "https://example.com/ads",
  "maxConcurrentAdsRequests": 3
}

Questa configurazione limita il numero di richieste ADS simultanee, riduce il carico del server e migliora i tempi di risposta.

Wrapped | Gestione delle risposte VAST

La funzione di parallelizzazione ottimizza anche la gestione delle risposte VAST confezionate, comuni negli scenari pubblicitari programmatici. Le risposte VAST racchiuse contengono più livelli di tag VAST che devono essere aperti per raggiungere i file multimediali effettivi.

Risoluzione dei problemi delle variabili di sessione

Le variabili di sessione svolgono un ruolo fondamentale nel targeting e nella selezione degli annunci. Una configurazione errata delle variabili di sessione è una causa comune di problemi di salto degli annunci.

Problemi comuni relativi alle variabili di sessione

I seguenti problemi con le variabili di sessione possono portare alla perdita degli annunci:

  • Variabili obbligatorie mancanti: il tuo Ad Decision Server potrebbe richiedere variabili specifiche che non vengono fornite

  • Sintassi delle variabili errata: le variabili devono utilizzare la sintassi corretta (ad esempio, [session.id] anziché) ${session.id}

  • Problemi di codifica degli URL: i caratteri speciali nei valori delle variabili possono richiedere una codifica URL corretta

  • Parametri del giocatore non coerenti: i parametri del giocatore devono essere trasmessi in modo coerente tra le sessioni

  • Errori di risoluzione variabile dinamica: le variabili che non possono essere risolte verranno sostituite con stringhe vuote

  • Problemi di analisi UPID SCTE-35: i problemi con l'elaborazione UPID di segmentazione possono causare errori di risoluzione delle variabili di sessione.

Verifica della risoluzione delle variabili di sessione

Per verificare che le variabili di sessione vengano risolte correttamente:

  1. Abilita la registrazione di debug per la tua configurazione MediaTailor

  2. Controlla il gruppo di MediaTailor/AdDecisionServerInteractions log per la richiesta ADS effettiva URLs

  3. Verifica che tutte le variabili nell'URL del modello siano state sostituite con valori appropriati

  4. Cerca tutte le variabili che sono state sostituite con stringhe vuote, che potrebbero indicare errori di risoluzione

Esempio di voce di registro che mostra l'URL di una richiesta ADS risolta:


{
  "eventType": "MAKING_ADS_REQUEST",
  "sessionId": "abcd1234-5678-efgh-9012-ijklmnopqrst",
  "requestUrl": "https://my-ads-server.com/ads?sessionId=abcd1234-5678-efgh-9012-ijklmnopqrst&playerParams=mobile&deviceType=android&correlator=30000",
  "timestamp": "2025-06-20T19:00:00Z"
}

Analisi UPID SCTE-35 e variabili di sessione

I problemi con l'elaborazione UPID di segmentazione SCTE-35 possono causare problemi con le variabili di sessione:

  • Requisiti di formato: l'UPID deve avere almeno 12 caratteri e deve essere incluso per una segmentation_upid_type corretta elaborazione. format_identifier

  • Regole di analisi: L'UPID decodificato può contenere delimitatori di due punti per più valori. Il numero di variabili del modello e di token UPID decodificati deve essere uguale.

  • Formati non validi: evita i due punti e virgola senza valori (ad esempio, :: o:46175218::4053) poiché causano errori di analisi.

  • Gestione degli identificatori di formato: MediaTailor presuppone che i primi quattro byte siano format_identifier. Se manca, private_data tronca i primi quattro byte, facendo sì che l'ADS riceva potenzialmente valori diversi dal previsto.

CloudWatch Interrogazioni di Advanced Logs Insights

Utilizza queste query specializzate di CloudWatch Logs Insights per la risoluzione dettagliata dei problemi di inserimento degli annunci:

Alla ricerca della creatività IDs

Per identificare Creative IDs dagli eventi FILLED_AVAIL in ads_interaction_log:


fields @timestamp, sessionId, eventType
| filter sessionId like /sessionId/ and eventType!='BEACON_FIRED'
| sort @timestamp desc
Nota

sessionIdSostituiscilo con l'ID della sessione effettiva su cui stai indagando.

Analisi completa della sessione

Per un'analisi dettagliata del comportamento di inserimento degli annunci per una sessione specifica:


fields @timestamp, sessionId, eventType, creativeId, skipReason, adBreakIndex
| filter sessionId = "your-session-id-here"
| filter eventType in ["FILLED_AVAIL", "SKIPPED_AVAIL", "MAKING_ADS_REQUEST"]
| sort @timestamp asc
| limit 100

NEW_CREATIVE: salta l'analisi

Per analizzare i pattern in NEW_CREATIVE e saltare gli annunci:


fields @timestamp, sessionId, creativeId, skipReason, MediaFileSourceUrl
| filter skipReason = "NEW_CREATIVE"
| stats count() by creativeId, MediaFileSourceUrl
| sort count desc
| limit 50

Le migliori pratiche per evitare che gli annunci vengano saltati

Implementa queste best practice per ridurre al minimo i problemi di salto degli annunci:

  • Implementa la prelettura degli annunci: utilizza la funzione MediaTailor di prelettura degli annunci per garantire che gli annunci vengano transcodificati prima della riproduzione. Vedi per i dettagli sull'implementazionePrefetching degli annunci.

  • Mantieni la coerenza creativa IDs: assicurati che il tuo ad-decision server utilizzi contenuti creativi coerenti IDs per lo stesso contenuto pubblicitario in tutte le sessioni.

  • Garantisci una corretta formattazione della durata: utilizza valori interi per i parametri di EXT-X-CUE-OUT durata anziché il formato ISO 8601.

  • Configura l'ottimizzazione VOD: imposta maxConcurrentAds le richieste per i flussi VOD con più interruzioni pubblicitarie per ridurre il carico del server.

  • Monitora i modelli di transcodifica: monitora CloudWatch i log per l'efficienza della transcodifica e contatta AWS Support se noti modelli che indicano problemi di transcodifica.

  • Verifica la coerenza di ETAG: assicurati che Media File sia coerente per contenuti identici per evitare una URIs ritrascodifica non necessaria.

  • Implementa una risoluzione sistematica della risoluzione dei problemi: segui un approccio strutturato: identifica i motivi degli errori, analizza le cause principali, implementa le risoluzioni e convalida le correzioni.

  • Ottimizza le prestazioni ADS: configura il tuo server decisionale sugli annunci per rispondere rapidamente e gestire i picchi di traffico.

  • Implementa una corretta gestione degli errori: configura i contenuti Slate per riempire le interruzioni pubblicitarie quando gli annunci non possono essere inseriti.

  • Monitora le metriche di inserimento degli annunci: configura CloudWatch allarmi per rilevare tempestivamente i problemi relativi alla saltazione degli annunci.

  • Esegui test approfonditi: convalida il flusso di lavoro di inserimento degli annunci su diversi dispositivi e condizioni di rete.

  • Implementa strategie di fallback: configura le fonti pubblicitarie di backup o gli annunci predefiniti per quando le fonti pubblicitarie principali falliscono.

Per ulteriori informazioni sulla risoluzione dei problemi relativi all'ignoramento degli annunci, consulta questi argomenti correlati: