Prerequisiti Fase 1: Accesso MediaTailor Fase 2: Preparare uno stream Fase 3: Configurazione dell'URL della richiesta ADS e dei parametri di query Fase 4: Creazione di una configurazione Fase 5: Verificare la configurazione Passaggio 6: invia la richiesta di riproduzione a MediaTailor (Facoltativo) fase 7: Monitoraggio dell'attività Fase 8: Pulizia

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.

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

Quando avrai finito, potrai inviare una richiesta di riproduzione a MediaTailor per contenuti pubblicitari personalizzati nel tuo stream.

Argomenti

Prerequisiti
Fase 1: Accesso AWS Elemental MediaTailor
Fase 2: Preparare uno stream
Passaggio 3: configura l'URL della richiesta ADS e i parametri di query
Fase 4: Creazione di una configurazione
Fase 5: Verificare la configurazione
Passaggio 6: invia la richiesta di riproduzione a AWS Elemental MediaTailor
Passaggio 7 (opzionale): Monitora AWS Elemental MediaTailor l'attività
Fase 8: Pulizia

Prerequisiti

Prima di iniziare, devi accertarti di aver completato le fasi in Configurazione AWS Elemental MediaTailor.

Fase 1: Accesso AWS Elemental MediaTailor

Utilizzando le tue credenziali IAM, accedi alla MediaTailor console all'indirizzohttps://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.

Preparare 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:
- #EXT-X-CUE-OUT / #EXT-X-CUE-IN (più comune) con le durate mostrate nell’esempio seguente.
```
#EXT-X-CUE-OUT:60.00
#EXT-X-CUE-IN
```
- #EXT-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 MediaTailor annunci.
I master manifest HLS devono seguire le specifiche HLS documentate in HTTP live streaming: Master playlist tags. In particolare, #EXT-X-STREAM-INF deve includere i campi RESOLUTION, BANDWIDTH e CODEC.

Dopo aver configurato il flusso, prendi nota del prefisso dell'URL dell'origine del contenuto per il manifest master. È 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.
```
  <Period start="PT444806.040S" id="123586" duration="PT15.000S">
    <EventStream timescale="90000" schemeIdUri="urn:scte:scte35:2013:xml">
      <Event duration="1350000">
        <scte35:SpliceInfoSection protocolVersion="0" ptsAdjustment="180832" tier="4095">
          <scte35:SpliceInsert spliceEventId="4026531855" spliceEventCancelIndicator="false" outOfNetworkIndicator="true" spliceImmediateFlag="false" uniqueProgramId="1" availNum="1" availsExpected="1">
            <scte35:Program><scte35:SpliceTime ptsTime="5672624400"/></scte35:Program>
            <scte35:BreakDuration autoReturn="true" duration="1350000"/>
          </scte35:SpliceInsert>
        </scte35:SpliceInfoSection>
      </Event>
    </EventStream>
    <AdaptationSet mimeType="video/mp4"
        ...
    </AdaptationSet>
  </Period>
```

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.)

Esempio 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_id 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_params sono valori dinamici forniti dal lettore

La richiesta di manifest master dal lettore deve fornire coppie chiave-valore corrispondenti ai parametri di query player_params. nell'URL della richiesta dell'ADS. Per ulteriori informazioni sulla configurazione delle coppie chiave-valore nella richiesta a AWS Elemental MediaTailor, consulta Utilizzo di variabili pubblicitarie dinamiche in AWS Elemental MediaTailor.

Inserisci l'URL «modello» configurato quando crei la mappatura del server di origine/ADS in, in. MediaTailor Fase 4: Creazione di una configurazione

Test in corso

Puoi usare una risposta VAST statica dall'ADS a scopo di test. Idealmente, la risposta VAST restituisce un rendering MP4 di qualità intermedia che AWS Elemental MediaTailor è in grado di transcodificare. Se la risposta dell'ADS contiene più rappresentazioni di riproduzione, MediaTailor seleziona la rappresentazione MP4 con la massima qualità e risoluzione 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)

Apri la MediaTailor console all'indirizzo https://console.aws.amazon.com/mediatailor/.
Nella pagina Configurations (Configurazioni), scegliere Create configuration (Crea configurazione).
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.
In Video content source (Origine contenuto video), inserire il prefisso URL per il manifest master HLS e il manifest DASH per questo flusso, meno l'ID asset. Ad esempio, se l'URL del manifest master è http://origin-server.com/a/master.m3u8, specificare 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 manifesti in risposta alle richieste dei giocatori.
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 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 gli URL di annunci in formato intermedio restituiti dall'ADS. Altrimenti, MediaTailor non riesce a recuperare e inserire gli annunci nei manifesti a partire dall'origine del contenuto.
(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.
(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_PERIOD. Per impostazione predefinita, gestisce i manifesti DASH come manifesti multiperiodici. MediaTailor Per ulteriori informazioni, consulta Integrazione di una sorgente MPEG-DASH.
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://bdaaeb4bd9114c088964e4063f849065.mediatailor.us-east-1.amazonaws.com
```
hashed-account-idè il tuo Account AWS ID.

Esempio
```
AKIAIOSFODNN7EXAMPLE
```
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.

Usando i valori degli esempi precedenti, gli URL completi sono i seguenti.

Esempio: HLS


https://bdaaeb4bd9114c088964e4063f849065.mediatailor.us-east-1.amazonaws.com/v1/master/AKIAIOSFODNN7EXAMPLE/myOrigin/master.m3u8

Esempio: DASH


https://bdaaeb4bd9114c088964e4063f849065.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: invia 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 devono essere definite nella richiesta manifest dal lettore.

Esempio

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://bdaaeb4bd9114c088964e4063f849065.mediatailor.us-east-1.amazonaws.com/v1/master/AKIAIOSFODNN7EXAMPLE/myOrigin/master.m3u8?ads.cust_params=viewerinfo


https://bdaaeb4bd9114c088964e4063f849065.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=<filled_in_session_id>&cust_params=viewerinfo

Per ulteriori informazioni sulla configurazione delle coppie chiave-valore da passare all'ADS, consulta Utilizzo di variabili pubblicitarie dinamiche in AWS Elemental MediaTailor.

Passaggio 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)

Aprire la console IAM all'indirizzo https://console.aws.amazon.com/iam/.
Nel pannello di navigazione della console IAM, scegliere Ruoli e quindi Crea ruolo.
Scegli il tipo di Account AWS ruolo Altro.
Per Account ID, inserisci il tuo Account AWS ID.
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.
Scegli Successivo: autorizzazioni.
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):
- CloudWatchLogsFullAccessper fornire l'accesso completo ad Amazon CloudWatch Logs
- CloudWatchFullAccessper fornire l'accesso completo ad Amazon CloudWatch
In Role name (Nome ruolo) immettere MediaTailorLogger e quindi selezionare Create role (Crea ruolo).
Nella pagina Groups (Gruppi) selezionare il ruolo appena creato.
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).
2. Seleziona Modifica relazione di attendibilità.
3. 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.
```
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "mediatailor.amazonaws.com"
      },
      "Action": "sts:AssumeRole",
      "Condition": {
        "StringEquals": {
          "sts:ExternalId": "Midas"
        }
      }
    }
  ]
}
```
4. 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)

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).
Nella casella di conferma Delete configuration (Elimina configurazione) immettere Delete e scegliere di nuovo Delete (Elimina).

AWS Elemental MediaTailor rimuove la configurazione.

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Iniziare con MediaTailor

Guida introduttiva all'assemblaggio dei MediaTailor canali