REST Resource: floodlightGroups

Recurso: FloodlightGroup

Un solo grupo de Floodlight

Representación JSON
{
  "name": string,
  "floodlightGroupId": string,
  "displayName": string,
  "webTagType": enum (WebTagType),
  "lookbackWindow": {
    object (LookbackWindow)
  },
  "customVariables": {
    object
  },
  "activeViewConfig": {
    object (ActiveViewVideoViewabilityMetricConfig)
  }
}
Campos
name

string

Solo salida. Es el nombre del recurso del grupo de Floodlight.

floodlightGroupId

string (int64 format)

Solo salida. El ID único del grupo de Floodlight. El sistema lo asigna.

displayName

string

Obligatorio. Es el nombre visible del grupo de Floodlight.

webTagType

enum (WebTagType)

Obligatorio. Es el tipo de etiqueta web habilitado para el grupo de Floodlight.

lookbackWindow

object (LookbackWindow)

Obligatorio. La ventana de visualización del grupo de Floodlight. Se requieren clickDays y impressionDays. Los valores aceptables para ambos son de 0 a 90 inclusive.

customVariables

object (Struct format)

Son variables personalizadas definidas por el usuario que pertenecen al grupo de Floodlight. Usa variables personalizadas de Floodlight para crear datos de informes adaptados a tus necesidades comerciales únicas. Las variables personalizadas de Floodlight usan las claves U1=, U2=, etcétera, y pueden aceptar cualquier valor que decidas pasarles. Puedes usarlas para hacer un seguimiento de prácticamente cualquier tipo de datos que recopiles sobre tus clientes, como el género de la película que compra un cliente, el país al que se envía el artículo, etcétera.

No se pueden usar las variables personalizadas de Floodlight para pasar datos que se puedan usar o reconocer como información de identificación personal (PII).

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

Los valores aceptables para las claves son "U1" a "U100" inclusive. Los valores de cadena deben tener menos de 64 caracteres y no pueden contener los siguientes caracteres: "<>.

activeViewConfig

object (ActiveViewVideoViewabilityMetricConfig)

La configuración de la métrica de visibilidad de video de Vista activa para el grupo de Floodlight

WebTagType

Son los tipos posibles de etiquetas web para un grupo de Floodlight.

Enumeraciones
WEB_TAG_TYPE_UNSPECIFIED El valor de tipo no se especifica o es desconocido en esta versión.
WEB_TAG_TYPE_NONE No hay ningún tipo de etiqueta.
WEB_TAG_TYPE_IMAGE Etiqueta de imagen.
WEB_TAG_TYPE_DYNAMIC Etiqueta dinámica.

LookbackWindow

Especifica cuántos días en el pasado se deben consultar para determinar si se debe registrar una conversión.

Representación JSON
{
  "clickDays": integer,
  "impressionDays": integer
}
Campos
clickDays

integer

Es la ventana de visualización, en días, desde la última vez que un usuario determinado hizo clic en uno de tus anuncios.

impressionDays

integer

Es la ventana de visualización, en días, desde la última vez que un usuario determinado vio uno de tus anuncios.

ActiveViewVideoViewabilityMetricConfig

Configuración de las métricas de visibilidad de video personalizadas de Vista activa

Representación JSON
{
  "displayName": string,
  "minimumViewability": enum (VideoViewabilityPercent),
  "minimumVolume": enum (VideoVolumePercent),
  "minimumDuration": enum (VideoDurationSeconds),
  "minimumQuartile": enum (VideoDurationQuartile)
}
Campos
displayName

string

Obligatorio. Es el nombre visible de la métrica personalizada.

minimumViewability

enum (VideoViewabilityPercent)

Obligatorio. Es el porcentaje mínimo de píxeles del anuncio de video que deben estar visibles en la pantalla para que se registre una impresión.

minimumVolume

enum (VideoVolumePercent)

Obligatorio. Es el porcentaje mínimo del volumen del anuncio de video requerido para que se registre una impresión.

