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à. # Guida introduttiva all'inserimento di MediaTailor annunci Per utilizzarlo AWS Elemental MediaTailor, sono necessarie le autorizzazioni Account AWS e i permessi per accedere, visualizzare e modificare MediaTailor le configurazioni. Per informazioni su come fare, consulta [Configurazione AWS Elemental MediaTailor](setting-up.md). Questo tutorial illustra come eseguire le attività seguenti: + Prepara i tuoi flussi di contenuti HLS o DASH + Configura un URL del modello di Ad Decision Server (ADS) + Crea una MediaTailor configurazione che contenga un endpoint di riproduzione + Usa il tuo lettore o la rete di distribuzione dei contenuti (CDN) per effettuare una richiesta di riproduzione a MediaTailor Per la configurazione avanzata degli URL ADS utilizzando variabili dinamiche e parametri del lettore, consulta. [MediaTailor variabili pubblicitarie dinamiche per le richieste ADS](variables.md) Per informazioni sulla trasmissione dei parametri CDNs, consulta[MediaTailor parametri di query manifest](manifest-query-parameters.md). Quando avrai finito, potrai inviare una richiesta di riproduzione a MediaTailor contenuti pubblicitari personalizzati nel tuo stream. **Topics** + [Prerequisiti](#prerequisites) + [Fase 1: Accesso AWS Elemental MediaTailor](#access-emt) + [Fase 2: Preparare uno stream](#getting-started-prep-stream) + [Passaggio 3: configura l'URL della richiesta ADS e i parametri di query](#getting-started-configure-request) + [Fase 4: Creazione di una configurazione](#getting-started-add-mapping) + [Fase 5: Verificare la configurazione](#getting-started-test-config) + [Passaggio 6: Inviare la richiesta di riproduzione a AWS Elemental MediaTailor](#send-request-to-mediatailor) + [Fase 7 (opzionale): Monitora AWS Elemental MediaTailor l'attività](#monitor-step) + [Fase 8: Pulizia](#clean-up) ## Prerequisiti Prima di iniziare, devi accertarti di aver completato le fasi in [Configurazione AWS Elemental MediaTailor](setting-up.md). ## Fase 1: Accesso AWS Elemental MediaTailor Utilizzando le tue credenziali IAM, accedi alla MediaTailor console all'indirizzo**https://console.aws.amazon.com/mediatailor/home**. ## Fase 2: Preparare uno stream Configura il server di origine per produrre manifest per HLS o DASH che siano compatibili con AWS Elemental MediaTailor. Il server di origine deve utilizzare porte HTTP standard (porta 80) o porte HTTPS (porta 443). MediaTailor non supporta porte personalizzate per la comunicazione con il server di origine. ### Prepara uno stream HLS I manifest HLS devono soddisfare i seguenti requisiti: + I manifest devono essere accessibili pubblicamente su Internet. + I manifest devono essere live o video on-demand (VOD). + I manifest devono avere un valore `EXT-X-VERSION` di `3` o superiore. + Per i contenuti live, i manifest devono contenere contrassegni per indicare gli spazi pubblicitari. Si tratta di un'opzione facoltativa per i contenuti VOD, che possono invece utilizzare offset temporali VMAP. Il file manifest deve includere slot di annunci contrassegnati con uno dei seguenti: + **\$1EXT-X-CUE-OUT /\$1EXT -X-CUE-IN** (più comune) con durate come mostrato nell'esempio seguente. ``` #EXT-X-CUE-OUT:60.00 #EXT-X-CUE-IN ``` + **\$1EXT-X-DATERANGE** (meno comune) con le durate mostrate nell'esempio seguente. ``` #EXT-X-DATERANGE:ID="",START-DATE="",DURATION=30.000,SCTE35-OUT=0xF #EXT-X-DATERANGE:ID="",START-DATE="",DURATION=30.000,SCTE35-OUT=0xF ``` Tutti i campi visualizzati per `#EXT-X-DATERANGE` sono obbligatori. Il modo in cui si configurano i marcatori di annunci nel manifest determina se gli annunci vengono inseriti in un flusso o se sostituiscono altri frammenti nel flusso. Per ulteriori informazioni, consulta [Comprensione del comportamento di inserimento degli AWS Elemental MediaTailor annunci](ad-behavior.md). + [Le playlist multivarianti HLS devono seguire le specifiche HLS documentate in HTTP live streaming: Master playlist tags.](https://tools.ietf.org/html/draft-pantos-http-live-streaming-21#section-4.3.4) In particolare, `#EXT-X-STREAM-INF` deve includere i campi `RESOLUTION`, `BANDWIDTH` e `CODEC`. Dopo aver configurato lo stream, prendi nota del prefisso URL di origine del contenuto per la playlist multivariante. È necessario per creare la configurazione AWS Elemental MediaTailor, più avanti in questo tutorial. ### Prepara uno stream DASH I manifest DASH devono soddisfare i seguenti requisiti: + I manifest devono essere accessibili pubblicamente su Internet. + I manifest devono essere live o video on-demand (VOD). + I manifest devono contrassegnare gli eventi come spazi pubblicitari utilizzando indicatori di inserimento di collegamenti o di segnale temporale. Puoi fornire i contrassegni pubblicitari in XML o in file binari con codifica Base64. Per l'inserimento della giunzione, l' out-of-networkindicatore deve essere abilitato. Per gli indicatori del segnale orario, l'ID del tipo di segmentazione, situato all'interno dell'UPID di segmentazione, deve essere un valore cue-out riconosciuto da. AWS Elemental MediaTailor L’inizio dello spazio pubblicitario coincide con quello dell’evento e si protrae per tutta la durata dell'evento, se specificata, o fino all'inizio dell’evento successivo. L'esempio seguente mostra un evento designato come spazio pubblicitario con i contrassegni di inserimento di collegamenti. La durata di questo spazio pubblicitario corrisponde a quella dell'evento. ``` ``` + Gli spazi pubblicitari devono avere le stesse impostazioni dei flussi di contenuti per `AdaptationSet` e `Representation`. AWS Elemental MediaTailor usa queste impostazioni per transcodificare gli annunci e garantire la corrispondenza con il flusso di contenuti, per un passaggio fluido tra i due. Dopo aver configurato il flusso, prendi nota del prefisso dell'URL dell'origine del contenuto per il manifest DASH. È necessario per creare la configurazione in, più avanti in questo AWS Elemental MediaTailor tutorial. ## Passaggio 3: configura l'URL della richiesta ADS e i parametri di query Per determinare i parametri di query richiesti dall'ADS, genera un URL di tag dell'annuncio dall'ADS. Questo URL funge da modello per le richieste all'ADS e include quanto segue: + Valori statici + Valori generati da AWS Elemental MediaTailor (indicati da `session` o parametri di `avail` query) + I valori generati dai lettori, ottenuti dall'applicazione client (denotati dai parametri di query `player_params.`) **Example URL di tag dell’annuncio da un ADS** ``` https://my.ads.com/ad?output=vast&content_id=12345678&playerSession=[session.id]&cust_params=[player_params.cust_params] ``` Dove: + **output** e **content\$1id** sono valori statici + **playerSession= [session.id**] è un valore dinamico fornito da. AWS Elemental MediaTailor Il valore di **[session.id]** cambia per ogni sessione di lettore e determina un URL diverso per la richiesta VAST per ogni sessione. + **cust\$1params** sono valori dinamici forniti dal lettore La richiesta di playlist multivariante da parte del player deve fornire coppie chiave-valore che corrispondono ai parametri di query nell'URL della richiesta ADS. `player_params.` Per ulteriori informazioni sulla configurazione delle coppie chiave-valore nella richiesta a, consulta. AWS Elemental MediaTailor[MediaTailor variabili pubblicitarie dinamiche per le richieste ADS](variables.md) Inserisci l'URL «modello» configurato quando crei la server/ADS mappatura dell'origine in, in. MediaTailor [Fase 4: Creazione di una configurazione](#getting-started-add-mapping) **Test in corso** Puoi usare una risposta VAST statica dall'ADS a scopo di test. Idealmente, la risposta VAST restituisce una MP4 rappresentazione di qualità mezzanina che può essere transcodificata. AWS Elemental MediaTailor Se la risposta dell'ADS contiene più rappresentazioni di riproduzione, MediaTailor seleziona la resa con la qualità e la risoluzione MP4 più elevate e la invia al transcoder. ## Fase 4: Creazione di una configurazione La AWS Elemental MediaTailor configurazione contiene le informazioni di mappatura per il server di origine e ADS. **Per creare una configurazione (console)** 1. Apri la MediaTailor console all'indirizzo [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/). 1. Nella pagina **Configurations (Configurazioni)**, scegliere **Create configuration (Crea configurazione)**. 1. Nella sezione **Configuration (Configurazione)** nella parte inferiore della pagina, in **Configuration name (Nome configurazione)** inserire un nome univoco che descriva la configurazione. Il nome è l'identificatore principale per la configurazione. La lunghezza massima consentita è 512 caratteri. 1. Per la **fonte di contenuto video**, inserisci il prefisso URL per la playlist multivariante HLS o il manifesto DASH per questo stream, meno l'ID della risorsa. Ad esempio, se l'URL della playlist multivariante è, devi inserire. `http://origin-server.com/a/master.m3u8` `http://origin-server.com/a/` In alternativa, è possibile specificare un prefisso più breve, ad esempio `http://origin-server.com`, ma è necessario includere `/a/` nell'ID asset nella richiesta di contenuto del lettore. La lunghezza massima è 512 caratteri. **Nota** Se l'origine del contenuto usa HTTPS, il relativo certificato deve provenire da un'autorità di certificazione nota. Non può essere un certificato autofirmato. Altrimenti, AWS Elemental MediaTailor non riesce a connettersi all'origine del contenuto e non può fornire i manifesti in risposta alle richieste dei giocatori. 1. Per **Ad Decision Server**, inserisci l'URL del tuo ADS. Si tratta dell'URL con variabili descritto in [Passaggio 3: configura l'URL della richiesta ADS e i parametri di query](#getting-started-configure-request) oppure dell'URL VAST statico utilizzato a scopo di test. La lunghezza massima è 25.000 caratteri. **Nota** Se l'ADS usa HTTPS, il relativo certificato deve provenire da un'autorità di certificazione nota. Non può essere un certificato autofirmato. Lo stesso vale per l'annuncio mezzanino URLs restituito dall'ADS. In caso contrario, MediaTailor non riesce a recuperare e unire gli annunci nei manifest dall'origine del contenuto. 1. (Facoltativo se necessario per DASH) Per **Localizzazione**, scegli **DISABILITATO** se hai impostato le regole di routing CDN per accedere ai MediaTailor manifesti e stai utilizzando la segnalazione lato client o se i giocatori supportano reindirizzamenti HTTP permanenti. Per ulteriori informazioni sulla funzionalità **Location (Posizione)**, consulta [funzione di localizzazione DASH](dash-location-feature.md). 1. (Facoltativo) Se il server di origine produce manifest DASH a singolo periodo, scegliere **DASH mpd manifest origin type (Tipo di origine del manifest mpd DASH)**, quindi **SINGLE\$1PERIOD**. Per impostazione predefinita, gestisce i manifesti DASH come manifesti multiperiodici. MediaTailor Per ulteriori informazioni, consulta [Integrazione di una sorgente MPEG-DASH](manifest-dash.md). 1. Scegli **Crea configurazione**. AWS Elemental MediaTailor **visualizza la nuova configurazione nella pagina Configurazioni.** ## Fase 5: Verificare la configurazione Dopo aver salvato la configurazione, testa il flusso usando un URL nel formato appropriato per il protocollo di streaming: + Esempio: HLS ``` playback-endpoint/v1/master/hashed-account-id/origin-id/master.m3u8 ``` + Esempio: DASH ``` playback-endpoint/v1/dash/hashed-account-id/origin-id/manifest.mpd ``` Dove: + `playback-endpoint` è l'endpoint di riproduzione univoco generato da AWS Elemental MediaTailor durante la creazione della configurazione. Esempio ``` https://777788889999.mediatailor.us-east-1.amazonaws.com ``` + `hashed-account-id`è il tuo Account AWS ID. Esempio ``` 777788889999 ``` + `origin-id` è il nome assegnato durante la creazione della configurazione. Esempio ``` myOrigin ``` + `master.m3u8` o `manifest.mpd` è il nome del manifest dal flusso di test con l'aggiunta dell'estensione file. In questo modo puoi ottenere un manifest pienamente identificato quando lo aggiungi all'origine del contenuto video configurata in [Fase 4: Creazione di una configurazione](#getting-started-add-mapping). Utilizzando i valori degli esempi precedenti, i dati completi URLs sono i seguenti. + Esempio: HLS ``` https://777788889999.mediatailor.us-east-1.amazonaws.com/v1/master/AKIAIOSFODNN7EXAMPLE/myOrigin/master.m3u8 ``` + Esempio: DASH ``` https://777788889999.mediatailor.us-east-1.amazonaws.com/v1/dash/AKIAIOSFODNN7EXAMPLE/myOrigin/manifest.mpd ``` Puoi testare il flusso utilizzando uno dei metodi seguenti. + Come mostrato nell'esempio precedente, immetti l'URL in un lettore autonomo. + Testa il flusso nell'ambiente del lettore. ## Passaggio 6: Inviare la richiesta di riproduzione a AWS Elemental MediaTailor Configura il lettore downstream o CDN per l'invio delle richieste di riproduzione all'endpoint di riproduzione della configurazione fornito da AWS Elemental MediaTailor. Tutte le variabili dinamiche definite dal lettore che usi nell'URL della richiesta ADS in [Passaggio 3: configura l'URL della richiesta ADS e i parametri di query](#getting-started-configure-request) devono essere definite nella richiesta manifest dal lettore. **Example** Supponi che l'URL ADS modello sia il seguente. ``` https://my.ads.com/ad?output=vast&content_id=12345678&playerSession=[session.id]&cust_params=[player_params.cust_params] ``` Quindi definisci `[player_params.cust_params]` nella richiesta del giocatore anteponendo la coppia chiave-valore con. `ads.` AWS Elemental MediaTailor passa i parametri che non sono preceduti al server di origine `ads.` anziché all'ADS. L'URL della richiesta del lettore è una variante dei seguenti esempi HLS e DASH. ``` https://777788889999.mediatailor.us-east-1.amazonaws.com/v1/master/AKIAIOSFODNN7EXAMPLE/myOrigin/master.m3u8?ads.cust_params=viewerinfo ``` ``` https://777788889999.mediatailor.us-east-1.amazonaws.com/v1/dash/AKIAIOSFODNN7EXAMPLE/myOrigin/manifest.mpd?ads.cust_params=viewerinfo ``` Quando AWS Elemental MediaTailor riceve la richiesta del giocatore, definisce le variabili del giocatore in base alle informazioni contenute nella richiesta. L'URL della richiesta ADS risultante è una variante di quanto segue. ``` https://my.ads.com/ad?output=vast&content_id=12345678&playerSession=&cust_params=viewerinfo ``` Per ulteriori informazioni sulla configurazione delle coppie chiave-valore da passare all'ADS, consulta [MediaTailor variabili pubblicitarie dinamiche per le richieste ADS](variables.md). ## Fase 7 (opzionale): Monitora AWS Elemental MediaTailor l'attività Usa Amazon CloudWatch e Amazon CloudWatch Logs per tenere traccia delle AWS Elemental MediaTailor attività, ad esempio il numero di richieste, errori e disponibilità di annunci riempiti. Se è la prima volta che utilizzi CloudWatch with AWS Elemental MediaTailor, crea un ruolo AWS Identity and Access Management (IAM) per consentire la comunicazione tra i servizi. **Per consentire AWS Elemental MediaTailor l'accesso a CloudWatch (console)** 1. Aprire la console IAM all'indirizzo [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/). 1. Nel pannello di navigazione della console IAM, scegliere **Ruoli** e quindi **Crea ruolo**. 1. Scegli il tipo di Account AWS ruolo **Altro**. 1. Per **Account ID**, inserisci il tuo Account AWS ID. 1. Selezionare **Require external ID (Richiedi ID esterno)** e immetter **midas**. Questa opzione aggiunge automaticamente una condizione alla policy di attendibilità che consente al servizio di assumere il ruolo solo se la richiesta include il corretto `sts:ExternalID`. 1. Scegli **Successivo: autorizzazioni**. 1. Aggiungere una policy di autorizzazione che specifichi le azioni che questo ruolo può eseguire. Selezionare una delle opzioni seguenti, quindi scegliere **Next: Review (Successivo: Esamina)**: + **CloudWatchLogsFullAccess**per fornire l'accesso completo ad Amazon CloudWatch Logs + **CloudWatchFullAccess**per fornire l'accesso completo ad Amazon CloudWatch 1. In **Role name (Nome ruolo)** immettere **MediaTailorLogger** e quindi selezionare **Create role (Crea ruolo)**. 1. Nella pagina **Groups (Gruppi)** selezionare il ruolo appena creato. 1. Modificare la relazione di trust per aggiornare l'entità principale: 1. Nella pagina **Summary (Riepilogo)** del ruolo, selezionare la scheda **Trust relationship (Relazione di trust)**. 1. Seleziona **Modifica relazione di attendibilità**. 1. Nel documento di policy, impostare l'entità principale sul servizio AWS Elemental MediaTailor . L'URL dovrebbe essere simile a questo. ``` "Principal": { "Service": "mediatailor.amazonaws.com" }, ``` La policy intera dovrebbe risultare come segue. 1. Scegli **Update Trust Policy (Aggiorna policy di trust)**. ## Fase 8: Pulizia Per evitare addebiti estranei, elimina tutte le configurazioni superflue. **Per eliminare una configurazione (console)** 1. Nella pagina AWS Elemental MediaTailor **Configurazioni**, esegui una delle seguenti operazioni: + In **Configuration name (Nome configurazione)** scegliere la configurazione da eliminare. + Nella colonna **Configuration name (Nome configurazione)** selezionare il pulsante di opzione e scegliere **Delete (Elimina)**. 1. Nella casella di conferma **Delete configuration (Elimina configurazione)** immettere **Delete** e scegliere di nuovo **Delete (Elimina)**. AWS Elemental MediaTailor rimuove la configurazione.