DokumentationExperience PlatformHandbuch zum Experience-Datenmodell (XDM)

Advertising-Details Schemafeldgruppe

Last update: Tue Oct 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

Erstellt für:

  • Entwickler

Advertising-: ist eine Standardschemafeldgruppe für die XDM ExperienceEvent class. Die Feldergruppe stellt ein einzelnes advertising für ein Schema bereit, das Informationen zu Werbeimpressionen, Clickthroughs und Attribution erfasst.

Feldergruppenstruktur

Eigenschaft
Datentyp
Beschreibung
adAssetReference
Objekt
Erfasst Asset-Informationen über die Anzeige. Weitere Informationen ​ Struktur dieses Objekts ​ Sie im Abschnitt „Unterabschnitt unten“.
adAssetViewDetails
Objekt
Erfasst Ansichtsdetails für die Anzeigenwiedergabe. Weitere Informationen ​ Struktur dieses Objekts ​ Sie im Abschnitt „Unterabschnitt unten“.
adViewability
Objekt
Erfasst die Anzahl der Impressionen, die von Endbenutzenden angezeigt werden, z. B. Player-Lautstärke, Bibliotheksversion, Fensterstatus und Anzeigenansichtsfenster-Dimensionen. Weitere Informationen ​ Struktur dieses Objekts ​ Sie im Abschnitt „Unterabschnitt unten“.
clicks
Maßnahme
Die Anzahl der Klickaktionen auf die Anzeige.
completes
Maßnahme
Die Häufigkeit, mit der ein zeitgesteuertes Medien-Asset bis zum Ende angesehen wurde. Dies bedeutet nicht unbedingt, dass der Endbenutzer das gesamte Video angesehen hat, da er möglicherweise vorgesprungen ist.
conversions
Maßnahme
Die Häufigkeit, mit der eine vordefinierte Aktion (oder Aktionen) ein Ereignis zur Leistungsbewertung ausgelöst hat.
federated
Maßnahme
Zeigt an, ob ein Erlebnisereignis durch Datenverbund erstellt wurde, z. B. durch gemeinsame Nutzung von Daten durch Kunden.
firstQuartiles
Maßnahme
Die Häufigkeit, mit der eine digitale Videoanzeige 25 % ihrer Dauer mit normaler Geschwindigkeit wiedergegeben hat.
impressions
Maßnahme
Die Anzahl der an einen Endbenutzer gesendeten Anzeigen-Impressions mit dem Potenzial, angezeigt zu werden.
midpoints
Maßnahme
Die Häufigkeit, mit der eine digitale Videoanzeige 50 % ihrer Dauer mit normaler Geschwindigkeit wiedergegeben hat.
starts
Maßnahme
Die Häufigkeit, mit der die Wiedergabe einer digitalen Videoanzeige begonnen hat.
thirdQuartiles
Maßnahme
Die Häufigkeit, mit der eine digitale Videoanzeige 75 % ihrer Dauer mit normaler Geschwindigkeit wiedergegeben hat.
timePlayed
Maßnahme
Die Zeit, die ein Endbenutzer mit einem bestimmten zeitgesteuerten Medien-Asset verbracht hat.
downloadedPlayback
Boolesch
Wenn auf true gesetzt, bedeutet dies, dass der Treffer aufgrund der Wiedergabe einer heruntergeladenen Anzeigensitzung erzeugt wird.

adAssetReference adAssetReference

Das adAssetReference erfasst Asset-Informationen über die Anzeige.

adAssetReference-Struktur

Eigenschaft
Datentyp
Beschreibung
_dc.title
Zeichenfolge
Der benutzerfreundliche und menschenlesbare Name des Anzeigen-Assets.
_xmpDM.duration
Ganzzahl
Die Dauer des Assets in Sekunden.
_id
String
Eine eindeutige Kennung des Anzeigen-Assets, die dem Ad-ID-Standard) ​.
advertiser
String
Die Firma oder Marke, deren Produkt in der Anzeige zu sehen ist.
campaign
String
Die ID der Anzeigenkampagne.
creativeID
String
Die ID des Kreativinhalts der Anzeige.
creativeURL
String
Die URL des Kreativinhalts der Anzeige.
placementID
String
Die Platzierungs-ID der Anzeige.
siteID
String
Die ID der Anzeigen-Site.

adAssetViewDetails adAssetViewDetails

Das adAssetViewDetails-Objekt erfasst Ansichtsdetails für die Anzeigenwiedergabe.

adAssetViewDetails-Struktur

Eigenschaft
Datentyp
Beschreibung
adBreak
Werbeunterbrechung
Beschreibt, wie eine zeitgesteuerte Anzeige in zeitgesteuerte Medien eingefügt wird.
index
Ganzzahl
Der Index der Anzeige innerhalb der übergeordneten Anzeigenunterbrechung. Beispielsweise verfügt die erste Anzeige über Index 0 und die zweite Anzeige über Index 1.
playerName
String
Der Name des Players, der für das Rendering der Werbeanzeige verantwortlich ist.

adViewability adViewability

Das adViewability-Objekt erfasst die Anzahl der Impressionen, die von Endbenutzenden angezeigt werden, z. B. die Player-Lautstärke, die Bibliotheksversion, den Fensterstatus und die Abmessungen des Anzeigenansichtsfensters.

adVieability-Struktur

Eigenschaft
Datentyp
Beschreibung
implementationDetails
Implementierungsdetails
Name und Version der Bibliothek, die zur Messung der Sichtbarkeitsmetriken verwendet wird.
measuredAdNotVisible
Maßnahme
Zeigt an, dass die Anzeige, gemessen anhand einer Sichtbarkeitsbibliothek zum Zeitpunkt der Impression, nicht sichtbar ist.
measuredMuted
Maßnahme
Gibt an, dass die Anzeige stummgeschaltet ist, was anhand einer Sichtbarkeitsbibliothek zum Zeitpunkt der Impression gemessen wird.
unmeasurableIframe
Maßnahme
Gibt an, dass die Anzeige in einem inaktiven Fenster angezeigt wird, gemessen anhand einer Sichtbarkeitsbibliothek zum Zeitpunkt der Impression.
unmeasurableOther
Maßnahme
Zeigt an, dass die Sichtbarkeitsbibliothek aufgrund der Anzeige innerhalb eines iFrames nicht in der Lage ist, Messungen korrekt auszuführen.
viewabilityEligibleImpressions
Maßnahme
Impression(en) einer Anzeige für einen Endbenutzer unter Verwendung einer Sichtbarkeitsbibliothek.
viewabilityCompletes
Maßnahme
Beendigungen einer Werbeanzeige für einen Endbenutzer, die zum Zeitpunkt der Beendigung von einer Sichtbarkeitsbibliothek als sichtbar erachtet wird.
viewableFirstQuartiles
Maßnahme
Erste(s) Quartil(e) einer Anzeige für einen Endbenutzer, die von einer Sichtbarkeitsbibliothek im ersten Quartil der Wiedergabe als sichtbar erachtet wird.
viewableImpressions
Maßnahme
Impressionen einer Anzeige für einen Endbenutzer, die von einer Sichtbarkeitsbibliothek nach zwei Sekunden der Wiedergabe als sichtbar erachtet wird.
viewableMidpoints
Maßnahme
Mittelpunkte einer Anzeige für einen Endbenutzer, die von einer Sichtbarkeitsbibliothek im Mittelpunkt der Wiedergabe als sichtbar erachtet wird.
viewableThirdQuartiles
Maßnahme
Dritte(s) Quartil(e) einer Anzeige für einen Endbenutzer, die von einer Sichtbarkeitsbibliothek im dritten Quartil der Wiedergabe als sichtbar erachtet wird.
activeWindow
Boolesch
Zeigt an, ob die Anzeige im aktiven Fenster des Geräts des Benutzers angezeigt wurde.
adHeight
Ganzzahl
Die Anzahl der zur Laufzeit gemessenen vertikalen Pixel des Players. Diese kann größer sein als die Größe der Anzeige, wenn der Player über zusätzliche Steuerelemente oder Miniaturansichten verfügt.
adUnitDepth
Ganzzahl
Publisher können Anzeigeneinheiten in Container (iFrames) einbetten, um den Zugriff der Anzeige ausschließlich auf den Code der Seite zu beschränken. Dieser Wert beschreibt, in wie vielen Containern die Werbeeinheit angezeigt wird.
adWidth
Ganzzahl
Die Anzahl der zur Laufzeit gemessenen horizontalen Pixel des Players. Diese kann größer sein als die Größe der Anzeige, wenn der Player über zusätzliche Steuerelemente oder Miniaturansichten verfügt.
measurementEligible
Boolesch
Ob die Sichtbarkeitsmessungen für die Anzeige zulässig sind. Eine Anzeige ist zulässig, wenn das Gerät über ein unterstütztes kreatives Format und einen unterstützten Tag-Typ verfügt.
percentViewable
Ganzzahl
Der Prozentsatz der Pixel in der Anzeige, die zum Zeitpunkt der Messung als sichtbar erachtet werden.
playerVolume
Ganzzahl
Der Prozentsatz der Player-Lautstärke, gemessen zur Laufzeit, wobei 0 stummgeschaltet und 100 die maximale Lautstärke ist.
viewable
Boolesch
Gibt an, ob die Anzeige zur Laufzeit sichtbar war. Display-Anzeigen gelten als sichtbar, wenn mindestens 50 % der Anzeige mindestens eine Sekunde lang sichtbar sind. Videoanzeigen werden als sichtbar betrachtet, wenn mindestens 50 % der Anzeige sichtbar sind, während das Video mindestens zwei aufeinander folgende Sekunden lang wiedergegeben wird.
viewportHeight
Ganzzahl
Die vertikale Größe (in Pixeln) des Fensters, in dem das Erlebnis angezeigt wurde, gemessen zur Laufzeit. Bei einem Web-Ansichtsereignis gibt dieser Wert die Höhe des Browser-Ansichtsfensters an.
viewportWidth
Ganzzahl
Die horizontale Größe (in Pixeln) des Fensters, in dem das Erlebnis angezeigt wurde, gemessen zur Laufzeit. Bei einem Web-Ansichtsereignis gibt dieser Wert die Breite des Browser-Ansichtsfensters an.

Weitere Informationen zur Feldergruppe finden Sie unter öffentliches XDM-Repository.

recommendation-more-help
62e9ffd9-1c74-4cef-8f47-0d00af32fc07