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à.
# MediaTailor e guida alla risoluzione dei problemi relativi ai salti.
L'omissione degli annunci è uno dei problemi più comuni segnalati MediaTailor dai clienti. Questa guida consente di identificare i problemi relativi all'ignoramento degli annunci e fornisce step-by-step procedure per la risoluzione dei problemi.
## Sintomi e impatto
Quando si verifica il salto degli annunci, è possibile che si verifichino i seguenti sintomi:
+ Gli annunci non vengono visualizzati durante le interruzioni pubblicitarie previste
+ Le interruzioni pubblicitarie mostrano contenuti anziché annunci pubblicitari
+ 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 sulle entrate e può creare esperienze negative per gli spettatori. Risolvi tempestivamente questi problemi per mantenere prestazioni ottimali.
## Identificazione dei motivi del salto
Usa CloudWatch Logs Insights per interrogare il gruppo di `MediaTailor/AdDecisionServerInteractions` log alla ricerca di 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 per aiutarti a identificare i modelli.
**Topics**
+ [Caratteristiche](#ad-skipping-symptoms)
+ [Salta i motivi](#identifying-skip-reasons)
+ [NEW\$1CREATIVE: salto](troubleshooting-new-creative-skipping.md)
+ [Salto del timeout ADS](troubleshooting-ads-timeout-skipping.md)
+ [Salta l'analisi di VAST](troubleshooting-vast-parsing-skipping.md)
+ [Mancata corrispondenza della durata: salto](troubleshooting-duration-mismatch-skipping.md)
+ [salto delle variabili di sessione](troubleshooting-session-variables-skipping.md)
+ [Monitoraggio e saltamento](monitoring-ad-skipping-issues.md)
+ [Le migliori pratiche di prevenzione](preventing-ad-skipping-best-practices.md)
+ [Materiali di riferimento](ad-skipping-reference-materials.md)
# MediaTailor NEW\$1CREATIVE Risoluzione dei problemi relativi alla saltatura degli annunci
Quando gli annunci vengono ignorati indicandone il `NEW_CREATIVE` motivo, AWS Elemental MediaTailor ha rilevato un annuncio che richiede la transcodifica prima dell'inserimento. Questa guida alla risoluzione dei problemi ne spiega le cause e fornisce le procedure di risoluzione. step-by-step
## Cosa fa saltare NEW\$1CREATIVE
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). Quando 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.
### Modifiche al bitrate
Le modifiche al bitrate possono far sì che NEW\$1CREATIVE salti quando il bitrate non corrisponde dopo l'arrotondamento agli 8.000 bit più vicini. Ciò si verifica in genere nelle seguenti situazioni:
+ 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
#### Harvest, varianza della larghezza di banda del lavoro
Per Harvest Jobs, MediaTailor utilizza una soglia di varianza della larghezza di banda del 15% per abbinare gli annunci ai flussi di contenuti. Se c'è una differenza del 15% o più tra la larghezza di banda del live streaming e la larghezza di banda del file HLS raccolto, l'annuncio verrà nuovamente transcodificato. Ciò può far sì che NEW\$1CREATIVE salti durante il processo di transcodifica.
Questo comportamento si verifica in genere quando:
+ Gli stessi annunci pre-transcodificati vengono utilizzati sia per lo streaming live che per i contenuti VOD
+ Il contenuto raccolto ha parametri di codifica diversi rispetto al live streaming originale
+ Le differenze di larghezza di banda superano la soglia del 15% tra i contenuti live e quelli raccolti
### Conflitti con Creative ID
Quando MediaTailor rileva un ID creativo diverso per un file multimediale già transcodificato, si verifica la seguente sequenza:
1. L'annuncio viene ignorato con il motivo NEW\$1CREATIVE
1. Ciò comporta un tentativo di transcodifica non necessario
1. La creatività è contrassegnata come DUPLICATE\$1TRANSCODE o COPY\$1DEDUP
**Nota**
MediaTailor non scade né elimina gli annunci transcodificati. Li conserviamo in un bucket S3 di MediaTailor proprietà a tempo indeterminato.
## Passaggi di risoluzione
Per risolvere i problemi relativi al salto degli annunci NEW\$1CREATIVE:
1. Verifica che il tuo server decisionale sugli annunci restituisca contenuti creativi coerenti IDs per gli stessi contenuti pubblicitari.
1. Verifica che il flusso di contenuti mantenga bitrate e set di varianti costanti.
1. Valuta la possibilità di implementare la prelettura degli annunci per garantire che gli annunci vengano transcodificati prima della riproduzione. Per ulteriori informazioni, consulta [Prefetching degli annunci](prefetching-ads.md).
1. Per problemi persistenti, contatta [AWS Support](https://aws.amazon.com/premiumsupport/) per ulteriore assistenza nella risoluzione dei problemi.
## Monitoraggio dei pattern NEW\$1CREATIVE
Usa questa query di CloudWatch Logs Insights per analizzare i pattern in NEW\$1CREATIVE e salta:
```
fields @timestamp, sessionId, creativeId, skipReason, MediaFileSourceUrl
| filter skipReason = "NEW_CREATIVE"
| stats count() by creativeId, MediaFileSourceUrl
| sort count desc
| limit 50
```
# MediaTailor Risoluzione dei problemi relativi al timeout e al salto ADS
Quando gli annunci vengono ignorati per motivi correlati, hai problemi di connettività o di prestazioni con il tuo server decisionale sugli annunci. `ADS_TIMEOUT` AWS Elemental MediaTailor richiede una comunicazione affidabile con il tuo ADS per inserire correttamente gli annunci. Questa guida alla risoluzione dei problemi spiega come identificare e risolvere questi problemi di connettività.
## Problemi comuni di connettività ADS
I problemi comuni di connettività ADS includono quanto segue:
+ Ad decision server non accessibile da MediaTailor
+ ADS non risponde entro il periodo di timeout configurato
+ ADS non è in grado di gestire il volume delle richieste durante i periodi di punta
+ Problemi di connettività di rete tra MediaTailor e il tuo ADS
## Passaggi di risoluzione
Per risolvere i problemi di timeout di ADS:
1. Verifica che il tuo server decisionale sugli annunci sia accessibile da MediaTailor.
1. Verifica che il tuo ADS risponda entro il periodo di timeout configurato.
1. Assicurati che il tuo ADS sia in grado di gestire il volume delle richieste durante i periodi di punta.
1. Prendi in considerazione l'implementazione di una strategia pubblicitaria alternativa per quando il tuo ADS principale non è disponibile.
## Monitoraggio delle prestazioni ADS
Imposta CloudWatch allarmi per la `AdDecisionServer.Timeouts` metrica per rilevare in modo proattivo i problemi di connettività ADS.
# MediaTailor Risoluzione dei problemi relativi all'analisi e al salto di VAST
Quando gli annunci vengono ignorati con `VAST_PARSING_ERROR` o`MEDIA_FILE_UNAVAILABLE`, hai problemi con le risposte VAST o i file multimediali degli annunci. AWS Elemental MediaTailor richiede risposte VAST formattate correttamente e file multimediali accessibili per un corretto inserimento degli annunci. Questa guida alla risoluzione dei problemi spiega come identificare e risolvere questi problemi.
## Problemi comuni relativi a VAST
I problemi più comuni relativi a VAST includono i seguenti:
+ Formato di risposta VAST non conforme alle specifiche VAST
+ File multimediale URLs in risposta VAST non accessibile al pubblico
+ Caratteri speciali non codificati correttamente in VAST XML
+ Nella risposta VAST mancano i file o i formati multimediali richiesti
## Passaggi di risoluzione
Per risolvere i problemi di analisi di VAST:
1. Convalida il formato di risposta VAST rispetto alle specifiche VAST.
1. Assicurati che tutti i file multimediali URLs nella risposta VAST siano accessibili al pubblico.
1. Verifica la corretta codifica dei caratteri speciali nel tuo XML VAST.
1. Verifica che la tua risposta VAST includa file multimediali in formati compatibili con MediaTailor.
## Risoluzione dei problemi relativi al wrapper VAST
Per problemi con `INVALID_VAST_WRAPPER_AD` o: `REJECTED_REPLICA_VAST`
+ 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
+ Controlla la configurazione del server pubblicitario per le politiche di rilevamento dei contenuti duplicati
+ Assicurati che le risposte VAST contengano contenuti creativi unici all'interno della stessa sessione
# MediaTailor risoluzione dei problemi relativi alla mancata corrispondenza della durata e alla mancata corrispondenza
Quando gli annunci vengono ignorati o per motivi legati al formato `AVAIL_DURATION_EXCEEDED``LEFTOVER_AVAIL_EXCEEDED_THRESHOLD`, hai problemi di durata o di compatibilità del formato. AWS Elemental MediaTailor richiede una durata, una formattazione e una corrispondenza corrette tra il contenuto dell'annuncio e le interruzioni pubblicitarie disponibili. Questa guida alla risoluzione dei problemi spiega come identificare e risolvere questi problemi relativi alla durata.
## Problemi comuni di durata
I problemi di durata più comuni includono quanto segue:
+ Annunci più lunghi della durata delle interruzioni pubblicitarie disponibili
+ Marcatori di interruzione pubblicitaria errati nei contenuti che segnalano una durata errata
+ Soglia di personalizzazione non soddisfatta per l'inserimento degli annunci
+ Formato di durata errato nei tag EXT-X-CUE-OUT
## Requisiti del formato della 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 |
## Passaggi di risoluzione
Per risolvere i problemi di mancata corrispondenza della durata:
1. Assicurati che ADS pubblichi annunci che rientrano nella durata delle interruzioni pubblicitarie disponibili.
1. Verifica che i marker delle interruzioni pubblicitarie presenti nei contenuti indichino correttamente la durata prevista.
1. Verifica che i parametri di EXT-X-CUE-OUT durata utilizzino il formato intero.
1. Valuta la possibilità di modificare la soglia di personalizzazione, se appropriato per il tuo caso d'uso.
# MediaTailor variabile di sessione e risoluzione dei problemi relativi ai salti
Le variabili di sessione svolgono un ruolo fondamentale nel targeting e nella selezione degli annunci in AWS Elemental MediaTailor. Una configurazione errata delle variabili di sessione è una causa comune di problemi di salto degli annunci. Questa guida completa alla risoluzione dei problemi spiega come identificare e risolvere i problemi relativi alle variabili di sessione che possono impedire il corretto inserimento degli annunci.
## Problemi comuni relativi alle variabili di sessione
I problemi più comuni relativi alle variabili di sessione includono quanto segue:
+ **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 potrebbero 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 dinamica** delle variabili: le variabili che non possono essere risolte vengono 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
1. Controlla il gruppo di `MediaTailor/AdDecisionServerInteractions` log per la richiesta ADS effettiva URLs
1. Verifica che tutte le variabili nell'URL del modello siano state sostituite con valori appropriati
1. Cerca tutte le variabili che sono state sostituite con stringhe vuote, che potrebbero indicare errori di risoluzione
## Risoluzione dei problemi di analisi UPID SCTE-35
I problemi con l'elaborazione UPID di segmentazione SCTE-35 possono causare problemi relativi alle variabili di sessione:
+ **Requisiti di formato:** UPID deve avere almeno 12 e includere 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
# MediaTailor e saltamento degli annunci, monitoraggio e avvisi
Il monitoraggio proattivo ti aiuta a rilevare e risolvere i problemi di saltamento degli annunci prima che abbiano un impatto significativo sulle tue entrate. AWS Elemental MediaTailor offre metriche complete e funzionalità di registrazione che consentono un monitoraggio efficace delle prestazioni di inserimento degli annunci. Questa guida spiega come impostare un monitoraggio efficace per i problemi di salto degli annunci.
## CloudWatch Metriche chiave da monitorare
Imposta gli CloudWatch allarmi per queste metriche chiave MediaTailor :
+ `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
## Domande su Advanced CloudWatch Logs Insights
Utilizza queste query specializzate per una risoluzione dettagliata dei problemi:
### 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
```
### Alla ricerca della creatività IDs
Per identificare Creative IDs dagli eventi FILLED\$1AVAIL:
```
fields @timestamp, sessionId, eventType
| filter sessionId like /sessionId/ and eventType!='BEACON_FIRED'
| sort @timestamp desc
```
**Nota**
`sessionId`Sostituiscilo con l'ID della sessione effettiva su cui stai indagando.
# MediaTailor e saltare le migliori pratiche di prevenzione
L'implementazione di queste best practice aiuta a prevenire i problemi di saltamento degli annunci prima che si verifichino, garantendo migliori prestazioni di inserimento degli annunci e una maggiore protezione dei ricavi. AWS Elemental MediaTailor Queste misure proattive risolvono le cause più comuni di salto degli annunci e aiutano a mantenere una distribuzione coerente degli annunci.
## Misure proattive
+ **Implementa la prelettura degli annunci: utilizza la** funzione MediaTailor di prelettura degli annunci per garantire che gli annunci vengano transcodificati prima della riproduzione. Per i dettagli sull'implementazione[Prefetching degli annunci](prefetching-ads.md), consulta
+ **Mantieni la coerenza creativa IDs**: assicurati che il tuo server decisionale pubblicitario 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
+ **Ottimizza le prestazioni ADS**: configura il tuo server decisionale sugli annunci per rispondere rapidamente e gestire i picchi di traffico
## Linee guida di implementazione
+ **Implementa una corretta gestione degli errori**: configura i contenuti Slate per riempire le interruzioni pubblicitarie quando gli annunci non possono essere inseriti
+ **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
+ **Monitora i modelli di transcodifica**: monitora CloudWatch i log per l'efficienza della transcodifica e contatta AWS [Support](https://aws.amazon.com/premiumsupport/) se noti modelli che indicano problemi di transcodifica
# MediaTailor e una guida di riferimento per saltare
Questa sezione fornisce informazioni di riferimento complete sui motivi del salto ad e collegamenti alla documentazione correlata per. AWS Elemental MediaTailor Utilizza questa guida di riferimento per comprendere i significati specifici dei diversi motivi di salto e trovare risorse aggiuntive per la risoluzione dei problemi.
## Completa e salta i riferimenti ai motivi
MediaTailor registra i motivi specifici per cui gli annunci vengono ignorati nel messaggio del registro `FILLED_AVAIL` eventi del gruppo di log. `MediaTailor/AdDecisionServerInteractions`
**Compila e salta i motivi**
| Salta il motivo | Description |
| --- | --- |
| NEW\$1CREATIVE | L'annuncio non è stato ancora transcodificato. Ciò si verifica quando MediaTailor incontra una nuova creatività pubblicitaria che richiede la transcodifica prima dell'inserimento. |
| PROFILE\$1NOT\$1FOUND | Il profilo di MediaConvert transcodifica associato alla configurazione della sessione non esiste, il che impedisce la preparazione degli annunci. |
| TRANSCODE\$1ERROR | Il processo di transcodifica degli annunci ha riscontrato un errore e non è stato completato. |
| TRANSCODE\$1IN\$1PROGRESS | La transcodifica dell'annuncio è ancora in corso e non è ancora pronta per l'inserimento. |
| INTERNAL\$1ERROR | Si è verificato un MediaTailor errore interno durante la gestione dell'annuncio, che ne ha impedito l'inserimento. |
| AVAIL\$1DURATION\$1EXCEEDED | L'annuncio non rientra nella durata residua dell'interruzione pubblicitaria. |
| LEFTOVER\$1AVAIL\$1EXCEEDED\$1THRESHOLD | La durata cumulativa di tutti gli annunci che avrebbero potuto essere inseriti non soddisfa la soglia di personalizzazione configurata per la sessione. |
| VAST\$1PARSING\$1ERROR | La risposta VAST dell'ad decision server contiene errori o non è valida. |
| ADS\$1TIMEOUT | L'ad decision server non ha risposto entro il periodo di timeout configurato. |
| MEDIA\$1FILE\$1UNAVAILABLE | I file multimediali pubblicitari specificati nella risposta VAST non sono accessibili. |
| SESSION\$1INITIALIZATION\$1FAILED | La MediaTailor sessione non è stata inizializzata correttamente, spesso a causa di variabili di sessione errate. |
| EARLY\$1CUE\$1IN | 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\$1VARIANT\$1MATCH | La creatività pubblicitaria non dispone di una variante che corrisponda ai parametri di codifica del flusso di contenuti (bitrate, risoluzione, codec). |
| NO\$1MODEL\$1CREATIVE\$1MATCH | La creatività pubblicitaria non soddisfa i requisiti di modello o formato previsti per la configurazione di riproduzione corrente. |
| REJECTED\$1REPLICA\$1VAST | La risposta VAST è stata rifiutata a causa della replica o delle politiche di rilevamento dei contenuti duplicati. |
| INVALID\$1VAST\$1WRAPPER\$1AD | L'annuncio wrapper VAST contiene elementi wrapper non validi o non corretti che impediscono il corretto inserimento dell'annuncio. |
| IMPORT\$1ERROR | Si è verificato un errore durante il processo di importazione dell'annuncio, che ha impedito l'elaborazione dell'annuncio per l'inserimento. |
| IMPORT\$1IN\$1PROGRESS | Il processo di importazione degli annunci è attualmente in corso e non è ancora stato completato. |
## Risorse correlate
Per ulteriori informazioni sulla risoluzione dei problemi relativi all'ignoramento degli annunci, consulta questi argomenti correlati:
+ [MediaTailor variabili pubblicitarie dinamiche per le richieste ADS](variables.md)- Guida completa alle variabili pubblicitarie dinamiche in MediaTailor
+ [Prefetching degli annunci](prefetching-ads.md)- Come implementare il prefetching degli annunci per evitare salti dovuti alla transcodifica
+ [Monitoraggio AWS Elemental MediaTailor con CloudWatch parametri Amazon](monitoring-cloudwatch-metrics.md)- MediaTailor CloudWatch Monitoraggio con metriche
+ [Visualizzazione dei log AWS Elemental MediaTailor](monitoring-through-logs.md)- Come visualizzare e analizzare i log MediaTailor
+ [Risoluzione dei problemi relativi al flusso di MediaTailor eventi](troubleshooting-event-flow.md)- Comprensione del flusso degli eventi di inserimento degli annunci