DokumentationExperience PlatformHandbuch zum Experience-Datenmodell (XDM)

Werbedetails Schemafeldgruppe

Last update: Mon Dec 18 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Developer

Werbedetails ist eine Standardschemafeldgruppe für die XDM ExperienceEvent class. Die Feldergruppe stellt eine einzelne advertising -Objekt zu einem Schema, das Informationen zu Werbeimpressionen, Clickthroughs und Attribution erfasst.

Feldgruppenstruktur

Eigenschaft
Datentyp
Beschreibung
adAssetReference
Objekt
Erfasst Asset-Informationen zur Anzeige. Siehe Unterabschnitt unten für weitere Informationen zur Struktur dieses Objekts.
adAssetViewDetails
Objekt
Erfasst Ansichtsdetails für die Anzeigenwiedergabe. Siehe Unterabschnitt unten für weitere Informationen zur Struktur dieses Objekts.
adViewability
Objekt
Erfasst die Anzahl der Impressionen, die von Endbenutzern angezeigt werden, z. B. Player-Lautstärke, Bibliotheksversion, Fensterstatus und Anzeigendarstellungsfelddimensionen. Siehe Unterabschnitt unten für weitere Informationen zur Struktur dieses Objekts.
clicks
Maßnahme
Die Anzahl der Klickaktionen für die Anzeige.
completes
Maßnahme
Die Häufigkeit, mit der ein zeitgesteuertes Medien-Asset bis zum Ende angesehen wurde. Das bedeutet nicht unbedingt, dass der Endbenutzer das gesamte Video angesehen hat, da er es möglicherweise übersprungen hat.
conversions
Maßnahme
Die Häufigkeit, mit der eine vordefinierte Aktion (oder Aktionen) ein Ereignis zur Leistungsbewertung ausgelöst hat.
federated
Maßnahme
Gibt an, ob ein Erlebnisereignis über eine Datenverknüpfung erstellt wurde, z. B. die Datenfreigabe zwischen 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 Anzeigenimpressionen, die an einen Endbenutzer gesendet werden, der potenziell angezeigt wird.
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 gestartet wurde.
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 festgelegt auf truegibt an, dass der Treffer aufgrund der Wiedergabe einer heruntergeladenen Anzeigensitzung generiert wird.

adAssetReference adAssetReference

Die adAssetReference -Objekt erfasst Asset-Informationen über die Anzeige.

adAssetReference-Struktur

Eigenschaft
Datentyp
Beschreibung
_dc.title
Zeichenfolge
Der benutzerfreundliche und für Menschen lesbare Name des Anzeigen-Assets.
_xmpDM.duration
Ganzzahl
Die Länge oder Dauer des Assets in Sekunden.
_id
Zeichenfolge
Eine eindeutige Kennung des Anzeigen-Assets, die der Ad-ID-Standard.
advertiser
Zeichenfolge
Das Unternehmen oder die Marke, deren Produkt in der Anzeige vorgestellt wird.
campaign
Zeichenfolge
Die ID der Anzeigenkampagne.
creativeID
Zeichenfolge
Die ID des Anzeigenmotivs.
creativeURL
Zeichenfolge
Die URL des Anzeigenmotivs.
placementID
Zeichenfolge
Die Platzierungs-ID der Anzeige.
siteID
Zeichenfolge
Die ID der Anzeigen-Site.

adAssetViewDetails adAssetViewDetails

Die 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 Werbeunterbrechung. Beispielsweise hat die erste Anzeige einen Index 0 und die zweite Anzeige einen Index aufweist 1.
playerName
Zeichenfolge
Der Name des Players, der für die Wiedergabe der Anzeige verantwortlich ist.

adViewability adViewability

Die adViewability -Objekt erfasst die Anzahl der Impressionen, die von Endbenutzern gesehen werden, wie z. B. Player-Lautstärke, Bibliotheksversion, Fensterstatus und Anzeigenansichtsdimensionen.

adViewability-Struktur

Eigenschaft
Datentyp
Beschreibung
implementationDetails
Implementierungsdetails
Name und Version der Bibliothek, die zur Messung der Sichtbarkeitsmetriken verwendet wird.
measuredAdNotVisible
Maßnahme
Gibt an, dass die Anzeige nicht sichtbar ist, gemessen durch eine Sichtbarkeitsbibliothek zur Impressionszeit.
measuredMuted
Maßnahme
Gibt an, dass die Anzeige laut Messung durch eine Sichtbarkeitsbibliothek zur Impressionszeit stummgeschaltet ist.
unmeasurableIframe
Maßnahme
Gibt an, dass die Anzeige in einem inaktiven Fenster angezeigt wird, gemessen durch eine Sichtbarkeitsbibliothek zur Impressionszeit.
unmeasurableOther
Maßnahme
Gibt 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 mit einer Sichtbarkeitsbibliothek.
viewabilityCompletes
Maßnahme
Fertigstellung(en) einer Anzeige für einen Endbenutzer, die von einer Sichtbarkeitsbibliothek zum Zeitpunkt der Fertigstellung 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 mitten im Spiel 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
Gibt an, ob die Anzeige im aktiven Fenster des Benutzergeräts 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
Herausgeber können Werbeeinheiten in Container (iFrames) einbetten, um den Zugriff der Anzeige nur auf den Code der Seite zu beschränken. Dieser Wert beschreibt, in wie vielen Containern die Anzeigeneinheit 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, der zum Zeitpunkt der Messung als sichtbar erachtet wird.
playerVolume
Ganzzahl
Der Prozentsatz der Player-Lautstärke, gemessen zur Laufzeit, wobei 0 stummgeschaltet ist und 100 ist die maximale Lautstärke.
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 gelten als sichtbar, wenn mindestens 50 % der Anzeige während der Videowiedergabe mindestens zwei Sekunden lang sichtbar sind.
viewportHeight
Ganzzahl
Die vertikale Größe (in Pixel) des Fensters, in dem das Erlebnis zur Laufzeit angezeigt wurde. Bei einem Webansichtsereignis gibt dieser Wert die Höhe des Browser-Viewports an.
viewportWidth
Ganzzahl
Die horizontale Größe (in Pixel) des Fensters, in dem das Erlebnis zur Laufzeit angezeigt wurde. Bei einem Webansichtsereignis gibt dieser Wert die Breite des Browser-Viewports an.

Weiterführende Informationen zur Feldergruppe finden Sie im Abschnitt öffentliches XDM-Repository.

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