REST Resource: floodlightGroups

Ressource: FloodlightGroup

Eine einzelne Floodlight-Gruppe.

JSON-Darstellung
{
  "name": string,
  "floodlightGroupId": string,
  "displayName": string,
  "webTagType": enum (WebTagType),
  "lookbackWindow": {
    object (LookbackWindow)
  },
  "customVariables": {
    object
  },
  "activeViewConfig": {
    object (ActiveViewVideoViewabilityMetricConfig)
  }
}
Felder
name

string

Nur Ausgabe. Der Ressourcenname der Floodlight-Gruppe.

floodlightGroupId

string (int64 format)

Nur Ausgabe. Die eindeutige ID der Floodlight-Gruppe. Vom System zugewiesen.

displayName

string

Erforderlich. Der Anzeigename der Floodlight-Gruppe.

webTagType

enum (WebTagType)

Erforderlich. Der für die Floodlight-Gruppe aktivierte Web-Tag-Typ.

lookbackWindow

object (LookbackWindow)

Erforderlich. Das Lookback-Window für die Floodlight-Gruppe. Sowohl clickDays als auch impressionDays sind erforderlich. Zulässige Werte für beide sind 0 bis 90 (einschließlich).

customVariables

object (Struct format)

Benutzerdefinierte Variablen, die zur Floodlight-Gruppe gehören Mit benutzerdefinierten Floodlight-Variablen können Sie Berichtsdaten erstellen, die genau auf Ihre Geschäftsanforderungen zugeschnitten sind. Benutzerdefinierte Floodlight-Variablen verwenden die Schlüssel U1=, U2= usw. und können alle Werte annehmen, die Sie ihnen zuweisen. Sie können damit zahlreiche Daten zu Ihren Kunden erfassen. Beispiele sind das Genre eines Films, den der Kunde erwirbt, das Land, in das der Artikel geliefert wird, usw.

Benutzerdefinierte Floodlight-Variablen dürfen nicht zur Weitergabe von Daten verwendet werden, die als personenidentifizierbare Informationen verwendet oder als solche erkannt werden könnten.

Beispiel: customVariables { fields { "U1": value { numberValue: 123.4 }, "U2": value { stringValue: "MyVariable2" }, "U3": value { stringValue: "MyVariable3" } } }

Zulässige Werte für Schlüssel sind „U1“ bis „U100“. Stringwerte dürfen maximal 64 Zeichen lang sein und dürfen die folgenden Zeichen nicht enthalten: "<>.

activeViewConfig

object (ActiveViewVideoViewabilityMetricConfig)

Die Konfiguration des Active View-Sichtbarkeitsmesswerts für die Floodlight-Gruppe

WebTagType

Die möglichen Arten von Web-Tags für eine Floodlight-Gruppe.

Enums
WEB_TAG_TYPE_UNSPECIFIED Der Typwert ist in dieser Version nicht angegeben oder unbekannt.
WEB_TAG_TYPE_NONE Kein Tag-Typ.
WEB_TAG_TYPE_IMAGE Bild-Tag.
WEB_TAG_TYPE_DYNAMIC Dynamisches Tag.

LookbackWindow

Gibt an, welcher Zeitraum in der Vergangenheit beim Erfassen einer Conversion berücksichtigt werden soll.

JSON-Darstellung
{
  "clickDays": integer,
  "impressionDays": integer
}
Felder
clickDays

integer

Lookback-Window in Tagen vom letzten Klick eines Nutzers auf eine Ihrer Anzeigen.

impressionDays

integer

Lookback-Window in Tagen, d. h. den Zeitraum, in dem ein Nutzer eine Ihrer Anzeigen zuletzt angesehen hat

ActiveViewVideoViewabilityMetricConfig

Konfiguration für benutzerdefinierte Active View-Sichtbarkeitsmesswerte für Videos.

JSON-Darstellung
{
  "displayName": string,
  "minimumViewability": enum (VideoViewabilityPercent),
  "minimumVolume": enum (VideoVolumePercent),
  "minimumDuration": enum (VideoDurationSeconds),
  "minimumQuartile": enum (VideoDurationQuartile)
}
Felder
displayName

string

Erforderlich. Der Anzeigename des benutzerdefinierten Messwerts.

minimumViewability

enum (VideoViewabilityPercent)

Erforderlich. Der Mindestprozentsatz der Pixel der Videoanzeige, die auf dem Bildschirm sichtbar sind, damit eine Impression erfasst wird.

minimumVolume

enum (VideoVolumePercent)

