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.

Angebotserstellung und Templateerstellung

Auf dieser Seite wird erklärt, wie eine OpenRTB-Gebotsanfrage aus Ihrer Vorlage MediaTailor erstellt wird, wie die Variableninterpolation funktioniert und welche Werte automatisch festgelegt werden. MediaTailor

Felder für die Konfiguration

Wenn Sie die Ertragsoptimierung für eine Wiedergabekonfiguration aktivieren, geben Sie vier Felder an:

Wie ist die Angebotsanfrage aufgebaut

Wenn eine Werbeunterbrechung noch eine ungenutzte Laufzeit hat, wird MediaTailor die Angebotsanfrage in den folgenden Schritten erstellt:

Standardvorlage für die Konsole

Wenn Sie die Ertragsoptimierung in der MediaTailor Konsole aktivieren, wird die folgende vorgefüllte Vorlage als Ausgangspunkt bereitgestellt. Sie sollten die Werte für Ihre Anwendung anpassen:

{
  "imp": [
    {
      "bidfloor": 5
    }
  ],
  "app": {
    "id": "{{player_params.app_id}}",
    "name": "{{player_params.app_name}}",
    "bundle": "{{player_params.bundle}}",
    "storeurl": "{{player_params.storeurl}}",
    "domain": "{{player_params.domain}}",
    "content": {
      "genre": "{{asset.genre}}",
      "contentrating": "{{asset.content_rating}}"
    }
  },
  "device": {
    "dnt": "{{player_params.dnt}}",
    "ua": "{{session.user_agent}}",
    "ip": "{{session.client_ip}}",
    "ifa": "{{player_params.device_ifa}}",
    "w": "{{player_params.device_width}}",
    "h": "{{player_params.device_height}}",
    "language": "{{player_params.language}}",
    "model": "{{player_params.model}}",
    "os": "{{player_params.os}}",
    "osv": "{{player_params.osv}}",
    "devicetype": "{{player_params.devicetype}}",
    "make": "{{player_params.make}}"
  },
  "user": {
    "consent": "{{player_params.consent}}"
  },
  "regs": {
    "gdpr": "{{player_params.gdpr}}",
    "us_privacy": "{{player_params.us_privacy}}",
    "gpp": "{{player_params.gpp_consent}}",
    "gpp_sid": "{{player_params.gpp_sid}}"
  }
}

Field-by-field Erklärung:

Vorlageninterpolation (Moustache Templating)

Ihre ORTB-Vorlage verwendet die Mustache-Templating-Syntax für die dynamische Wertersetzung. Platzhalter verwenden doppelte geschweifte Klammern. {{ }}

Verfügbare Vorlagenvariablen

Ihre ORTB-Vorlage kann dieselben dynamischen Variablen verwenden, die in ADS-URL-Vorlagen verfügbar sind. Dazu gehören Sitzungsvariablen (z. B.,{{session.client_ip}}){{session.user_agent}}, Player-Parameter ({{player_params.*}}), Asset-Metadaten ({{asset.*}}), Avail-Kontext ({{avail.*}}) und SCTE-Signaldaten (). {{scte.*}}

Die vollständige Liste der verfügbaren Variablen und ihre Beschreibungen finden Sie unter. MediaTailor dynamische Anzeigenvariablen für ADS-Anfragen Wie man MediaTailor URL-decodes Parameterwerte abspielt, bevor man sie in die Vorlage einfügt, finden Sie weiter unten Verhalten beim Kodieren und Dekodieren auf dieser Seite.

Die am häufigsten verwendeten Variablen in ORTB-Vorlagen sind:

Wie übergibt man Spielerparameter

Es gibt zwei Möglichkeiten, Spielerparameter während der Sitzungsinitialisierung zu übergeben.

Methode 1: POST-Anfrage mit JSON-Text (empfohlen)

POST https://<mediatailor-endpoint>/v1/session/<config-hash>/<origin-id>/master.m3u8
Content-Type: application/json

{
  "playerParams": {
    "app_id": "558775_example",
    "slot_id": "608109df-2378-4bc5-8da5-24bc355f01a4",
    "os": "Tizen",
    "make": "Samsung",
    "model": "Tizen TV",
    "language": "en",
    "us_privacy": "1YNY"
  }
}

Diese Methode wird bevorzugt, da sie URL-encoding Probleme mit komplexen Werten wie User-Agent-Zeichenketten vermeidet.

Methode 2: URL-Abfrageparameter

GET https://<mediatailor-endpoint>/v1/session/<config-hash>/<origin-id>/master.m3u8
  ?playerParams.app_id=558775_example

Bei dieser Methode müssen Werte wie folgt sein URL-encoded. MediaTailor URL-decodes sie vor der Interpolation.

Verhalten beim Kodieren und Dekodieren

MediaTailor führt eine URL-Dekodierung der Player-Parameterwerte auf einer Ebene durch, bevor sie in die Vorlage interpoliert werden. Dies gilt unabhängig davon, wie die Parameter übergeben werden (POST-Text oder URL-Abfrageparameter).

Beispiele für dekodierte Werte:

Die wichtigsten Punkte:

Was passiert, wenn eine Variable fehlt

Wenn der Player keinen Parameter sendet, auf den in Ihrer Vorlage verwiesen wird (zum Beispiel, {{player_params.app_name}} aber nicht app_name in den Player-Parametern), wird der Platzhalter in eine leere Zeichenfolge aufgelöst. ""

Auswirkung: Wenn sich die leere Zeichenfolge in einem Pflichtfeld befindet (wieapp.bundle), schlägt die Gebotsanfrage mit fehl. BidRequestConfigurationError Wenn es sich um ein optionales Feld handelt, erhält APS einen leeren Wert, was zu einer Antwort ohne Gebot (HTTP 204) führen kann.

Was wird automatisch MediaTailor gesetzt

Die folgenden Felder werden immer MediaTailor mithilfe von Werten aus Ihrer Konsolenkonfiguration und dem aktuell verfügbaren Kontext festgelegt. Wenn Sie diese in Ihre Vorlage aufnehmen, werden Ihre Werte außer Kraft gesetzt:

Nächste Schritte