View a markdown version of this page

ORTB-Feldreferenz - 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.

ORTB-Feldreferenz

Diese Seite ist eine vollständige Referenz für jedes Feld in der OpenRTB-Gebotsanfrage. Felder werden danach kategorisiert, wie MediaTailor mit ihnen umgegangen wird und ob APS sie für eine optimale Anzeigenfüllung benötigt oder empfiehlt.

Die vollständige OpenRTB 2.6-Spezifikation finden Sie in der IAB OpenRTB 2.6-Spezifikation.

Feldkategorien

Kategorie Bedeutung Deine Aktion
Verbindlich Muss in Ihrer Vorlage vorhanden sein. MediaTailor gibt einen Fehler aus, wenn er fehlt. Sie müssen diese angeben.
Von EMT fest codiert MediaTailor legt diese immer anhand von Werten aus Ihrer Konsolenkonfiguration oder dem aktuell verfügbaren Kontext fest. Ihre Vorlagenwerte werden überschrieben. Legen Sie diese nicht in Ihrer Vorlage fest.
APS empfohlen Nicht unbedingt von APS vorgeschrieben MediaTailor, aber APS empfiehlt diese für eine bessere Anzeigenfüllung und Zielgruppenausrichtung. Fehlende empfohlene Felder können zu niedrigeren Füllraten oder zu Antworten ohne Gebot führen. Dringend empfohlen.
Optional Nur in der Angebotsanfrage enthalten, wenn Sie sie angeben. Kein Standardwert. Geben Sie an, falls dies für Ihren Anwendungsfall relevant ist.

App-Objekt