Erforderlich. Der Mindestprozentsatz des Volumens der Videoanzeige, der erforderlich ist, damit eine Impression erfasst wird.

minimumDuration

enum (VideoDurationSeconds)

Die Mindestdauer des sichtbaren Videos (in Sekunden), die erforderlich ist, damit eine Impression erfasst wird.

Sie müssen minimumDuration, minimumQuartile oder beides angeben. Wenn beide angegeben sind, erfüllt eine Impression die Messwertkriterien, wenn eine der beiden Anforderungen erfüllt ist (je nachdem, was zuerst eintritt).

minimumQuartile

enum (VideoDurationQuartile)

Die erforderliche Mindestdauer der sichtbaren Videowiedergabe basierend auf den Videoquartilen, damit eine Impression erfasst werden kann.

Sie müssen minimumDuration, minimumQuartile oder beides angeben. Wenn beide angegeben sind, erfüllt eine Impression die Messwertkriterien, wenn eine der beiden Anforderungen erfüllt ist (je nachdem, was zuerst eintritt).

VideoViewabilityPercent

Mögliche Prozentwerte für die sichtbaren Pixel einer Videoanzeige

Enums
VIEWABILITY_PERCENT_UNSPECIFIED Der Wert ist in dieser Version nicht angegeben oder unbekannt.
VIEWABILITY_PERCENT_0 0% sichtbar.
VIEWABILITY_PERCENT_25 25% sichtbar.
VIEWABILITY_PERCENT_50 50% sichtbar.
VIEWABILITY_PERCENT_75 75 % sichtbar.
VIEWABILITY_PERCENT_100 100% sichtbar.

VideoVolumePercent

Mögliche Prozentwerte für die Wiedergabelautstärke einer Videoanzeige.

Enums
VIDEO_VOLUME_PERCENT_UNSPECIFIED Der Wert ist in dieser Version nicht angegeben oder unbekannt.
VIDEO_VOLUME_PERCENT_0 0% Lautstärke.
VIDEO_VOLUME_PERCENT_10 10 % der Lautstärke.

VideoDurationSeconds

Mögliche Werte in Sekunden für die sichtbare Dauer einer Videoanzeige.

Enums
VIDEO_DURATION_UNSPECIFIED Der Wert ist in dieser Version nicht angegeben oder unbekannt.
VIDEO_DURATION_SECONDS_NONE Kein Wert für die Dauer.
VIDEO_DURATION_SECONDS_0 0 Sekunden.
VIDEO_DURATION_SECONDS_1 1 Sekunde.
VIDEO_DURATION_SECONDS_2 2 Sekunden.
VIDEO_DURATION_SECONDS_3 3 Sekunden.
VIDEO_DURATION_SECONDS_4 4 Sekunden.
VIDEO_DURATION_SECONDS_5 5 Sekunden.
VIDEO_DURATION_SECONDS_6 6 Sekunden.
VIDEO_DURATION_SECONDS_7 7 Sekunden.
VIDEO_DURATION_SECONDS_8 8 Sekunden.
VIDEO_DURATION_SECONDS_9 9 Sekunden.
VIDEO_DURATION_SECONDS_10 10 Sekunden.
VIDEO_DURATION_SECONDS_11 11 Sekunden.
VIDEO_DURATION_SECONDS_12 12 Sekunden.
VIDEO_DURATION_SECONDS_13 13 Sekunden.
VIDEO_DURATION_SECONDS_14 14 Sekunden.
VIDEO_DURATION_SECONDS_15 15 Sekunden.
VIDEO_DURATION_SECONDS_30 30 Sekunden
VIDEO_DURATION_SECONDS_45 45 Sekunden.
VIDEO_DURATION_SECONDS_60 60 Sekunden.

VideoDurationQuartile

Mögliche Quartilswerte für die sichtbare Dauer einer Videoanzeige.

Enums
VIDEO_DURATION_QUARTILE_UNSPECIFIED Der Wert ist in dieser Version nicht angegeben oder unbekannt.
VIDEO_DURATION_QUARTILE_NONE Kein Quartilwert.
VIDEO_DURATION_QUARTILE_FIRST Erstes Quartil.
VIDEO_DURATION_QUARTILE_SECOND Zweites Quartil (Mittelpunkt).
VIDEO_DURATION_QUARTILE_THIRD Drittes Quartil.
VIDEO_DURATION_QUARTILE_FOURTH Viertes Quartil (Vervollständigung).

Methoden

get

Ruft eine Floodlight-Gruppe ab.

patch

Aktualisiert eine vorhandene Floodlight-Gruppe.