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 Web-Tag-Typ, der für die Floodlight-Gruppe aktiviert ist.

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 der Floodlight-Gruppe gehören Verwenden Sie benutzerdefinierte Floodlight-Variablen, um Berichtsdaten zu erstellen, die genau auf Ihre individuellen 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, beispielsweise das Genre eines Films, den ein Kunde erwirbt, oder das Land, in das der Artikel geliefert wird.

Benutzerdefinierte Floodlight-Variablen dürfen nicht verwendet werden, um Daten weiterzugeben, die als personenidentifizierbare Informationen verwendet oder 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-Messwerts für die Sichtbarkeit von Videos 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 nicht angegeben oder in dieser Version 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 vom letzten Tag, an dem ein Nutzer eine Ihrer Anzeigen angesehen hat.

ActiveViewVideoViewabilityMetricConfig

Konfiguration für benutzerdefinierte Messwerte für die Active View-Videosichtbarkeit

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 Videoanzeigenvolumens, das erforderlich ist, damit eine Impression erfasst wird.

minimumDuration

enum (VideoDurationSeconds)

Die minimale sichtbare Videodauer (in Sekunden), die erforderlich ist, damit eine Impression erfasst wird.

Sie müssen minimumDuration, minimumQuartile oder beides angeben. Ist beides angegeben, entspricht eine Impression den Messwertkriterien, wenn eine der Anforderungen erfüllt ist (je nachdem, was zuerst eintritt).

minimumQuartile

enum (VideoDurationQuartile)

Die minimale sichtbare Videodauer, die basierend auf den Videoquartilen erforderlich ist, damit eine Impression erfasst wird.

Sie müssen minimumDuration, minimumQuartile oder beides angeben. Ist beides angegeben, entspricht eine Impression den Messwertkriterien, wenn eine der Anforderungen erfüllt ist (je nachdem, was zuerst eintritt).

VideoViewabilityPercent

Mögliche Prozentwerte für sichtbare Pixel einer Videoanzeige.

Enums
VIEWABILITY_PERCENT_UNSPECIFIED Der Wert ist nicht angegeben oder in dieser Version 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 nicht angegeben oder in dieser Version unbekannt.
VIDEO_VOLUME_PERCENT_0 Lautstärke bei 0 %.
VIDEO_VOLUME_PERCENT_10 Lautstärke bei 10 %.

VideoDurationSeconds

Mögliche Werte der sichtbaren Dauer einer Videoanzeige in Sekunden.

Enums
VIDEO_DURATION_UNSPECIFIED Der Wert ist nicht angegeben oder in dieser Version 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 nicht angegeben oder in dieser Version 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 (Abschluss).

Methoden

get

Ruft eine Floodlight-Gruppe ab.

patch

Aktualisiert eine vorhandene Floodlight-Gruppe.