Erste Schritte mit der MediaTailor Anzeigeneinfügung - AWS Elemental MediaTailor

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.

Erste Schritte mit der MediaTailor Anzeigeneinfügung

Für die Verwendung benötigen Sie die Berechtigungen AWS-Konto und AWS Elemental MediaTailor, um auf MediaTailor Konfigurationen zuzugreifen, sie anzusehen und zu bearbeiten. Weitere Informationen hierzu finden Sie unter Einrichten AWS Elemental MediaTailor.

Im Tutorial "Erste Schritte" erfahren Sie, wie Sie die folgenden Aufgaben ausführen:

  • Bereiten Sie Ihre HLS oder Ihre DASH Inhaltsstreams vor

  • Konfigurieren Sie eine Vorlage für einen Anzeigenentscheidungsserver (ADS) URL

  • Erstellen Sie eine MediaTailor Konfiguration, die einen Wiedergabeendpunkt enthält

  • Verwenden Sie Ihren Player oder Ihr Content Delivery Network (CDN), um eine Wiedergabeanforderung zu stellen MediaTailor

Wenn Sie fertig sind, können Sie eine Wiedergabeanfrage MediaTailor für personalisierte Werbeinhalte in Ihrem Stream senden.

Voraussetzungen

Bevor Sie beginnen, sollten Sie sicherstellen, dass Sie die in Einrichten AWS Elemental MediaTailor beschriebenen Schritte ausgeführt haben.

Schritt 1: Zugriff AWS Elemental MediaTailor

Melden Sie sich mit Ihren IAM Anmeldeinformationen unter an der MediaTailor Konsole anhttps://console.aws.amazon.com/mediatailor/home.

Schritt 2: Bereiten Sie einen Stream vor

Konfigurieren Sie Ihren Ursprungsserver so, dass er Manifeste für HLS oderDASH, die kompatibel mit sind, erstellt AWS Elemental MediaTailor.

Bereite einen HLS Stream vor

HLSManifeste müssen die folgenden Anforderungen erfüllen:

  • Manifeste müssen über das öffentliche Internet zugänglich sein.

  • Manifeste müssen live oder als Video auf Abruf verfügbar sein (VOD).

  • Manifeste müssen einen EXT-X-VERSION von 3 oder höher haben.

  • Für Live-Inhalte müssen Manifeste Marker zur Abgrenzung von Ad-Avails enthalten. Dies ist optional für VOD Inhalte, für die stattdessen VMAP Timeoffsets verwendet werden können.

    In der Manifestdatei müssen sich Werbeplätze mit den folgenden Markern befinden:

    • # EXT -X- CUE -OUT/# EXT -X- CUE -IN (üblicher) mit Dauern, wie im folgenden Beispiel gezeigt.

      #EXT-X-CUE-OUT:60.00 #EXT-X-CUE-IN
    • # EXT -X- DATERANGE (seltener) mit Dauern wie im folgenden Beispiel gezeigt.

      #EXT-X-DATERANGE:ID="",START-DATE="",DURATION=30.000,SCTE35-OUT=0xF #EXT-X-DATERANGE:ID="",START-DATE="",DURATION=30.000,SCTE35-OUT=0xF

      Alle für #EXT-X-DATERANGE angezeigten Felder sind erforderlich.

    Von der Art und Weise, wie Sie die Werbe-Marker im Manifest konfigurieren, ist abhängig, ob Werbung in einen Stream eingefügt wird oder ob andere Fragmente im Stream durch sie ersetzt werden. Weitere Informationen finden Sie unter Das Verhalten bei der MediaTailor Anzeigeneinblendung verstehen.

  • HLSMaster-Manifeste müssen der unter HTTPLive-Streaming dokumentierten HLS Spezifikation entsprechen: Master-Playlist-Tags. Insbesondere muss #EXT-X-STREAM-INF die Felder RESOLUTION, BANDWIDTH und CODEC enthalten.

Nachdem Sie den Stream konfiguriert haben, notieren Sie sich das URL Quellpräfix für den Inhalt für das Master-Manifest. Sie benötigen es zum Erstellen der Konfiguration in AWS Elemental MediaTailor an späterer Stelle in diesem Tutorial.

Bereiten Sie einen DASH Stream vor

