MediaTailor Parameter an ADS übergeben - AWS Elemental MediaTailor
Fortgeschrittene Nutzung

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.

MediaTailor Parameter an ADS übergeben

AWS Elemental MediaTailor unterstützt die Einrichtung dynamischer Variablen in MediaTailor Anfragen an das ADS mithilfe der folgenden Schritte.

Methoden zur Sitzungsinitialisierung

MediaTailor unterstützt mehrere Methoden zur Sitzungsinitialisierung und Parameterübergabe:

  1. POST mit dem Hauptteil der Anfrage:

    POST <master>.m3u8
{
    "adsParams": {"param1": "value1", "param2": "value2"},
    "playerParams": {"param3": "value3"}
}

  2. Abfrageparameter in der URL:

    GET <master>.m3u8?ads.param1=value1&ads.param2=value2&playerParams.param3=value3
Wichtig

Sie können Parameter bei der Initialisierung nur einmal angeben. Konfigurationsaliase werden vor der Weiterleitung in tatsächliche Werte aufgelöst.

So übergeben Sie Sitzungs- und Player-Informationen an den ADS

  1. Ermitteln Sie gemeinsam mit dem ADS, welche Informationen benötigt werden, um auf eine Anzeigenanfrage von AWS Elemental MediaTailor zu antworten.

  2. Erstellen Sie eine Konfiguration MediaTailor , die eine ADS-Vorlagen-URL verwendet, die die ADS-Anforderungen erfüllt. Schließen Sie in die URL statische Parameter und Platzhalter für dynamische Parameter ein. Geben Sie Ihre Vorlagen-URL in das Feld Ad decision server (Entscheidungsserver für Werbung) ein.

    In der folgenden Beispielvorlagen-URL bietet correlation Sitzungsdaten und deviceType bietet Player-Daten: 

    https://my.ads.server.com/path?correlation=[session.id]&deviceType=[player_params.deviceType]

  3. Konfigurieren Sie auf dem Player die Sitzungsinitiierungs-Anforderung für AWS Elemental MediaTailor , um Parameter für die Player-Daten bereitzustellen. Sie brauchen die Parameter nur in die Sitzungsinitiierungs-Anforderung einzuschließen und können sie in nachfolgenden Anforderungen für die Sitzung weglassen.

    Die Art des Aufrufs, den der Player zur Initialisierung der Sitzung tätigt, bestimmt, ob der Player (Client) oder MediaTailor (Server) Werbeverfolgungsberichte für die Sitzung bereitstellt. Weitere Informationen zu diesen beiden Optionen finden Sie unter Daten zur Berichterstattung und Nachverfolgung .

    Führen Sie je nachdem, ob Sie an server- oder clientseitigen Werbenachverfolgungs-Berichten interessiert sind, den jeweiligen der folgenden Aufrufe durch. Bei beiden Beispielaufrufen ist userID für den ADS und auth_token für den Ursprungs-Server vorgesehen:

    • (Option) Aufruf für serverseitiges Ad-Tracking-Reporting — Stellen Sie den Parametern, die Sie an das ADS senden MediaTailor möchten, ein Präfix voran. ads Lassen Sie das Präfix bei Parametern weg, die MediaTailor an den Ursprungs-Server senden soll:

      Die folgenden Beispiele zeigen eingehende Anfragen für HLS und DASH an. AWS Elemental MediaTailor MediaTailor verwendet das deviceType in seiner Anfrage an das ADS und das auth_token in seiner Anfrage an den Ursprungsserver.

      HLS-Beispiel:

      GET master.m3u8?ads.deviceType=ipad&auth_token=kjhdsaf7gh

      DASH-Beispiel:

      GET manifest.mpd?ads.deviceType=ipad&auth_token=kjhdsaf7gh

    • (Option) Aufruf für clientseitiges Ad-Tracking-Reporting — Geben Sie Parameter für das ADS innerhalb eines Objekts an. adsParams

      HLS-Beispiel:

      POST master.m3u8
    {
        "adsParams": {
           "deviceType": "ipad"
       }
    }

      DASH-Beispiel:

      POST manifest.mpd
    {
        "adsParams": {
           "deviceType": "ipad"
       }
    }

Wenn der Player eine Sitzung initiiert, werden die Variablen in der ADS-Anforderungs-URL der Vorlage durch die Sitzungsdaten und die Parameter des Players AWS Elemental MediaTailor ersetzt. ads Die verbleibenden Parameter werden vom Player an den Ursprungs-Server übergeben.

Beispiel MediaTailor Anfragen mit Anzeigenvariablen

Die folgenden Beispiele zeigen die Aufrufe von AWS Elemental MediaTailor an den ADS und den Ursprungs-Server entsprechend den voranstehenden Beispielen für Sitzungsinitialisierungs-Aufrufe des Players:

  • MediaTailor ruft das ADS mit Sitzungsdaten und dem Gerätetyp des Players auf: 

    https://my.ads.server.com/path?correlation=896976764&deviceType=ipad

  • MediaTailor ruft den Ursprungsserver mit dem Autorisierungstoken des Spielers auf.

    • HLS-Beispiel:

      https://my.origin.server.com/master.m3u8?auth_token=kjhdsaf7gh

    • DASH-Beispiel:

      https://my.origin.server.com/manifest.mpd?auth_token=kjhdsaf7gh

Fortgeschrittene Nutzung

Sie können die ADS-Anforderung in vielerlei Hinsicht mit Player- und Sitzungsdaten anpassen. Sie müssen nur den ADS-Hostnamen angeben.

Die folgenden Beispiele zeigen einige der Möglichkeiten, wie Sie Ihre Anforderung anpassen können:

  • Erstellen Sie durch Verketten von Player-Parametern und Sitzungsparametern neue Parameter. Beispiel: 

    https://my.ads.com?key1=[player_params.value1][session.id]

  • Verwenden Sie einen Player-Parameter als Teil eines Pfadelements. Beispiel:

    https://my.ads.com/[player_params.path]?key=value

  • Verwenden Sie Player-Parameter, um nicht nur die Werte, sondern sowohl Pfadelemente als auch die Schlüssel selbst zu übergeben. Beispiel: 

    https://my.ads.com/[player_params.path]?[player_params.key1]=[player_params.value1]