View a markdown version of this page

Creazione e gestione di funzioni - AWS Elemental MediaTailor
Impostazione di una funzioneGestione di funzioniRimozione di una funzioneRegole di convalidaGuida di riferimento alle API

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

Creazione e gestione di funzioni

Questa pagina illustra come creare, allegare, aggiornare ed eliminare le funzioni tramite la console. MediaTailor Le funzioni consentono di personalizzare il comportamento della sessione e le richieste di annunci eseguendo la logica nei punti chiave durante la riproduzione.

Impostazione di una funzione

Creazione di una funzione utilizzando la console

  1. Apri la MediaTailor console.

  2. Nel riquadro di navigazione, seleziona Funzioni.

  3. Scegli Crea funzione.

  4. Per ID funzione, immettete un nome univoco per la funzione (ad esempio,fetchIdentity).

  5. Per Tipo di funzione, scegliete CUSTOM_OUTPUTHTTP_REQUEST,VAST_REQUEST,SEQUENTIAL_EXECUTOR, oCONCURRENT_EXECUTOR. La console visualizza i campi di configurazione per il tipo selezionato.

  6. Compila i campi di configurazione specifici del tipo. Per una descrizione di ogni tipo di funzione e dei relativi campi, vedere. Tipi di funzioni e composizione

  7. Scegli Crea funzione.

Collegamento di una funzione a una configurazione di riproduzione

Una funzione non viene eseguita finché non la si collega a una configurazione di riproduzione tramite una mappatura delle funzioni (un collegamento tra un hook del ciclo di vita e una funzione). La mappatura delle funzioni specifica quale hook del ciclo di vita attiva la funzione.

  1. MediaTailor Aprire la console.

  2. Nel pannello di navigazione, scegli Configurazioni.

  3. Scegli la configurazione di riproduzione che desideri aggiornare.

  4. Nella sezione Mappatura delle funzioni, scegli Modifica.

  5. Per ogni hook del ciclo di vita, seleziona la funzione da collegare:

    • Hook di inizializzazione della sessione: scegli una funzione da eseguire una volta all'inizio della sessione.

    • Hook per la richiesta di annunci: scegli una funzione da eseguire prima di ogni richiesta ADS.

    • Aggancio di risposta agli annunci: scegli una funzione da eseguire dopo la ricezione e l'analisi di ogni risposta ADS.

    • Hook di inserimento pre-manifesto: scegli una funzione da eseguire sul set di annunci finale appena prima che gli annunci vengano inseriti nel manifesto.

  6. Selezionare Salva.

Gestione di funzioni

Funzioni di visualizzazione

Vai su Funzioni per vedere tutte le funzioni del tuo account. Scegli il nome di una funzione per visualizzarne la configurazione.

Aggiornamento di una funzione esistente

Per aggiornare una funzione, accedi a Funzioni, scegli la funzione e modifica la configurazione. L'aggiornamento sostituisce l'intera definizione della funzione.

Suggerimento

Salvate una copia della configurazione della funzione prima di apportare modifiche. Non è previsto il controllo delle versioni o il rollback integrato per le funzioni.

Rimozione di una funzione

Scollegare una funzione da una configurazione di riproduzione

Prima di eliminare una funzione, rimuovetela da tutte le configurazioni di riproduzione che vi fanno riferimento.

  1. Aprite la MediaTailor console.

  2. Nel pannello di navigazione, scegli Configurazioni.

  3. Scegli la configurazione di riproduzione.

  4. Nella sezione Mappatura delle funzioni, scegli Modifica.

  5. Rimuovi la funzione dal gancio del ciclo di vita.

  6. Selezionare Salva.

Eliminazione di una funzione

Accedere a Funzioni, selezionare la funzione e scegliere Elimina.

Regole di blocco delle cancellazioni

MediaTailor impedisce di eliminare una funzione ancora in uso.

Condizione Risultato
La funzione è collegata a una configurazione di riproduzione tramite la mappatura delle funzioni L'eliminazione è bloccata. Scollegare prima la funzione.
La funzione è referenziata in un o SEQUENTIAL_EXECUTOR CONCURRENT_EXECUTOR L'eliminazione è bloccata. Rimuovete prima il riferimento dalla funzione principale.
La funzione non è referenziata da nessuna parte L'eliminazione ha esito positivo.

Regole di convalida

MediaTailor convalida la tua funzione quando la crei o la aggiorni. Vengono eseguiti i seguenti controlli:

  • Sintassi delle espressioni: tutte le espressioni devono essere Jsonata valide.

  • Funzioni limitate: le espressioni non possono chiamare funzioni JSonata limitate. Vedi JSONatariferimento all'espressione per l'elenco completo.

  • Prefissi delle chiavi di output: tutte le chiavi di output devono iniziare con un prefisso dello spazio dei nomi riconosciuto. Per l'elenco dei prefissi accettati, vedere. Hook del ciclo di vita

  • Riferimenti alle funzioni: tutti gli ID delle funzioni in un modulo FunctionList devono fare riferimento a funzioni esistenti.

  • Riferimenti circolari: una funzione non può fare riferimento a se stessa, direttamente o indirettamente.

  • Profondità di annidamento: A SEQUENTIAL_EXECUTOR può chiamare altre funzioni, ma tali funzioni non possono essere esse stesse esecutrici.

Per valori specifici e limiti di dimensione, vedere. Limits

Guida di riferimento alle API

Per gestire le funzioni a livello di codice, consulta l'AWS Elemental MediaTailor API Reference.