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. Es 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. Es el período de visualización del grupo de Floodlight. Se requieren clickDays y impressionDays. Los valores aceptables para ambos son del 0 al 90, inclusive.

customVariables

object (Struct format)

Son variables personalizadas definidas por el usuario y propiedad del grupo de Floodlight. Utiliza variables personalizadas de Floodlight para crear datos de informes que se adapten a las necesidades únicas de tu empresa. Las variables personalizadas de Floodlight usan las claves U1=, U2=, etcétera, y pueden tomar 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.

Las variables personalizadas de Floodlight no se pueden usar 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 de "U1" a "U100", inclusive. Los valores de cadena deben tener menos de 64 caracteres y no pueden contener los siguientes caracteres: "<>.

activeViewConfig

object (ActiveViewVideoViewabilityMetricConfig)

Es 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 del tipo no se especificó o es desconocido en esta versión.
WEB_TAG_TYPE_NONE No hay tipo de etiqueta.
WEB_TAG_TYPE_IMAGE Es la etiqueta de imagen.
WEB_TAG_TYPE_DYNAMIC Es una etiqueta dinámica.

LookbackWindow

Especifica cuántos días hacia atrás se deben tener en cuenta para determinar si se debe registrar una conversión.

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

integer

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

impressionDays

integer

Es el período de observación, en días, desde la última vez que un usuario determinado vio uno de tus anuncios.

ActiveViewVideoViewabilityMetricConfig

Es la configuración de las métricas personalizadas de visibilidad de video 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 que se requiere 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 la 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 la métrica si se cumple cualquiera de los requisitos (lo que ocurra primero).

VideoViewabilityPercent

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

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

VideoVolumePercent

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

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

VideoDurationSeconds

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

Enumeraciones
VIDEO_DURATION_UNSPECIFIED El valor no se especificó o es desconocido en esta versión.
VIDEO_DURATION_SECONDS_NONE No hay 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 especificó o es desconocido en esta versión.
VIDEO_DURATION_QUARTILE_NONE No hay valor de cuartil.
VIDEO_DURATION_QUARTILE_FIRST Primer cuartil.
VIDEO_DURATION_QUARTILE_SECOND Segundo cuartil (punto medio).
VIDEO_DURATION_QUARTILE_THIRD Es el 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.