DASHManifeste müssen die folgenden Anforderungen erfüllen:

  • Manifeste müssen über das öffentliche Internet zugänglich sein.

  • Manifeste müssen live oder als Video auf Abruf verfügbar sein (VOD).

  • Manifeste müssen Ereignisse als Ad-Avails markieren und dazu entweder Splice-Insert-Marker oder Zeitsignal-Marker verwenden. Sie können die Anzeigenmarkierungen im Klartext XML oder in einer Base64-codierten Binärdatei angeben. Für das Einfügen von Spleißverbindungen muss der out-of-network Indikator aktiviert sein. Bei Zeitsignal-Markierungen muss es sich bei der ID des Segmentierungstyps, die sich innerhalb der Segmentierung befindet, um einen Cue-Out-Wert handelnUPID, der von erkannt wird. AWS Elemental MediaTailor Der Ad-Avail beginnt am Anfang des Ereignisses und dauert über die Ereignisdauer an, sofern angegeben, oder bis das nächste Ereignis beginnt.

    Das folgende Beispiel zeigt ein Ereignis, das mittels Splice-Insert-Marker als Ad-Avail gekennzeichnet ist. Die Dauer dieses Ad-Avail entspricht der Ereignisdauer.

    <Period start="PT444806.040S" id="123586" duration="PT15.000S"> <EventStream timescale="90000" schemeIdUri="urn:scte:scte35:2013:xml"> <Event duration="1350000"> <scte35:SpliceInfoSection protocolVersion="0" ptsAdjustment="180832" tier="4095"> <scte35:SpliceInsert spliceEventId="4026531855" spliceEventCancelIndicator="false" outOfNetworkIndicator="true" spliceImmediateFlag="false" uniqueProgramId="1" availNum="1" availsExpected="1"> <scte35:Program><scte35:SpliceTime ptsTime="5672624400"/></scte35:Program> <scte35:BreakDuration autoReturn="true" duration="1350000"/> </scte35:SpliceInsert> </scte35:SpliceInfoSection> </Event> </EventStream> <AdaptationSet mimeType="video/mp4" ... </AdaptationSet> </Period>
  • Ad-Avails müssen die gleichen AdaptationSet- und Representation-Einstellungen wie die Streams der Inhalte besitzen. AWS Elemental MediaTailor verwendet diese Einstellungen zur Transcodierung der Werbung entsprechend dem Stream der Inhalte, um einen reibungslosen Wechsel zwischen ihnen zu ermöglichen.

Nachdem Sie den Stream konfiguriert haben, notieren Sie sich das URL Inhaltsursprungspräfix für das Manifest. DASH Sie benötigen es, um die Konfiguration später in AWS Elemental MediaTailor diesem Tutorial zu erstellen.

Schritt 3: Konfigurieren Sie die ADS Anfrage URL - und Abfrageparameter

Um die erforderlichen Abfrageparameter zu ermittelnADS, generieren Sie ein Anzeigen-Tag URL aus demADS. Dies URL dient als Vorlage für Anfragen an die ADS und besteht aus den folgenden Komponenten:

  • Statische Werte

  • Werte, die von AWS Elemental MediaTailor (bezeichnet durch session oder avail Abfrageparameter) generiert wurden

  • Von Playern generierte Werte, die von der Client-Anwendung abgerufen wurden (gekennzeichnet durch player_params.-Abfrageparameter)

Beispiel Tag URL von einem hinzufügen ADS
https://my.ads.com/ad?output=vast&content_id=12345678&playerSession=[session.id]&cust_params=[player_params.cust_params]

Wobei gilt:

  • output und content_id sind statische Werte

  • playerSession= [session.id] ist ein dynamischer Wert, der von bereitgestellt wird. AWS Elemental MediaTailor Der Wert von [session.id] ändert sich für jede Spielersitzung und führt zu einem anderen Wert für die Anfrage URL für jede Sitzung. VAST

  • cust_params sind vom Player bereitgestellte dynamische Werte

Die Master-Manifest-Anfrage des Players muss Schlüssel-Wert-Paare enthalten, die den player_params. Abfrageparametern in der Anfrage entsprechen. ADS URL Weitere Informationen über das Konfigurieren von Schlüssel-Wert-Paaren in der Anforderung an AWS Elemental MediaTailor finden Sie unter Verwendung dynamischer Anzeigenvariablen in AWS Elemental MediaTailor.