Feld Kategorie Hinweise
app Verbindlich Das app Objekt muss in Ihrer Vorlage vorhanden sein.
app.bundle Erforderlich Die Bundle-ID Ihrer App (z. B.G15147002586). Darf nicht leer sein.
app.storeurl Verbindlich App Store-URL (zum Beispielhttps://apps.apple.com/us/app/yourapp/id123).
app.publisher.id Von EMT fest codiert Stellen Sie immer Ihre Konfiguration über die PublisherId Konsole ein.
app.content Obligatorisch (Objekt) MediaTailor sendet ein leeres Content Objekt, wenn Sie dies weglassen. Stellen Sie Inhaltsmetadaten für eine bessere Ausrichtung bereit.
app.name APS empfohlen App-Name zur Identifizierung.
app.id APS empfohlen Ihre App-ID in APS.
app.domain APS empfohlen App-Domäne.
app.content.genre APS empfohlen Genre des Inhalts (z. B."Sport","News").
app.content.contentrating APS empfohlen Bewertung des Inhalts (z. B."TV-G","TV-14").
app.content.language APS empfohlen Sprache des Inhalts (ISO-639-1).
app.content.id APS empfohlen Inhalts-ID.
app.content.title APS empfohlen Titel des Inhalts.
app.content.episode APS empfohlen Nummer der Folge.
app.content.len APS empfohlen Länge des Inhalts in Sekunden.
app.cat Optional Inhaltskategorien (IAB-Taxonomie).
app.sectioncat Optional Kategorien von Abschnitten.
app.pagecat Optional Kategorien von Seiten.
app.ver Optional Version der App.
app.privacypolicy Optional 1 = hat eine Datenschutzrichtlinie.
app.paid Optional 1 = kostenpflichtige App.
app.keywords Optional Comma-separated Schlüsselwörter.
app.kwarray Optional Schlüsselwörter als Array.
app.inventorypartnerdomain Optional Inventarisierung der Partner-Domain.
app.ext Optional Erweiterungsobjekt (Passthrough).

Geräte-Objekt

Feld Kategorie Hinweise
device Erforderlich Das device Objekt muss in Ihrer Vorlage vorhanden sein.
device.ua Erforderlich Zeichenfolge für den Benutzeragenten. Darf nicht leer sein. Verwenden Sie {{session.user_agent}}.
device.ip Verbindlich IPv4-Adresse. Darf nicht leer sein. Verwenden Sie {{session.client_ip}}.
device.lmt Optional (Standard: 0) Markierung „Anzeigenverfolgung einschränken“. 0= Tracking erlaubt, 1 = Tracking eingeschränkt. Falls in Ihrer Vorlage nicht angegeben, ist die Standardeinstellung. 0
device.devicetype Von EMT fest codiert (Standard: 3) MediaTailor Geräte 3 (Connected TV), falls nicht vorhanden. Ihr Wert wird verwendet, falls vorhanden.
device.make APS empfohlen Gerätehersteller (z. B."Samsung","Apple").
device.model APS empfohlen Gerätemodell (z. B."Tizen TV","iPhone").
device.os APS empfohlen Betriebssystem (z. B."Tizen","iOS").
device.osv APS empfohlen Betriebssystemversion.
device.h APS empfohlen Bildschirmhöhe in Pixeln.
device.w APS empfohlen Bildschirmbreite in Pixeln.
device.language APS empfohlen Gerätesprache (ISO-639-1).
device.ifa APS empfohlen Werbe-ID des Geräts. Nicht alle Geräte haben einen (z. B. Webbrowser).
device.dnt APS empfohlen Flagge „Nicht verfolgen“.
device.geo Optional Geo-Objekt mitcountry,lat,lon.
device.sua Optional Strukturierter Benutzeragent (UA-CH).
device.ipv6 Optional IPv6-Adresse.
device.hwv Optional Hardwareversion.
device.connectiontype Optional Verbindungstyp (WiFi, Mobilfunk usw.).
device.carrier Optional Name des Betreibers.
device.mccmnc Optional country/network Handycode.
device.ext Optional Erweiterungsobjekt (Passthrough).

Objekt IMP (Impression)

Ihre Vorlage muss genau ein imp Objekt in einem Array enthalten.

Feld Kategorie Hinweise
imp[0].video Erforderlich Das video Objekt muss existieren.
imp[0].video.mimes Erforderlich Unterstützte MIME-Typen (z. B.["video/mp4"]).
imp[0].video.protocols Optional Unterstützte VAST-Protokolle. Wenn es weggelassen wird, wird ein fest codiertes Fallback MediaTailor [1, 2, 3, 4, 5, 6, 7, 8] verwendet. Weitere Informationen finden Sie unten in der Referenz zur Protokollaufzählung.
imp[0].video.minduration Von EMT fest codiert Stellen Sie von der Konsole MinimumUnfilledDuration aus auf Ihre ein.
imp[0].video.maxduration Von EMT fest codiert Auf die tatsächliche ungefüllte Dauer (Sekunden) eingestellt.
imp[0].video.maxseq Von EMT fest codiert Berechnet:. floor(unfilled_duration / 6) APS empfiehltpoddur, entweder maxseq oder mehrere Anzeigen zurückzugeben.
imp[0].video.poddur Von EMT fest codiert Auf die ungefüllte Dauer (Sekunden) einstellen.
imp[0].video.startdelay Optional Startverzögerung. 0= Pre-Roll, -1 = generischer Mid-Roll, -2 = Post-Roll, = Offset bei mittlerer Walze in Sekunden. > 0 Wird -1 für Live-Mid-Roll-Pausen verwendet. Festcodierter Fallback:. 6
imp[0].video.w APS empfohlen Videobreite in Pixeln.
imp[0].video.h APS empfohlen Videohöhe in Pixeln.
imp[0].video.plcmt APS empfohlen Art der Platzierung (1 = In-Stream).
imp[0].video.podid APS empfohlen Pod-ID.
imp[0].video.slotinpod APS empfohlen Position des Steckplatzes im Pod.
imp[0].video.ext.slotId Optional (Standard:"default_slot_id") Ihre APS-Slot-ID von der APS-Konsole. Die Standardeinstellung funktioniert, aber wenn Sie Ihre tatsächliche Slot-ID angeben, kann APS Slot-spezifisches Targeting und Mindestpreise anwenden.
imp[0].bidfloor Optional (Standard: 1,0) Mindestgebotspreis in CPM.
imp[0].secure Optional (Standard: 1) 1 = erfordert kreative HTTPS-URLs.
imp[0].id Optional Impression-ID. Auto-generated falls nicht angegeben.
imp[0].tagid Optional Tag/placement ID.
imp[0].bidfloorcur Optional Währung für das Mindestgebot (Standardwährung USD).
imp[0].ssai Optional SSAI-Indikator.
imp[0].exp Optional Ablaufzeit für den Abdruck.
imp[0].rqddurs Optional Array mit der angeforderten Dauer.
imp[0].mincpmpersec Optional Minimaler CPM pro Sekunde.
imp[0].pmp Optional Privates Marktplatz-Objekt.
imp[0].ext Optional Erweiterungsobjekt (Passthrough).

Referenz zur Protokollaufzählung

Wert Protocol (Protokoll)
1 VAST 1.0
2 RIESIG 2.0
3 RIESIG 3.0
4 VAST 1.0-Wrapper
5 VAST 2.0-Wrapper
6 VAST 3.0-Wrapper
7 VAST 4.0
8 VAST 4.0-Wrapper
9+ DAAST

Top-level Felder

Feld Kategorie Hinweise
id Von EMT fest codiert Auto-generated: {sessionId}_{availId} Format (zum Beispiel). abc123-def456_78901 Nützlich, um Angebotsanfragen mit Sitzungsprotokollen zu korrelieren.
cur Optional (Standardeinstellung:["USD"]) Zulässige Währungen.
ext.integrationType Von EMT fest codiert Immer auf eingestellt. "EMT"
bcat Optional Kategorien blockierter Anzeigen (IAB-Taxonomie). Ihr Vorlagenwert wird unverändert an APS gesendet.
badv Optional Blockierte Domains von Werbetreibenden.
bapp Optional Blockierte App-Paket-IDs.
test Optional Flagge für den Testmodus.
at Optional Art der Auktion.
tmax Optional Maximale Wartezeit (ms) auf eine Angebotsantwort.
wseat Optional Erlaubte Plätze für Käufer.
bseat Optional Gesperrte Plätze für Käufer.
wlang Optional Erlaubte kreative Sprachen.
source Optional Quellobjekt für die Lieferkette.
ext Optional Ihre benutzerdefinierten Erweiterungsfelder werden mit EMTs integrationType zusammengeführt.

Benutzerobjekt

Feld Kategorie Hinweise
user APS empfohlen (EU) Erforderlich für den EU-Verkehr mit Zustimmung der DSGVO.
user.consent APS empfohlen (EU) DSGVO-Einwilligungszeichenfolge (TCF).
user.id Optional Benutzer-ID.
user.buyeruid Optional Buyer-specific Benutzer-ID.
user.eids Optional Erweiterte Bezeichner (LiveRamp, UID2 usw.).
user.data Optional Benutzerdatensegmente.
user.ext Optional Erweiterungsobjekt.

Regs-Objekt

Feld Kategorie Hinweise
regs APS empfohlen Zur Einhaltung gesetzlicher Vorschriften einschließen.
regs.coppa APS empfohlen (USA) COPPA-Flagge (1 = von Kindern geleitet).
regs.us_privacy APS empfohlen (USA) US-Datenschutz/CCPA-Zeichenfolge.
regs.gdpr APS empfohlen (EU) Es gilt die DSGVO (1 = ja).
regs.gpp APS empfohlen Zeichenfolge der globalen Datenschutzplattform. Wird us_privacy für US-amerikanische Zielgruppen bevorzugt, was zu besseren Füllraten führt. Siehe Bewährte Methoden.
regs.gpp_sid APS empfohlen GPP-Abschnitts-IDs (z. B. [7] für US National). Erforderlich, wenn gpp vorhanden.
regs.ext Optional Erweiterungsobjekt.

Nächste Schritte