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, z. B. das Genre eines Films, den der Kunde erwirbt, oder das Land, in das der Artikel geliefert wird.

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 einschließlich U100. Stringwerte müssen kürzer als 64 Zeichen sein und dürfen folgende 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, das heißt, den Zeitraum, in dem ein Nutzer zuletzt auf eine Ihrer Anzeigen geklickt hat.

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 einer 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. Sind beide angegeben, erfüllt eine Impression die Messwertkriterien, sofern eine Anforderung erfüllt ist (je nachdem, was zuerst eintritt).

minimumQuartile

enum (VideoDurationQuartile)

Die Mindestdauer des sichtbaren Videos, die basierend auf den Videoquartilen erforderlich ist, damit eine Impression erfasst wird.

Sie müssen minimumDuration, minimumQuartile oder beides angeben. Sind beide angegeben, erfüllt eine Impression die Messwertkriterien, sofern eine Anforderung 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% Lautstärke.

VideoDurationSeconds

Mögliche Werte in Sekunden der sichtbaren 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 Quartilwerte 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.