Geben Sie die konfigurierte „Vorlage“ einURL, wenn Sie das ADS Ursprungsserver/-Mapping in, in MediaTailor erstellen. Schritt 4: Erstellen einer Konfiguration

Testen

Sie können eine statische VAST Antwort von Ihrem zu ADS Testzwecken verwenden. Im Idealfall gibt die VAST Antwort eine MP4 Wiedergabe in Mezzanine-Qualität zurück, die transkodiert werden kann. AWS Elemental MediaTailor Wenn die Antwort von mehrere Wiedergabeversionen ADS enthält, MediaTailor wählt die Wiedergabeversion mit der höchsten Qualität und Auflösung MP4 aus und sendet sie an den Transcoder.

Schritt 4: Erstellen einer Konfiguration

Die AWS Elemental MediaTailor Konfiguration enthält Zuordnungsinformationen für den Ursprungsserver und. ADS

So erstellen Sie eine Konfiguration (Konsole)
  1. Öffnen Sie die MediaTailor Konsole unter https://console.aws.amazon.com/mediatailor/.

  2. Wählen Sie auf der Seite Configurations (Konfigurationen) die Option Create configuration (Konfiguration erstellen).

  3. Geben Sie im Bereich Configuration (Konfiguration) unten auf der Seite für Configuration name (Konfigurationsname) einen eindeutigen Namen zur Beschreibung der Konfiguration ein. Der Name ist der primäre Kennung für die Konfiguration. Die maximale zulässige Länge beträgt 512 Zeichen.

  4. Geben Sie unter Videoinhaltsquelle das URL Präfix für das HLS Master-Manifest oder das DASH Manifest für diesen Stream ein, abzüglich der Asset-ID. Wenn das Master-Manifest beispielsweise URL lautethttp://origin-server.com/a/master.m3u8, würden Sie Folgendes eingebenhttp://origin-server.com/a/. Alternativ können Sie ein kürzeres Präfix, wie z. B. http://origin-server.com, eingeben, Sie müssen dann aber /a/ in die Komponenten-ID der Player-Anforderung für Inhalte einschließen. Die maximale Länge beträgt 512 Zeichen.

    Anmerkung

    Wenn Ihr Content Origin verwendetHTTPS, muss das zugehörige Zertifikat von einer bekannten Zertifizierungsstelle stammen. (Es darf kein selbstsigniertes Zertifikat sein.) Andernfalls kann AWS Elemental MediaTailor keine Verbindung zum Inhaltsursprung hergestellt werden und es können keine Manifeste als Antwort auf Spieleranfragen bereitgestellt werden.

  5. Geben Sie für Ad Decision Server den URL für Ihren einADS. Dabei handelt es sich entweder um die Variablen URL with, wie unter beschriebenSchritt 3: Konfigurieren Sie die ADS Anfrage URL - und Abfrageparameter, oder um VAST URL die statische Variablen, die Sie zu Testzwecken verwenden. Die maximale Länge beträgt 25.000 Zeichen.

    Anmerkung

    Wenn Sie ADS das Zertifikat verwendenHTTPS, muss es von einer bekannten Zertifizierungsstelle stammen. (Es darf kein selbstsigniertes Zertifikat sein.) Das Gleiche gilt für die von ihnen URLs zurückgegebenen Anzeigen im Zwischengeschoss. ADS Andernfalls MediaTailor schlägt es fehl, Anzeigen vom Ursprung des Inhalts abzurufen und in die Manifeste einzufügen.

  6. (Optional, je nach Bedarf fürDASH) Wählen Sie unter Standort, DISABLEDob Sie CDN Routing-Regeln für den Zugriff auf MediaTailor Manifeste eingerichtet haben und entweder clientseitige Berichte verwenden oder Ihre Player Sticky-Weiterleitungen unterstützen. HTTP

    Weitere Informationen über die Funktion Location (Speicherort) finden Sie unter DASHStandort-Funktion.

  7. (Optional) Wenn Ihr Ursprungsserver DASH Manifeste mit einer Periode erstellt, wählen Sie den Herkunftstyp „DASHmpd manifest“ und dann „_“. SINGLE PERIOD MediaTailor Behandelt DASH Manifeste standardmäßig als Manifeste mit mehreren Perioden. Weitere Informationen finden Sie unter Integration einer MPEG DASH -Quelle.

  8. Wählen Sie Create configuration (Konfiguration erstellen).

    AWS Elemental MediaTailor zeigt die neue Konfiguration auf der Konfigurationsseite an.

