Wählen Sie Ihre Cookie-Einstellungen aus

Wir verwenden essentielle Cookies und ähnliche Tools, die für die Bereitstellung unserer Website und Services erforderlich sind. Wir verwenden Performance-Cookies, um anonyme Statistiken zu sammeln, damit wir verstehen können, wie Kunden unsere Website nutzen, und Verbesserungen vornehmen können. Essentielle Cookies können nicht deaktiviert werden, aber Sie können auf „Anpassen“ oder „Ablehnen“ klicken, um Performance-Cookies abzulehnen.

Wenn Sie damit einverstanden sind, verwenden AWS und zugelassene Drittanbieter auch Cookies, um nützliche Features der Website bereitzustellen, Ihre Präferenzen zu speichern und relevante Inhalte, einschließlich relevanter Werbung, anzuzeigen. Um alle nicht notwendigen Cookies zu akzeptieren oder abzulehnen, klicken Sie auf „Akzeptieren“ oder „Ablehnen“. Um detailliertere Entscheidungen zu treffen, klicken Sie auf „Anpassen“.

Verwendung dynamischer Anzeigenvariablen in MediaTailor

Fokusmodus

Auf dieser Seite

Verwendung dynamischer Anzeigenvariablen in MediaTailor - 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.

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.

Die AWS Elemental MediaTailor Anfrage an den Anzeigenentscheidungsserver (ADS) enthält Informationen über die aktuelle Anzeigesitzung, anhand derer der Benutzer die besten Anzeigen ADS auswählen kann, die als Antwort angezeigt werden sollen. 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. Zum Beispiel der Antworttyp, der von der MediaTailor erwartet wirdADS.

  • Domänenvariablen — Dynamische Variablen, die für URL Domänen verwendet werden können, wie z. B. der my-ads-server.com-Teil von URL http://my-ads-server.com. Details hierzu finden Sie unter Verwendung 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 ihm dabeiADS, zu bestimmen, welche Anzeigen in den Stream eingefügt werden MediaTailor sollen. Details hierzu finden Sie unter Verwendung von Spielervariablen.

Übergabe von Parametern an ADS

In den folgenden Schritten wird beschrieben, wie dynamische Variablen in MediaTailor Anfragen an die eingerichtet ADS werden.

Um Sitzungs- und Spielerinformationen an das weiterzuleiten ADS
  1. Ermitteln ADS Sie gemeinsam mit dem, welche Informationen er benötigt, damit er auf eine Anzeigenanfrage von antworten kann AWS Elemental MediaTailor.

  2. Erstellen Sie eine Konfiguration MediaTailor , die eine ADS Vorlagenanforderung verwendetURL, die die ADS Anforderungen erfüllt. Fügen Sie in URL die statische Parameter und Platzhalter für dynamische Parameter ein. Geben Sie Ihre Vorlage URL in das Feld Ad Decision Server der Konfiguration ein.

    In der folgenden Beispielvorlage URL werden Sitzungsdaten und deviceType Spielerdaten bereitgestellt: correlation

    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. In beiden Beispielaufrufen userID ist für den ADS und auth_token für den Ursprung bestimmt:

    • (Option) Aufruf für serverseitiges Ad-Tracking-Reporting — Stellen Sie den Parametern, die Sie an die Datei senden MediaTailor möchten, ein Präfix voran. ADS 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 den ADS und das auth_token in seiner Anfrage an den Ursprungsserver.

      HLSBeispiel:

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

      DASHBeispiel:

      GET manifest.mpd?ads.deviceType=ipad&auth_token=kjhdsaf7gh
    • (Optional) Aufruf für clientseitiges Ad-Tracking-Reporting — Geben Sie Parameter für das ADS Innere eines Objekts an. adsParams

      HLSBeispiel:

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

      DASHBeispiel:

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

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

Beispiel MediaTailor Anfragen mit Anzeigenvariablen

Die folgenden Beispiele zeigen die Aufrufe an den ADS und den Ursprungsserver AWS Elemental MediaTailor , die den Beispielen für Aufrufe zur Sitzungsinitialisierung des vorherigen Players entsprechen:

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

    • HLSBeispiel:

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

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

Unterstützte Zeichen und Einschränkungen des Manifest-Abfrageparameters

Sie können die folgenden Zeichen in Abfrageparametern verwenden, die in Manifestanforderungen verwendet werden:

  • Alphanumerisch (A-Z, a-z, 0-9)

  • Perioden (.)

  • Bindestriche (-)

  • Unterstriche (_)

  • Schrägstriche (\)

Längenbeschränkungen

Die Gesamtlänge aller Manifest-Abfrageparameter (Schlüssel und Wert zusammen) darf 2000 Zeichen nicht überschreiten.

Nicht unterstützte Zeichen

Sie können die folgenden Zeichen nicht in Manifest-Abfrageparametern verwenden: : ? & = % / (Schrägstrich)

ADSLängenbeschränkungen für Abfrageparameter

Die folgenden Längenbeschränkungen gelten für Abfrageparameter, die in Anfragen an folgende Adresse verwendet werdenADS:

  • ADSParametername: 10000 Zeichen

  • ADSParameterwert: 25000 Zeichen

  • ADSURL: 25000 Zeichen

Fortgeschrittene Nutzung

Sie können die ADS Anfrage auf viele Arten mit Spieler- und Sitzungsdaten anpassen. Die einzige Voraussetzung ist die Angabe 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]

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

DatenschutzNutzungsbedingungen für die WebsiteCookie-Einstellungen
© 2025, Amazon Web Services, Inc. oder Tochtergesellschaften. Alle Rechte vorbehalten.