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 DASH-Inhaltsstreams vor

• Konfigurieren Sie eine ADS-Vorlagen-URL (Ad Decision Server)

• 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 an MediaTailor

Wenn du fertig bist, kannst du eine Wiedergabeanfrage MediaTailor für personalisierte Werbeinhalte in deinem 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 bei der MediaTailor Konsole an unterhttps://console.aws.amazon.com/mediatailor/home.

Schritt 2: Bereiten Sie einen Stream vor

Konfigurieren Sie Ihren Ursprungs-Server so, dass mit ihm Manifeste für HLS oder DASH erstellt werden, die mit AWS Elemental MediaTailor kompatibel sind.

Bereiten Sie einen HLS-Stream vor

HLS-Manifeste müssen die folgenden Anforderungen erfüllen:

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

• Die Manifeste müssen live oder Video-on-Demand (VOD) sein.

• 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 für On-Demand-Inhalte optional, bei denen 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 (gebräuchlicher) mit Angaben zur Dauer wie im folgenden Beispiel dargestellt.

    #EXT-X-CUE-OUT:60.00
    #EXT-X-CUE-IN

  • #EXT-X-DATERANGE (weniger gebräuchlicher) mit Angaben zur Dauer wie im folgenden Beispiel dargestellt.

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

• HLS-Mastermanifeste müssen der HLS-Spezifikation entsprechen, die unter HTTP-Live-Streaming: Master-Playlist-Tags dokumentiert ist. Insbesondere muss #EXT-X-STREAM-INF die Felder RESOLUTION, BANDWIDTH und CODEC enthalten.

Nachdem Sie den Stream konfiguriert haben, beachten Sie das Präfix der Ursprungs-URL von Inhalten 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

DASH-Manifeste müssen die folgenden Anforderungen erfüllen:

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

• Die Manifeste müssen live oder Video-on-Demand (VOD) sein.

• Manifeste müssen Ereignisse als Ad-Avails markieren und dazu entweder Splice-Insert-Marker oder Zeitsignal-Marker verwenden. Sie können die Werbemarker im transparenten XML- oder im base64-kodierten binären Format 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 Segmentierungstyp-ID, die sich innerhalb der Segmentierungs-UPID befindet, um einen Cue-Out-Wert handeln, 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, beachten Sie das Präfix der Ursprungs-URL von Inhalten für das DASH-Manifest. Sie benötigen sie, um die Konfiguration später in AWS Elemental MediaTailor diesem Tutorial zu erstellen.

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

Um zu bestimmen, welche Abfrageparameter der ADS benötigt, erstellen Sie eine Werbe-Tag-URL vom ADS. Diese URL fungiert als Vorlage für Anforderungen an den ADS und enthält Folgendes:

• Statische Werte

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

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

Beispiel Werbe-Tag-URL von einem 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 mit jeder Player-Sitzung und ergibt eine jeweils andere URL für die VAST-Anforderung für jede Sitzung.

• cust_params sind vom Player bereitgestellte dynamische Werte

Die Master-Manifest-Anforderung von dem Player muss Schlüssel-Wert-Paare bereitstellen, die den player_params.-Abfrageparametern in der ADS-Anforderungs-URL entsprechen. 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“ -URL ein, wenn Sie die Zuordnung zwischen dem Ursprungsserver und dem ADS-Server in, in erstellen. MediaTailor Schritt 4: Erstellen einer Konfiguration

Testen

Sie können eine statische VAST-Antwort von Ihrem ADS für Testzwecke verwenden. Idealerweise gibt die VAST-Antwort eine MP4-Wiedergabe in Mezzanine-Qualität zurück, die AWS Elemental MediaTailor transcodieren kann. Wenn die Antwort des ADS mehrere Wiedergabeversionen enthält, MediaTailor wählt es die MP4-Wiedergabeversion mit der höchsten Qualität und Auflösung 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 für Video content source (Quelle der Videoinhalte) das URL-Präfix für das HLS-Master-Manifest oder DASH-Manifest für diesen Stream abzüglich der Komponenten-ID ein. Beispiel: Bei der Master-Manifest-URL http://origin-server.com/a/master.m3u8 würden Sie http://origin-server.com/a/ eingeben. 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 der Ursprungs-Server Ihrer Inhalte HTTPS verwendet, muss sein Zertifikat von einer bekannten Zertifizierungsstelle stammen. (Es darf kein selbstsigniertes Zertifikat sein.) Andernfalls kann AWS Elemental MediaTailor keine Verbindung zum Ursprung des Inhalts hergestellt werden und es können keine Manifeste als Antwort auf Spieleranfragen bereitgestellt werden.

5. Geben Sie für Ad Decision Server die URL für Ihre ADS ein. Dies ist entweder die unter Schritt 3: Konfigurieren Sie die ADS-Anforderungs-URL und die Abfrageparameter beschriebene URL mit Variablen oder die statische VAST-URL, die Sie für Testzwecke verwenden. Die maximale Länge beträgt 25.000 Zeichen.

   Anmerkung

   Wenn der ADS HTTPS verwendet, muss sein Zertifikat von einer bekannten Zertifizierungsstelle stammen. (Es darf kein selbstsigniertes Zertifikat sein.) Das Gleiche gilt für Mezzanine-Werbe-URLs, die von dem ADS zurückgegeben werden. Andernfalls können Anzeigen MediaTailor nicht abgerufen und in die Manifeste vom Ursprung des Inhalts eingefügt werden.

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

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

7. (Optional) Wenn Ihr Ursprungs-Server DASH-Manifeste mit einzelnen Zeiträumen erstellt, wählen Sie DASH mpd manifest origin typ (DASH mpd-Manifest-Ursprungstyp) und danach SINGLE_PERIOD aus. 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 mithilfe einer 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 vorherigen Beispielen ergeben sich die folgenden vollständigen URLs.

• 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 dargestellt die 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 das CDN zum Senden von Wiedergabeanforderungen an den von AWS Elemental MediaTailor bereitgestellten Wiedergabe-Endpunkt der Konfiguration. Alle vom Player definierten dynamischen Variablen, die Sie in der ADS-Anforderungs-URL in Schritt 3: Konfigurieren Sie die ADS-Anforderungs-URL und die Abfrageparameter verwendet haben, müssen in der Manifest-Anforderung vom Player definiert sein.

Beispiel

Angenommen, Ihre Vorlagen-ADS-URL lautet wie folgt.

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 statt an das ADS.

Die Player-Anforderungs-URL ist 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 er die Spieleranfrage erhält, definiert er die Spielervariablen auf der Grundlage der Informationen in der Anfrage. Die resultierende ADS-Anforderungs-URL ist eine Variante hiervon.

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

Weitere Informationen über das Konfigurieren von Schlüssel-Wert-Paaren zur Übergabe an den ADS finden Sie unter Verwendung dynamischer Anzeigenvariablen in AWS Elemental MediaTailor.

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

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 Services 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. Klicken Sie im Navigationsbereich der IAM-Konsole auf Rollen, und wählen Sie dann Rolle erstellen.

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.