View a markdown version of this page

Funktionen erstellen und verwalten - AWS Elemental MediaTailor
Eine Funktion einrichtenVerwalten von -FunktionenEine Funktion entfernenRegeln für die ValidierungAPI-Referenz

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.

Funktionen erstellen und verwalten

Auf dieser Seite erfahren Sie, wie Sie Funktionen mithilfe der Konsole erstellen, anhängen, aktualisieren und löschen. MediaTailor Mit Funktionen können Sie das Sitzungsverhalten und die Anzeigenanfragen anpassen, indem Sie während der Wiedergabe die Logik an wichtigen Stellen ausführen.

Eine Funktion einrichten

Eine Funktion mithilfe der Konsole erstellen

  1. Öffnen Sie die MediaTailor-Konsole.

  2. Wählen Sie im Navigationsbereich Funktionen aus.

  3. Wählen Sie Funktion erstellen.

  4. Geben Sie unter Funktions-ID einen eindeutigen Namen für die Funktion ein (z. B.fetchIdentity).

  5. Wählen Sie als Funktionstyp die Option CUSTOM_OUTPUTHTTP_REQUEST,VAST_REQUEST,SEQUENTIAL_EXECUTOR, oder ausCONCURRENT_EXECUTOR. Die Konsole zeigt die Konfigurationsfelder für den ausgewählten Typ an.

  6. Füllen Sie die typspezifischen Konfigurationsfelder aus. Eine Beschreibung der einzelnen Funktionstypen und ihrer Felder finden Sie unterFunktionstypen und Zusammensetzung.

  7. Wählen Sie Funktion erstellen.

Eine Funktion an eine Wiedergabekonfiguration anhängen

Eine Funktion wird erst ausgeführt, wenn Sie sie über ein Funktions-Mapping (eine Verknüpfung zwischen einem Lifecycle-Hook und einer Funktion) an eine Wiedergabekonfiguration anhängen. Die Funktionszuordnung gibt an, welcher Lifecycle-Hook die Funktion auslöst.

  1. Öffnen Sie die MediaTailor Konsole.

  2. Wählen Sie im Navigationsbereich Konfigurationen aus.

  3. Wählen Sie die Wiedergabekonfiguration, die Sie aktualisieren möchten.

  4. Wählen Sie im Abschnitt Funktionszuordnung die Option Bearbeiten aus.

  5. Wählen Sie für jeden Lifecycle-Hook die Funktion aus, die Sie anhängen möchten:

    • Sitzungsinitialisierungs-Hook — Wählen Sie eine Funktion aus, die beim Sitzungsstart einmal ausgeführt werden soll.

    • Anzeigenanforderungs-Hook — Wählen Sie eine Funktion aus, die vor jeder ADS-Anfrage ausgeführt werden soll.

    • Antwort-Hook für die Veröffentlichung von Werbeanzeigen — Wählen Sie eine Funktion aus, die ausgeführt werden soll, nachdem jede ADS-Antwort empfangen und analysiert wurde.

    • Hook zur Platzierung vor dem Manifest — Wählen Sie eine Funktion aus, die für das endgültige Anzeigenset ausgeführt werden soll, kurz bevor Anzeigen in das Manifest eingefügt werden.

  6. Wählen Sie Speichern.

Verwalten von -Funktionen

Funktionen anzeigen

Navigiere zu Funktionen, um alle Funktionen in deinem Konto zu sehen. Wählen Sie einen Funktionsnamen, um dessen Konfiguration anzuzeigen.

Aktualisierung einer vorhandenen Funktion

Um eine Funktion zu aktualisieren, navigieren Sie zu Funktionen, wählen Sie die Funktion aus und ändern Sie die Konfiguration. Das Update ersetzt die gesamte Funktionsdefinition.

Tipp

Speichern Sie eine Kopie Ihrer Funktionskonfiguration, bevor Sie Änderungen vornehmen. Es gibt keine integrierte Versionierung oder ein Rollback für Funktionen.

Eine Funktion entfernen

Trennen einer Funktion von einer Wiedergabekonfiguration

Bevor Sie eine Funktion löschen, entfernen Sie sie aus allen Wiedergabekonfigurationen, die auf sie verweisen.

  1. Öffnen Sie die MediaTailor Konsole.

  2. Wählen Sie im Navigationsbereich Konfigurationen aus.

  3. Wählen Sie die Wiedergabekonfiguration.

  4. Wählen Sie im Abschnitt Funktionszuordnung die Option Bearbeiten aus.

  5. Entfernen Sie die Funktion aus dem Lifecycle-Hook.

  6. Wählen Sie Speichern.

Löschen einer Funktion

Navigieren Sie zu Funktionen, wählen Sie die Funktion aus und wählen Sie Löschen.

Löschen und Blockieren von Regeln

MediaTailor verhindert, dass Sie eine Funktion löschen, die noch verwendet wird.

Bedingung Ergebnis
Die Funktion ist über eine Funktionszuordnung an eine Wiedergabekonfiguration angehängt Löschen ist gesperrt. Trennen Sie zuerst die Funktion.
Auf die Funktion wird in einem SEQUENTIAL_EXECUTOR oder verwiesen CONCURRENT_EXECUTOR Löschen ist gesperrt. Entfernen Sie zuerst die Referenz aus der übergeordneten Funktion.
Auf die Funktion wird nirgends verwiesen Das Löschen ist erfolgreich.

Regeln für die Validierung

MediaTailor validiert Ihre Funktion, wenn Sie sie erstellen oder aktualisieren. Die folgenden Prüfungen werden durchgeführt:

  • Ausdruckssyntax — Alle Ausdrücke müssen ein gültiges JSONATA-Format sein.

  • Eingeschränkte Funktionen — Ausdrücke können keine eingeschränkten JSONata-Funktionen aufrufen. Die vollständige JSONataReferenz für Ausdrücke Liste finden Sie unter.

  • Präfixe für Ausgabeschlüssel — Alle Ausgabeschlüssel müssen mit einem anerkannten Namespace-Präfix beginnen. Eine Liste der akzeptierten Präfixe finden Sie unter. Lebenszyklus-Hooks

  • Funktionsreferenzen — Alle Funktions-IDs in a FunctionList müssen auf vorhandene Funktionen verweisen.

  • Zirkelverweise — Eine Funktion kann weder direkt noch indirekt auf sich selbst verweisen.

  • Verschachtelungstiefe — A SEQUENTIAL_EXECUTOR kann andere Funktionen aufrufen, aber diese Funktionen selbst können nicht als Executoren fungieren.

Spezifische Werte und Größenbeschränkungen finden Sie unter. Einschränkungen

API-Referenz

Informationen zur programmgesteuerten Verwaltung von Funktionen finden Sie in der AWS Elemental MediaTailor API-Referenz.