Creazione di pianificazioni di prefetch

La procedura seguente spiega come creare una pianificazione di prefetch utilizzando la console. MediaTailor Per informazioni sulla creazione e la gestione delle pianificazioni di prefetch a livello di codice utilizzando il, consultate MediaTailor API PrefetchSchedulesAWS Elemental MediaTailor APIRiferimento.

Nota

Se desideri utilizzare i criteri di corrispondenza della disponibilità in una pianificazione, assicurati di configurare prima il ADS URL modello della configurazione di riproduzione con variabili dinamiche, altrimenti i criteri di corrispondenza della disponibilità non avranno alcun effetto. Per informazioni sull'utilizzo delle variabili dinamiche, consulta Fase 3: Configurazione dei parametri di ADS richiesta URL e interrogazione l'argomento Guida introduttiva all'inserimento degli MediaTailor annunci.

Per creare una nuova pianificazione di prefetch utilizzando la console

1. Apri la MediaTailor console all'indirizzo. https://console.aws.amazon.com/mediatailor/

2. Nel riquadro di navigazione, scegli Configurazioni. Seleziona la configurazione di riproduzione per la quale desideri creare una pianificazione di prefetch.

3. Nella scheda Pianificazioni di prefetch, scegliete Aggiungi pianificazione di prefetch.

4. Nel riquadro dei dettagli della pianificazione Prefetch, procedi come segue:

   • In Nome, inserisci un identificatore per la tua pianificazione di prefetch, ad esempio. my-prefetch-schedule

   • Per Stream ID, inserisci facoltativamente un ID univoco. Se la tua origine contiene più stream di riproduzione, puoi utilizzare questo ID per indicare di MediaTailor inserire gli annunci in uno stream specifico. Ad esempio, se la tua origine ha uno streaming sportivo e uno di un programma TV, puoi utilizzare lo stream ID per creare pianificazioni prefetch per inserire annunci mirati allo streaming sportivo. Trasmetti il valore dell'ID dello stream all' MediaTailor inizializzazione della sessione o alla richiesta del manifesto del tuo cliente. Per ulteriori informazioni, consulta l'esempio seguente.

     • Per il tracciamento lato server, includi il parametro e il valore della ?aws.streamId query nella GET HTTP richiesta del client all'endpoint. MediaTailor Per informazioni generali sul tracciamento lato server, consulta. Monitoraggio degli annunci lato server Una richiesta manifest a un HLS endpoint che include un ID di streaming è simile alla seguente, myStreamId dov'è il nome del tuo ID di streaming:

       GET <mediatailorURL>/v1/master/<hashed-account-id>/<origin-id>/<asset-id>?aws.streamId=myStreamId

     • Per il tracciamento lato client, includi la streamId chiave e il valore nel corpo della richiesta di inizializzazione della POST HTTP sessione del client all'endpoint /v1/session. MediaTailor Per informazioni generali sul tracciamento lato client, consulta. Monitoraggio degli annunci lato client Una richiesta di inizializzazione della sessione che include un ID di streaming è simile alla seguente, myStreamId dov'è il nome del tuo ID di streaming:

       POST <mediatailorURL>/v1/session/<hashed-account-id>/<origin-id>/<asset-id>
       {
           'streamId': 'myStreamId'
       }

     Mostra piùMostra meno

