Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Guía de inicio rápido de funciones

En esta guía, se explica cómo crear la primera función, cómo adjuntarla a una configuración de reproducción y cómo comprobar si se ha ejecutado. Al final, dispondrás de una función funcional que clasifica el tipo de dispositivo (ctvmobile, odesktop) de cada espectador y lo almacena como un parámetro del reproductor disponible en todas las solicitudes de ADS.

Requisitos previos

Antes de empezar, asegúrate de tener una configuración de MediaTailor reproducción existente. Si no dispone de una, consulte ¿Cómo empezar con MediaTailor.

Paso 1: Crear una función de

En este paso, se crea una función que clasifica el tipo de dispositivo del espectador en función de la cadena del agente de usuario y almacena el resultado en los parámetros del reproductor. La función utiliza un tipo de salida personalizado (sin llamadas a la API externa) con una Referencia de expresión JSonata expresión para evaluar el agente de usuario.

Una notificación de éxito confirma que la función se ha creado y se le redirige a la página de detalles de la función.

La configuración de la función resultante es:

{
    "FunctionId": "myFirstFunction",
    "FunctionType": "CUSTOM_OUTPUT",
    "Description": "Classify device type from user agent",
    "CustomOutputConfiguration": {
        "Runtime": "JSONATA",
        "Output": {
            "player_params.deviceType": "{% $contains(session.user_agent, 'CTV') ? 'ctv' : $contains(session.user_agent, 'Mobile') ? 'mobile' : 'desktop' %}"
        }
    }
}

Paso 2: Adjunte la función a una configuración de reproducción

Asigne la función a un enlace del ciclo de vida de su configuración de reproducción. El mapeo indica MediaTailor cuándo ejecutar la función.

Esto se conecta al enlace del ciclo myFirstFunction de vida. INICIALIZACIÓN PREVIA A LA SESIÓN El mapeo de funciones resultante es:

{
    "FunctionMapping": {
        "PRE_SESSION_INITIALIZATION": "myFirstFunction"
    }
}

MediaTailor ejecuta la función una vez al inicio de cada nueva sesión en esta configuración de reproducción.

Paso 3: Iniciar una sesión y comprobar que la función se ha ejecutado

Inicie una nueva sesión de reproducción para activar la función. Utilice una solicitud de inicialización de sesión para el punto final de inicialización de sesión de su configuración de reproducción.

MediaTailor publica automáticamente CloudWatch las métricas de cada ejecución de una función, sin necesidad de suscribirse. Tras iniciar una sesión, comprueba las siguientes métricas en el espacio de AWS/MediaTailor nombres para confirmar que la función se ha ejecutado:

Si la función falla, MediaTailor envía los eventos del registro de errores a los registros de manifiesto de forma predeterminada (no es necesaria ninguna configuración):

En el siguiente ejemplo, se muestra un PRE_SESSION_INIT_FUNCTION_ERROR evento relacionado con un error de sintaxis en la expresión de la función:

{
    "eventTimestamp": "2024-01-01T12:00:00.076000000Z",
    "eventType": "PRE_SESSION_INIT_FUNCTION_ERROR",
    "eventDescription": "Function execution failed",
    "awsAccountId": "123456789012",
    "originId": "my-config",
    "sessionId": "session-123",
    "requestId": "req-abc",
    "eventId": "5dc6f040-0f72-4e8c-a64e-25eeef62708c",
    "functionId": "myFirstFunction",
    "functionType": "CUSTOM_OUTPUT",
    "executionTimeMs": 2,
    "errorType": "SYNTAX_ERROR",
    "cause": "Expected \")\" before end of expression",
    "input": {}
}

Utilice el eventId campo para correlacionar los eventos de error de gancho y función para la misma ejecución. El errorType campo indica la clase de error; consulte Solución de problemas y supervisión para obtener una lista completa de los tipos de errores y sus correcciones.

¿Qué ocurre entre bastidores

Este es el flujo de solicitudes completo para la función que acabas de crear:

Si la función falla por cualquier motivo, MediaTailor descarta el resultado y procede como si no hubiera ninguna función asociada. El espectador sigue viendo anuncios, solo que sin segmentar por tipo de dispositivo.

Temas sugeridos

Ahora tiene una función funcional asociada a una configuración de reproducción. Desde aquí: