Verwendung dynamischer Anzeigenvariablen in AWS Elemental MediaTailor

Die AWS Elemental MediaTailor-Anforderung an den Ad Decision Server (Entscheidungsserver für Werbung, ADS) enthält Informationen über die aktuelle Sitzung des Betrachters. Dadurch kann der ADS die beste Auswahl für die in seiner Antwort bereitzustellende Werbung treffen. Wenn Sie die ADS-Vorlage in Ihrer MediaTailor Konfiguration konfigurieren, können Sie dynamische Variablen, auch Makros genannt, einbeziehen. Dynamische Variablen sind austauschbare Zeichenketten.

Dynamische Variablen können die folgenden Formen annehmen:

• Statische Werte — Werte, die sich von einer Sitzung zur nächsten nicht ändern. Beispiel: Der Antworttyp, den MediaTailor von ADS erwartet.

• Domain-Variablen — Dynamische Variablen, die für URL-Domains verwendet werden können, wie z. B. der my-ads-server.com-Teil der URL http://my-ads-server.com. Details hierzu finden Sie unter Verwenden von Domänenvariablen.

• Sitzungsdaten — Dynamische Werte, die von MediaTailor für jede Sitzung bereitgestellt werden, z. B. die Sitzungs-ID. Details hierzu finden Sie unter Verwenden von Sitzungsvariablen.

• Spielerdaten — Dynamische Werte, die vom Spieler für jede Sitzung bereitgestellt werden. Diese beschreiben den Inhaltsbetrachter und helfen dem ADS dabei, zu bestimmen, welche Anzeigen in den Stream eingefügt werden MediaTailor sollen. Details hierzu finden Sie unter Verwendung von Spielervariablen.

Weitere Informationen zur Verwendung dynamischer Domain-, Sitzungs- und Player-Variablen finden Sie unter dem entsprechenden Thema.

Themen

• Parameter an das ADS übergeben
• Fortgeschrittene Nutzung
• Verwenden von Domänenvariablen
• Verwenden von Sitzungsvariablen
• Verwendung von Spielervariablen

Parameter an das ADS übergeben

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

1. Bestimmen Sie mithilfe des ADS, welche Informationen er benötigt, um auf eine Werbe-Abfrage von AWS Elemental MediaTailor antworten zu können.

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, ersetzt AWS Elemental MediaTailor die Variablen in der ADS-Anforderungsvorlagen-URL durch die Sitzungsdaten und die ads-Parameter des Players. Die verbleibenden Parameter werden vom Player an den Ursprungs-Server übergeben.

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

In den folgenden Abschnitten finden Sie Details für das Konfigurieren von Sitzungs- und Player-Daten.

Fortgeschrittene Nutzung

Sie können die ADS-Anforderung in vielerlei Hinsicht mit Player- und Sitzungsdaten anpassen. Die einzige Voraussetzung ist der Einschluss des ADS-Hostnamens.

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]