View a markdown version of this page

Output personalizzato - AWS Elemental MediaTailor
Quando utilizzarloCampi di configurazioneComportamento di runtimeEsempio: ripartizione A/B del traffico

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

Output personalizzato

Quando utilizzarlo

Da utilizzare CUSTOM_OUTPUT quando la logica delle funzioni è puramente computazionale. I casi d'uso più comuni includono la classificazione dei dispositivi in base a stringhe di user agent, la selezione degli URL dei server di decisione degli annunci con logica di A/B test e la riformattazione dei parametri dei giocatori prima che raggiungano l'ad decision server.

CUSTOM_OUTPUTle funzioni sono il tipo più veloce perché valutano le espressioni in memoria senza chiamate di rete. Scegliete questo tipo ogni volta che potete raggiungere il vostro obiettivo senza contattare un servizio esterno.

Campi di configurazione

Una CUSTOM_OUTPUT funzione ha due campi:

  • Runtime: il linguaggio delle espressioni. Impostalo suJSONATA.

  • Output: una mappa di coppie chiave-valore. Ogni chiave è un nome di associazione di output (ad esempioplayer_params.device_type) e ogni valore è un'espressione che viene MediaTailor valutata in fase di esecuzione.

Nota

{%...%}Da utilizzare per racchiudere JSONata le espressioni in campi di tipo stringa. I valori senza questi delimitatori vengono trattati come stringhe statiche. Ad esempio, "{%session.id%}" valuta l'espressione, mentre "session.id" è il testo letterale.

Comportamento di runtime

Quando MediaTailor esegue una CUSTOM_OUTPUT funzione, valuta ogni espressione nel blocco di output rispetto allo stato corrente della sessione. Tutte le espressioni visualizzano la stessa istantanea di input. I risultati valutati diventano gli output della funzione.

Se un'espressione non riesce a valutare, MediaTailor scarta l'intero output della funzione e procede come se nessuna funzione fosse associata. La funzione non esegue il commit parziale dei risultati.

Esempio: ripartizione A/B del traffico

La seguente funzione assegna in modo casuale ogni interruzione pubblicitaria a uno dei due URL del server di decisione pubblicitaria. È progettato per il ciclo di vita. PRE_ADS_REQUEST

{
    "FunctionId": "abTestAdsUrl",
    "FunctionType": "CUSTOM_OUTPUT",
    "CustomOutputConfiguration": {
        "Runtime": "JSONATA",
        "Output": {
            "adsRequest.url": "{%$random() < 0.5 ? 'https://ads.example.com/v1' : 'https://ads.example.com/v2'%}"
        }
    }
}

Per una panoramica completa di questo esempio, vedi. Esempi di funzioni