minimumDuration

enum (VideoDurationSeconds)

Es la duración mínima visible del video requerida (en segundos) para que se registre una impresión.

Debes especificar minimumDuration, minimumQuartile o ambos. Si se especifican ambos, una impresión cumple con los criterios de métrica si se cumple cualquiera de los requisitos (lo que ocurra primero).

minimumQuartile

enum (VideoDurationQuartile)

Es la duración mínima visible del video requerida, según los cuartiles del video, para que se registre una impresión.

Debes especificar minimumDuration, minimumQuartile o ambos. Si se especifican ambos, una impresión cumple con los criterios de métrica si se cumple cualquiera de los requisitos (lo que ocurra primero).

VideoViewabilityPercent

Son los posibles valores porcentuales de los píxeles visibles de un anuncio de video.

Enumeraciones
VIEWABILITY_PERCENT_UNSPECIFIED El valor no se especifica o es desconocido en esta versión.
VIEWABILITY_PERCENT_0 0% visible
VIEWABILITY_PERCENT_25 25% visible
VIEWABILITY_PERCENT_50 50% visible
VIEWABILITY_PERCENT_75 75% visible
VIEWABILITY_PERCENT_100 100% visible.

VideoVolumePercent

Son los posibles valores porcentuales del volumen de reproducción de un anuncio de video.

Enumeraciones
VIDEO_VOLUME_PERCENT_UNSPECIFIED El valor no se especifica o es desconocido en esta versión.
VIDEO_VOLUME_PERCENT_0 Volumen al 0%.
VIDEO_VOLUME_PERCENT_10 Volumen del 10%

VideoDurationSeconds

Son los valores posibles en segundos de la duración visible de un anuncio de video.

Enumeraciones
VIDEO_DURATION_UNSPECIFIED El valor no se especifica o es desconocido en esta versión.
VIDEO_DURATION_SECONDS_NONE No hay un valor de duración.
VIDEO_DURATION_SECONDS_0 0 segundos.
VIDEO_DURATION_SECONDS_1 1 segundo.
VIDEO_DURATION_SECONDS_2 2 segundos.
VIDEO_DURATION_SECONDS_3 3 segundos.
VIDEO_DURATION_SECONDS_4 4 segundos.
VIDEO_DURATION_SECONDS_5 5 segundos.
VIDEO_DURATION_SECONDS_6 6 segundos.
VIDEO_DURATION_SECONDS_7 7 segundos.
VIDEO_DURATION_SECONDS_8 8 segundos.
VIDEO_DURATION_SECONDS_9 9 segundos.
VIDEO_DURATION_SECONDS_10 10 segundos.
VIDEO_DURATION_SECONDS_11 11 segundos.
VIDEO_DURATION_SECONDS_12 12 segundos.
VIDEO_DURATION_SECONDS_13 13 segundos.
VIDEO_DURATION_SECONDS_14 14 segundos.
VIDEO_DURATION_SECONDS_15 15 segundos.
VIDEO_DURATION_SECONDS_30 30 segundos.
VIDEO_DURATION_SECONDS_45 45 segundos.
VIDEO_DURATION_SECONDS_60 60 segundos.

VideoDurationQuartile

Son los posibles valores de cuartil de la duración visible de un anuncio de video.

Enumeraciones
VIDEO_DURATION_QUARTILE_UNSPECIFIED El valor no se especifica o es desconocido en esta versión.
VIDEO_DURATION_QUARTILE_NONE No hay un valor de cuartil.
VIDEO_DURATION_QUARTILE_FIRST Primer cuartil.
VIDEO_DURATION_QUARTILE_SECOND Segundo cuartil (punto medio).
VIDEO_DURATION_QUARTILE_THIRD Tercer cuartil.
VIDEO_DURATION_QUARTILE_FOURTH Cuarto cuartil (finalización).

Métodos

get

Obtiene un grupo de Floodlight.

patch

Actualiza un grupo de Floodlight existente.