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. Asignado por el sistema.

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 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 las variables personalizadas definidas por el usuario que pertenecen al grupo de Floodlight. Usa 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 posibles tipos de etiquetas web para un grupo de Floodlight.

Enums
WEB_TAG_TYPE_UNSPECIFIED El valor del tipo no se especificó o es desconocido en esta versión.
WEB_TAG_TYPE_NONE No se indicó ningún tipo de etiqueta.
WEB_TAG_TYPE_IMAGE Es la 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

Es la configuración de las métricas personalizadas de visibilidad de videos 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 (en segundos) que se requiere 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 que se requiere, 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.

Enums
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 de porcentaje del volumen de reproducción de un anuncio de video.

Enums
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 al 10%.

VideoDurationSeconds

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

Enums
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 Debe durar 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.

Enums
VIDEO_DURATION_QUARTILE_UNSPECIFIED El valor no se especifica 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 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.