Schritt 5: Testen Sie die Konfiguration

Nachdem Sie die Konfiguration gespeichert haben, testen Sie den Stream mit einem URL im entsprechenden Format für Ihr Streaming-Protokoll:

  • Beispiel: HLS

    playback-endpoint/v1/master/hashed-account-id/origin-id/master.m3u8
  • Beispiel: DASH

    playback-endpoint/v1/dash/hashed-account-id/origin-id/manifest.mpd

Wobei gilt:

  • playback-endpoint ist der eindeutige Wiedergabe-Endpunkt, den AWS Elemental MediaTailor beim Erstellen der Konfiguration generiert hat.

    Beispiel

    https://bdaaeb4bd9114c088964e4063f849065.mediatailor.us-east-1.amazonaws.com
  • hashed-account-idist deine AWS-Konto ID.

    Beispiel

    AKIAIOSFODNN7EXAMPLE
  • origin-id ist der Name, den Sie beim Erstellen der Konfiguration gewählt haben.

    Beispiel

    myOrigin
  • master.m3u8 oder manifest.mpd ist der Name des Manifests aus dem Test-Stream samt seiner Dateierweiterung. Definieren Sie diese so, dass Sie ein vollständig identifiziertes Manifest erhalten, wenn Sie diese an die Quelle der Videoinhalte anhängen, die Sie unter Schritt 4: Erstellen einer Konfiguration konfiguriert haben.

Unter Verwendung der Werte aus den vorangegangenen Beispielen ergeben sich die vollständigen URLs Werte wie folgt.

  • Beispiel: HLS

    https://bdaaeb4bd9114c088964e4063f849065.mediatailor.us-east-1.amazonaws.com/v1/master/AKIAIOSFODNN7EXAMPLE/myOrigin/master.m3u8
  • Beispiel: DASH

    https://bdaaeb4bd9114c088964e4063f849065.mediatailor.us-east-1.amazonaws.com/v1/dash/AKIAIOSFODNN7EXAMPLE/myOrigin/manifest.mpd

Sie können den Stream mit einer der folgenden Methoden testen.

  • Geben Sie, wie im vorherigen Beispiel gezeigt, den URL in einem eigenständigen Player ein.

  • Testen Sie den Stream in Ihrer eigenen Player-Umgebung.

Schritt 6: Senden Sie die Wiedergabeanforderung an AWS Elemental MediaTailor

Konfigurieren Sie den Downstream-Player oder CDN senden Sie Wiedergabeanfragen an den von der Konfiguration bereitgestellten Wiedergabeendpunkt AWS Elemental MediaTailor. Alle vom Spieler definierten dynamischen Variablen, die Sie in der ADS Anfrage verwendet haben, Schritt 3: Konfigurieren Sie die ADS Anfrage URL - und Abfrageparameter müssen URL in der Manifestanforderung des Players definiert werden.

Beispiel

Gehen Sie davon aus, dass Ihre Vorlage die ADS URL folgende ist.

https://my.ads.com/ad?output=vast&content_id=12345678&playerSession=[session.id]&cust_params=[player_params.cust_params]

Definieren Sie dann [player_params.cust_params] in der Player-Anfrage, indem Sie dem Schlüssel-Wert-Paar das Präfix voranstellen. ads. AWS Elemental MediaTailor übergibt Parameter, denen kein Präfix vorangestellt istads., an den Ursprungsserver anstelle von. ADS

Bei der Spieleranfrage URL handelt es sich um eine Variante der folgenden HLS und DASH Beispiele.

https://bdaaeb4bd9114c088964e4063f849065.mediatailor.us-east-1.amazonaws.com/v1/master/AKIAIOSFODNN7EXAMPLE/myOrigin/master.m3u8?ads.cust_params=viewerinfo
https://bdaaeb4bd9114c088964e4063f849065.mediatailor.us-east-1.amazonaws.com/v1/dash/AKIAIOSFODNN7EXAMPLE/myOrigin/manifest.mpd?ads.cust_params=viewerinfo

Wenn AWS Elemental MediaTailor die Spieleranfrage eingeht, werden die Spielervariablen auf der Grundlage der Informationen in der Anfrage definiert. Die daraus resultierende ADS Anfrage URL ist eine Variante davon.

