Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Kurzanleitung für Funktionen

In dieser Anleitung erfahren Sie, wie Sie Ihre erste Funktion erstellen, sie einer Wiedergabekonfiguration zuordnen und überprüfen, ob sie ausgeführt wurde. Am Ende haben Sie eine funktionierende Funktion, die den Gerätetyp (, oderdesktop) jedes Zuschauers klassifiziert und ihn als Player-Parameter speichert ctvmobile, der in jeder ADS-Anfrage verfügbar ist.

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie über eine bestehende MediaTailor Wiedergabekonfiguration verfügen. Falls Sie noch keines haben, beachten Sie die Informationen unter Erste Schritte mit MediaTailor.

Schritt 1: Erstellen einer -Funktion

In diesem Schritt erstellen Sie eine Funktion, die den Gerätetyp des Viewers anhand der User-Agent-Zeichenfolge klassifiziert und das Ergebnis in Player-Parametern speichert. Die Funktion verwendet einen benutzerdefinierten Ausgabetyp (keine externen API-Aufrufe) mit einem JSONataReferenz für Ausdrücke Ausdruck, um den Benutzeragenten auszuwerten.

Eine Erfolgsmeldung bestätigt, dass die Funktion erstellt wurde, und Sie werden zur Seite mit den Funktionsdetails weitergeleitet.

Die resultierende Funktionskonfiguration lautet:

{
    "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' %}"
        }
    }
}

Schritt 2: Hängen Sie die Funktion an eine Wiedergabekonfiguration an

Ordnen Sie die Funktion einem Lifecycle-Hook in Ihrer Wiedergabekonfiguration zu. Das Mapping gibt an MediaTailor , wann die Funktion ausgeführt werden muss.

Dies hängt mit dem myFirstFunction Lifecycle-Hook zusammenPre-session Initialisierung. Die resultierende Funktionszuordnung lautet:

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

MediaTailor führt die Funktion einmal zu Beginn jeder neuen Sitzung in dieser Wiedergabekonfiguration aus.

Schritt 3: Starten Sie eine Sitzung und überprüfen Sie, ob die Funktion ausgeführt wurde

Starten Sie eine neue Wiedergabesitzung, um die Funktion auszulösen. Senden Sie eine Anfrage zur Sitzungsinitialisierung an den Endpunkt der Sitzungsinitialisierung Ihrer Wiedergabekonfiguration.

MediaTailor veröffentlicht automatisch CloudWatch Metriken für jede Funktionsausführung — kein Opt-In erforderlich. Überprüfen Sie nach dem Start einer Sitzung die folgenden Metriken im AWS/MediaTailor Namespace, um zu bestätigen, dass Ihre Funktion ausgeführt wurde:

Wenn die Funktion fehlschlägt, MediaTailor werden standardmäßig Fehlerprotokollereignisse an die Manifest Logs ausgegeben (keine Konfiguration erforderlich):

Das folgende Beispiel zeigt ein PRE_SESSION_INIT_FUNCTION_ERROR Ereignis für einen Syntaxfehler im Funktionsausdruck:

{
    "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": {}
}

Verwenden Sie das eventId Feld, um Hook- und Funktionsfehlerereignisse für dieselbe Ausführung zu korrelieren. Das errorType Feld gibt die Fehlerklasse an. Eine vollständige Liste der Fehlertypen und Korrekturen finden Problembehandlung und Überwachung Sie unter.

Was passiert hinter den Kulissen

Hier ist der komplette Anforderungsablauf für die Funktion, die Sie gerade erstellt haben:

Wenn die Funktion aus irgendeinem Grund fehlschlägt, wird die Ausgabe MediaTailor verworfen und es wird so verfahren, als ob keine Funktion angehängt wäre. Der Zuschauer sieht immer noch Werbung — nur ohne Ausrichtung auf den Gerätetyp.

Vorgeschlagene Themen

Sie haben jetzt eine funktionierende Funktion, die an eine Wiedergabekonfiguration angehängt ist. Von hier aus: