View a markdown version of this page

MediaTailor Player-Variablen für ADS-Anfragen - 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.

MediaTailor Player-Variablen für ADS-Anfragen

AWS Elemental MediaTailor sendet vom Player empfangene Daten an das ADS, wenn Sie die Konfiguration so konfigurieren, dass player_params.<query_parameter_name> Variablen in der AWS Elemental MediaTailor ADS-URL der Vorlage angegeben werden. Wenn der Player beispielsweise einen user_id in seiner Anfrage genannten Abfrageparameter an sendet MediaTailor, nehmen Sie zur Weitergabe dieser Daten in die ADS-URL-Konfiguration auf, um diese Daten [player_params.user_id] in der ADS-Anforderung zu übergeben.

Auf diese Weise können Sie kontrollieren, welche Abfrageparameter in die ADS-Anforderung eingeschlossen werden. In der Regel fügen Sie einen vom ADS erkannten speziellen Abfrageparameter zur ADS-Anforderungs-URL hinzu und geben Schlüssel-Wert-Paare als Wert des Parameters an.

Die Beispiele im folgenden Verfahren verwenden die folgenden Schlüssel-Wert-Paare:

  • param1 mit einem Wert von value1:

  • param2 mit einem Wert von value2:

So fügen Sie Abfrageparameter als Schlüssel-Wert-Paare hinzu

  1. Konfigurieren Sie unter AWS Elemental MediaTailor die URL der ADS-Anforderungsvorlage so, dass sie auf die Parameter verweist. Die folgende URL veranschaulicht den Einschluss der Beispielparameter: 

    https://my.ads.com/path?param1=[player_params.param1]&param2=[player_params.param2]

  2. (Optional) Für serverseitige Ad-Tracking-Berichte sind dies URL-encode die Schlüssel-Wert-Paare auf dem Player. Wenn die Anfrage MediaTailor zur Sitzungsinitialisierung eingeht, werden URL-decodes die Werte einmal eingegeben, bevor sie in die ADS-Anforderungs-URL eingefügt werden.

    Anmerkung

    Wenn Ihr ADS einen URL-encoded Wert benötigt, wird URL-encode der Wert zweimal auf dem Player angezeigt. Auf diese Weise MediaTailor führt die von vorgenommene Dekodierung zu einem einmal codierten Wert für das ADS.

    Wenn zum Beispiel die dekodierte Darstellung der an das ADS gesendeten Werte lautetparam1=value1:&param2=value2:, dann ist die Repräsentation. URL-encoded param1=value1%3A&param2=value2%3A

  3. Übergeben Sie beim Aufruf zur Sitzungsinitialisierung vom Player die Schlüssel-Wert-Paare MediaTailor als Wert eines einzelnen Abfrageparameters an. Die folgenden Beispielaufrufe stellen die Beispiel-Schlüssel-Wert-Paare für die server- und clientseitigen Werbenachverfolgungs-Berichte bereit.

    • Beispielanfragen für serverseitige Ad-Tracking-Berichte — unter Verwendung von Paaren URL-encoded

      HLS:

      <master>.m3u8?ads.param1=value1%3A&ads.param2=value2%3A

      DASH:

      <manifest>.mpd?ads.param1=value1%3A&ads.param2=value2%3A

    • Beispielanfrage für clientseitige Berichterstattung über Ad-Tracking — ohne URL-encoding

      HLS:

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

      DASH:

      POST <manifest>.mpd
    {
        "adsParams": {
           "param1": "value1:",
           "param2": "value2:"
       }
    }

MediaTailor Dekodiert bei serverseitiger Berichterstattung die Parameter, wenn die Player-Anfrage eingeht. Bei der clientseitigen Berichterstattung werden die in der JSON-Nutzlast empfangenen Parameter nicht geändert. MediaTailor sendet die folgende Anfrage an das ADS:

https://my.ads.com/<path>?param1=value1:&param2=value2:

Auf diese Weise werden die Schlüssel-Wert-Paare param1 und param2 als First-Class-Abfrageparameter in die ADS-Anforderung eingeschlossen.