https://my.ads.com/ad?output=vast&content_id=12345678&playerSession=<filled_in_session_id>&cust_params=viewerinfo

Weitere Hinweise zur Konfiguration von Schlüssel-Wert-Paaren, die an die übergeben werdenADS, finden Sie unter. Verwendung dynamischer Anzeigenvariablen in AWS Elemental MediaTailor

Schritt 7 (optional): Aktivität überwachen AWS Elemental MediaTailor

Verwenden Sie Amazon CloudWatch und Amazon CloudWatch Logs, um AWS Elemental MediaTailor Aktivitäten nachzuverfolgen, z. B. die Anzahl der Anfragen, Fehler und ausgefüllten Werbeanzeigen.

Wenn Sie with zum ersten Mal verwenden CloudWatch AWS Elemental MediaTailor, erstellen Sie eine AWS Identity and Access Management (IAM) -Rolle, um die Kommunikation zwischen den Diensten zu ermöglichen.

Um den AWS Elemental MediaTailor Zugriff auf CloudWatch (Konsole) zu ermöglichen
  1. Öffnen Sie die IAM Konsole unter https://console.aws.amazon.com/iam/.

  2. Wählen Sie im Navigationsbereich der IAM Konsole Rollen und anschließend Rolle erstellen aus.

  3. Wählen Sie den AWS-Konto Rollentyp „Anderer“.

  4. Geben Sie als Konto-ID Ihre AWS-Konto ID ein.

  5. Wählen Sie Require external ID (Externe ID fordern) und geben Sie midas ein. Mit dieser Option wird automatisch eine Bedingung zur Vertrauensrichtlinie hinzugefügt, die es dem Service nur dann ermöglicht, die Rolle anzunehmen, wenn in der Anforderung die richtige sts:ExternalID enthalten ist.

  6. Wählen Sie Weiter: Berechtigungen aus.

  7. Fügen Sie eine Berechtigungsrichtlinie hinzu, in der die Aktionen angegeben werden, die von dieser Rolle ausgeführt werden dürfen. Wählen Sie eine der folgenden Optionen aus und wählen Sie dann Next: Review (Nächster Schritt: Prüfen):

    • CloudWatchLogsFullAccessum vollen Zugriff auf Amazon CloudWatch Logs zu gewähren

    • CloudWatchFullAccessum vollen Zugriff auf Amazon zu gewähren CloudWatch

  8. Geben Sie für Role name (Rollenname) den Namen MediaTailorLogger ein und klicken Sie auf Create role (Rolle erstellen).

  9. Wählen Sie auf der Seite Roles (Rollen) die von Ihnen soeben erstellte Rolle aus.

  10. Bearbeiten Sie die Vertrauensstellung, um den Prinzipal zu aktualisieren:

    1. Wählen Sie auf der Seite Summary (Übersicht) der Rolle die Registerkarte Trust relationship (Vertrauensstellung) aus.

    2. Wählen Sie Vertrauensstellung bearbeiten aus.

    3. Ändern Sie im Richtliniendokument den Prinzipal auf den AWS Elemental MediaTailor -Service. Sie sollte wie folgt aussehen.

      "Principal": { "Service": "mediatailor.amazonaws.com" },

      Die gesamte Richtlinie sollte folgendermaßen lauten.

      { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "mediatailor.amazonaws.com" }, "Action": "sts:AssumeRole", "Condition": { "StringEquals": { "sts:ExternalId": "Midas" } } } ] }
    4. Wählen Sie Update Trust Policy (Trust Policy aktualisieren).

Schritt 8: Bereinigen

Um unerwünschte Gebühren zu vermeiden, löschen Sie alle unnötigen Konfigurationen.

So löschen Sie eine Konfiguration (Konsole)
  1. Führen Sie auf der Seite „ AWS Elemental MediaTailor Konfigurationen“ einen der folgenden Schritte aus:

    • Wählen Sie für die Konfiguration, die Sie löschen möchten, einen Namen für Configuration name (Konfigurationsname) aus.

    • Aktivieren Sie in der Spalte Configuration name (Konfigurationsname) das Optionsfeld neben dem Namen und wählen Sie dann Delete (Löschen).

  2. Geben Sie im Bestätigungsdialogfeld Delete configuration (Konfiguration löschen) den Text Delete ein und wählen Sie erneut Delete (Löschen) aus.

    AWS Elemental MediaTailor entfernt die Konfiguration.