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