5. Nel riquadro Recupero, specifica le impostazioni di recupero che desideri utilizzare. Queste impostazioni determinano quando MediaTailor prerecupera gli annunci da. ADS Determinano inoltre quali variabili dinamiche includere nella richiesta aADS, se ce ne sono.

   • In Ora di inizio, inserisci l'ora in cui MediaTailor puoi avviare i recuperi prefetch per questa interruzione pubblicitaria. MediaTailor cercherà di precaricare gli annunci per le richieste manifeste effettuate dal cliente a partire da tale orario. Il valore predefinito è l'ora corrente. Se non specifichi un valore, il servizio avvia il recupero del prefetch il prima possibile.

   • In Ora di fine, inserisci l'ora in cui desideri interrompere la visualizzazione anticipata degli MediaTailor annunci per questa interruzione pubblicitaria. MediaTailor cercherà di recuperare in anticipo gli annunci per le richieste manifeste che si verificano in questo momento o prima. La finestra di recupero può sovrapporsi alla finestra di consumo.

   • Nella sezione Variabili dinamiche, inserisci fino a 100 variabili dinamiche. MediaTailor utilizza queste variabili per la sostituzione nelle richieste di prefetch inviate a. ADS Se non inserisci alcuna variabile dinamica, MediaTailor fa del tuo meglio per interpolare i valori delle variabili dinamiche contenute nel tuo. ADSURL

     • Seleziona Aggiungi variabile dinamica.

     • Per Chiave, inserisci una chiave variabile dinamica, ad esempioscte.event_id. È possibile utilizzare qualsiasi variabile dinamica che MediaTailor supporti. Per informazioni sulle variabili dinamiche, vedereUtilizzo di variabili pubblicitarie dinamiche in MediaTailor.

     • Per Valore, immettere un valore di variabile dinamica, ad esempio my-event.

     • Per aggiungere un'altra variabile dinamica, scegliete Seleziona Aggiungi variabile dinamica.

6. Nel riquadro Consumo, specifica le impostazioni che desideri utilizzare per la finestra di consumo. Queste impostazioni determinano MediaTailor quando inserire gli annunci nell'interruzione pubblicitaria. Determinano inoltre i criteri di corrispondenza delle disponibilità che desideri utilizzare.

   • In Ora di inizio, inserisci l'ora in cui desideri iniziare MediaTailor a inserire gli annunci preimpostati nell'interruzione pubblicitaria. Il valore predefinito è l'ora corrente. Se non specifichi un orario, il servizio avvia il prefetch consumption il prima possibile.

   • Per Ora di fine, inserisci l'ora in cui desideri MediaTailor interrompere l'inserimento degli annunci preimpostati nell'interruzione pubblicitaria. MediaTailor cercherà di recuperare in anticipo gli annunci relativi alle richieste manifeste del cliente che si verificano in questo momento o prima di tale data. L'ora di fine deve essere successiva all'ora di inizio e tra meno di un giorno. La finestra di consumo può sovrapporsi alla finestra di recupero.

   • Nella sezione Disponibilità dei criteri di abbinamento, seleziona Aggiungi criteri di disponibilità e aggiungi fino a cinque criteri di corrispondenza alla tua pianificazione. Quindi, in Chiave variabile dinamica, aggiungi una chiave variabile dinamica, ad esempio. scte.event_id MediaTailor inserirà gli annunci preimpostati nell'interruzione pubblicitaria solo se soddisfano i criteri definiti dai valori delle variabili dinamiche a MediaTailor cui il cliente trasmette o che MediaTailor deduce da informazioni come i dati della sessione. Per informazioni, consulta la sezione precedente. avail-matching-criteria

7. Seleziona Aggiungi criteri di utilizzo.

Le pianificazioni di prefetch scadono automaticamente dopo l'ora di fine della finestra di consumo. A fini diagnostici, rimangono visibili per almeno 7 giorni, dopodiché MediaTailor vengono eliminati automaticamente. In alternativa, è possibile eliminare manualmente una pianificazione di prefetch in qualsiasi momento. Per informazioni su come eliminare manualmente una pianificazione di prefetch, consultate la sezione seguente. Eliminazione delle pianificazioni di prefetch

Determinare la frequenza con cui il cliente deve chiamare il CreatePrefetchSchedule API

Se sai esattamente quando si verificheranno le interruzioni pubblicitarie, il tuo cliente può effettuare una chiamata programmatica CreatePrefetchScheduleAPIuna volta al giorno per impostare il recupero e il consumo. In alternativa, il cliente può chiamarli più API volte nel corso della giornata per definire il recupero e il consumo. Quando scegli una frequenza di API chiamata, prendi in considerazione il numero massimo MediaTailor di pianificazioni di prefetch attive e la probabilità che la pianificazione delle interruzioni pubblicitarie cambi dopo aver creato le pianificazioni di prefetch. Se è probabile che la pianificazione delle interruzioni pubblicitarie cambi dopo aver creato le pianificazioni di prefetch, ti consigliamo di chiamarle più frequentemente. API