Prerequisiti Fase 1: Accesso MediaTailor Fase 2: Preparare uno stream Fase 3: Configurazione dei parametri di ADS richiesta URL e interrogazione 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 HLS contenuti DASH
Configura un modello di Ad Decision Server (ADS) URL
Crea una MediaTailor configurazione che contenga un endpoint di riproduzione
Usa il 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
Fase 3: Configurazione dei parametri di ADS richiesta URL e interrogazione
Fase 4: Creazione di una configurazione
Fase 5: Verificare la configurazione
Passo 6: Inviare la richiesta di riproduzione a AWS Elemental MediaTailor
Fase 7 (opzionale): Monitorare l'attività AWS Elemental MediaTailor
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 IAM le tue credenziali, accedi alla MediaTailor console all'indirizzohttps://console.aws.amazon.com/mediatailor/home.

Fase 2: Preparare uno stream

Configura il tuo server di origine per produrre manifesti per HLS o DASH compatibili con AWS Elemental MediaTailor.

Prepara uno stream HLS

HLSi manifesti devono soddisfare i seguenti requisiti:

I manifest devono essere accessibili pubblicamente su Internet.
I manifesti devono essere in diretta o in 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. Questo è facoltativo per i VOD contenuti, che possono invece utilizzare VMAP timeoffsets.

Il file manifest deve includere slot di annunci contrassegnati con uno dei seguenti:
- # EXT -X- CUE -OUT/# EXT -X- CUE -IN (più comune) con durate come mostrato nell'esempio seguente.
```
#EXT-X-CUE-OUT:60.00
#EXT-X-CUE-IN
```
- # EXT -X- DATERANGE (meno comune) con durate come mostrato 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.
HLSi master manifest devono seguire le HLS specifiche documentate in HTTPlive streaming: Master playlist tags. In particolare, #EXT-X-STREAM-INF deve includere i campi RESOLUTION, BANDWIDTH e CODEC.

Dopo aver configurato lo stream, annota il URL prefisso di origine del contenuto per il manifesto principale. È necessario per creare la configurazione AWS Elemental MediaTailor, più avanti in questo tutorial.

Preparate uno stream DASH

DASHi manifesti devono soddisfare i seguenti requisiti:

I manifest devono essere accessibili pubblicamente su Internet.
I manifesti devono essere in diretta o in 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 marker degli annunci in chiaro XML o in formato binario con codifica base64. Per l'inserimento della giuntura, l'indicatore deve essere abilitato. out-of-network Per gli indicatori del segnale orario, l'ID del tipo di segmentazione, situato all'interno della segmentazioneUPID, 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 lo stream, annota il prefisso di origine URL del contenuto per il manifest. DASH È necessario per creare la configurazione in AWS Elemental MediaTailor, più avanti in questo tutorial.

Fase 3: Configurazione dei parametri di ADS richiesta URL e interrogazione

Per determinare i parametri di query ADS richiesti, genera un tag di annuncio URL daADS. Questo URL funge da modello per le richieste aADS, ed è composto da quanto segue:

Valori statici
Valori generati da AWS Elemental MediaTailor (indicati da session o parametri di avail interrogazione)
I valori generati dai lettori, ottenuti dall'applicazione client (denotati dai parametri di query player_params.)

Esempio Aggiungi tag URL 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 del giocatore e risulta diverso per la richiesta URL per ogni sessione. VAST
cust_params sono valori dinamici forniti dal lettore

La richiesta master manifest del player deve fornire coppie chiave-valore che corrispondano ai parametri di player_params. interrogazione contenuti nella richiesta. ADS URL 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 il «modello» configurato URL quando crei il server di origine/ ADS mapping in, in. MediaTailor Fase 4: Creazione di una configurazione

Test in corso

Puoi utilizzare una VAST risposta statica del tuo a ADS scopo di test. Idealmente, la VAST risposta restituisce una MP4 rappresentazione di qualità mezzanina che AWS Elemental MediaTailor può essere transcodificata. Se la risposta di ADS contiene più rappresentazioni di riproduzione, MediaTailor sceglie 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)

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.
Per Sorgente di contenuto video, inserite il URL prefisso del manifesto HLS principale o del DASH manifesto di questo stream, meno l'ID della risorsa. Ad esempio, se il manifesto principale URL èhttp://origin-server.com/a/master.m3u8, inserirete. 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 lo utilizzaHTTPS, 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.
Per Ad decision server, inserisci URL for yourADS. Si tratta della variabile URL with, come descritto inFase 3: Configurazione dei parametri di ADS richiesta URL e interrogazione, o della variabile statica VAST URL che stai utilizzando a scopo di test. La lunghezza massima è 25.000 caratteri.

Nota
Se lo ADS utilizziHTTPS, il relativo certificato deve provenire da un'autorità di certificazione nota. Non può essere un certificato autofirmato. Lo stesso vale per il piano rialzato e URLs restituito dal. ADS In caso contrario, MediaTailor non riesce a recuperare e inserire gli annunci nei manifesti a partire dall'origine del contenuto.
(Facoltativo se necessario perDASH) Per quanto riguarda la posizione, scegli DISABLEDse hai impostato delle regole di CDN routing per accedere ai MediaTailor manifesti e se utilizzare i report sul lato client oppure se i giocatori supportano i reindirizzamenti permanenti. HTTP

Per ulteriori informazioni sulla funzionalità Location (Posizione), consulta DASHfunzione di localizzazione.
(Facoltativo) Se il server di origine produce manifesti a periodo singolo, scegli il tipo di origine DASH DASHmpd manifest, quindi scegli _. SINGLE PERIOD Per impostazione predefinita, MediaTailor gestisce i manifesti come DASH manifesti a più periodi. Per ulteriori informazioni, consulta Integrazione di un MPEG - source DASH.
Scegli Crea configurazione.

AWS Elemental MediaTailor visualizza la nuova configurazione nella pagina Configurazioni.

Fase 5: Verificare la configurazione

Dopo aver salvato la configurazione, prova lo stream utilizzando un URL formato appropriato per il tuo 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.

Utilizzando i valori degli esempi precedenti, i dati completi URLs 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, inserisci URL in un lettore indipendente.

Testa il flusso nell'ambiente del lettore.

Passo 6: Inviare la richiesta di riproduzione a AWS Elemental MediaTailor

Configura il lettore downstream o invia CDN le richieste di riproduzione all'endpoint di riproduzione della configurazione fornito da. AWS Elemental MediaTailor Tutte le variabili dinamiche definite dal giocatore che hai utilizzato nella richiesta in Fase 3: Configurazione dei parametri di ADS richiesta URL e interrogazione devono essere definite URL nella ADS richiesta manifesta del player.

Esempio

Supponiamo che il modello ADS URL 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 da al server di origine ads. anziché a. ADS

La richiesta del giocatore URL è una variante dei seguenti HLS esempi. 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. La ADS richiesta risultante URL è una variante di questa.


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 a, vedere. ADS Utilizzo di variabili pubblicitarie dinamiche in AWS Elemental MediaTailor

Fase 7 (opzionale): Monitorare l'attività AWS Elemental MediaTailor

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

Apri la IAM console all'indirizzo https://console.aws.amazon.com/iam/.
Nel riquadro di navigazione della IAM console, scegli Ruoli, quindi scegli Crea ruolo.
Scegli un altro tipo di Account AWS ruolo.
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