Verwendung von Spielervariablen

Um zu konfigurieren AWS Elemental MediaTailor um vom Player empfangene Daten an die ADS in der Vorlage ADS URL angegebenen player_params.<query_parameter_name> Variablen zu senden. Wenn der Player beispielsweise einen user_id in seiner Anfrage genannten Abfrageparameter an sendet MediaTailor, um diese Daten in der ADS Anfrage zu übergeben, [player_params.user_id] in die ADS URL Konfiguration aufnehmen.

Auf diese Weise können Sie die Abfrageparameter steuern, die in der ADS Anfrage enthalten sind. In der Regel fügen Sie der ADS Anforderung einen speziellen Abfrageparameter hinzu, den er ADS erkennt, URL 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. In AWS Elemental MediaTailor, konfigurieren Sie die ADS Anforderungsvorlage soURL, dass sie auf die Parameter verweist. Im Folgenden URL wird die Aufnahme der Beispielparameter veranschaulicht:

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

2. (Optional) Für serverseitige Ad-Tracking-Berichte kodieren Sie die URL Schlüssel-Wert-Paare auf dem Player mit -kodieren. Wenn MediaTailor er die Anfrage zur Sitzungsinitialisierung erhält, URL dekodiert er die Werte einmal, bevor sie in die Anfrage eingefügt werden. ADS URL

   Anmerkung

   Wenn Sie einen URL -codierten Wert ADS benötigen, URL kodieren Sie den Wert zweimal auf dem Player. Auf diese Weise MediaTailor ergibt die Dekodierung von einen einmal codierten Wert für. ADS

   Wenn zum Beispiel die dekodierte Darstellung der an den gesendeten Werte ADS istparam1=value1:&param2=value2:, dann ist es die -kodierte Darstellung. URL param1=value1%3A&param2=value2%3A

3. Übergeben Sie im Sitzungsinitialisierungsaufruf des Players 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 -codierten Paaren URL

     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 Ad-Tracking-Berichte — ohne -Kodierung URL

     HLS:

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

     DASH:

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

Für serverseitige Berichte werden die Parameter MediaTailor dekodiert, wenn die Player-Anfrage empfangen wird. Bei der clientseitigen Berichterstattung werden die in der Payload empfangenen Parameter nicht geändert. JSON MediaTailor sendet die folgende Anfrage an: ADS

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

Auf diese Weise werden die param1 param2 Schlüssel-Wert-Paare als erstklassige Abfrageparameter in die ADS Anfrage aufgenommen.