REST Resource: floodlightGroups

Recurso: FloodlightGroup

Um único grupo do Floodlight.

Representação JSON
{
  "name": string,
  "floodlightGroupId": string,
  "displayName": string,
  "webTagType": enum (WebTagType),
  "lookbackWindow": {
    object (LookbackWindow)
  },
  "customVariables": {
    object
  },
  "activeViewConfig": {
    object (ActiveViewVideoViewabilityMetricConfig)
  }
}
Campos
name

string

Apenas saída. O nome do recurso do grupo do Floodlight.

floodlightGroupId

string (int64 format)

Apenas saída. O ID exclusivo do grupo do Floodlight. Atribuído pelo sistema.

displayName

string

Obrigatório. O nome de exibição do grupo do Floodlight.

webTagType

enum (WebTagType)

Obrigatório. O tipo de tag da Web ativado para o grupo do Floodlight.

lookbackWindow

object (LookbackWindow)

Obrigatório. A janela de lookback do grupo do Floodlight. clickDays e impressionDays são obrigatórios. Os valores aceitáveis para ambos são de 0 a 90, inclusive.

customVariables

object (Struct format)

Variáveis personalizadas definidas pelo usuário que pertencem ao grupo do Floodlight. Use variáveis personalizadas do Floodlight para criar dados de relatório adaptados às suas necessidades comerciais exclusivas. As variáveis personalizadas do Floodlight usam as chaves U1=, U2= etc. e recebem qualquer valor que você decidir transmitir para elas. Você pode usá-las para acompanhar praticamente qualquer tipo de dado coletado sobre seus clientes, como o gênero de filme que um cliente compra, o país para onde o item é enviado e assim por diante.

As variáveis personalizadas do Floodlight não podem ser usadas para transmitir dados que possam ser usados ou reconhecidos como informações de identificação pessoal (PII).

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

Os valores aceitáveis para as chaves são de "U1" a "U100", inclusive. Os valores de string precisam ter menos de 64 caracteres e não podem conter os seguintes caracteres: "<>.

activeViewConfig

object (ActiveViewVideoViewabilityMetricConfig)

A configuração da métrica de visibilidade de vídeo do Active View para o grupo do Floodlight.

WebTagType

Os possíveis tipos de tags da Web para um grupo do Floodlight.

Tipos enumerados
WEB_TAG_TYPE_UNSPECIFIED O valor do tipo não foi especificado ou é desconhecido nesta versão.
WEB_TAG_TYPE_NONE Nenhum tipo de tag.
WEB_TAG_TYPE_IMAGE Tag de imagem.
WEB_TAG_TYPE_DYNAMIC Tag dinâmica.

LookbackWindow

Especifica quantos dias no passado devem ser analisados para determinar se uma conversão precisa ser registrada.

Representação JSON
{
  "clickDays": integer,
  "impressionDays": integer
}
Campos
clickDays

integer

Janela de lookback, em dias, desde a última vez que um determinado usuário clicou em um dos seus anúncios.

impressionDays

integer

Janela de lookback, em dias, a partir da última vez que um determinado usuário visualizou um dos seus anúncios.

ActiveViewVideoViewabilityMetricConfig

Configuração para métricas personalizadas de visibilidade de vídeo do Active View.

Representação JSON
{
  "displayName": string,
  "minimumViewability": enum (VideoViewabilityPercent),
  "minimumVolume": enum (VideoVolumePercent),
  "minimumDuration": enum (VideoDurationSeconds),
  "minimumQuartile": enum (VideoDurationQuartile)
}
Campos
displayName

string

Obrigatório. O nome de exibição da métrica personalizada.

minimumViewability

enum (VideoViewabilityPercent)

Obrigatório. A porcentagem mínima de pixels do anúncio em vídeo visíveis na tela para que uma impressão seja registrada.

minimumVolume

enum (VideoVolumePercent)

Obrigatório. A porcentagem mínima do volume do anúncio em vídeo necessária para que uma impressão seja registrada.

minimumDuration

enum (VideoDurationSeconds)

A duração mínima visível do vídeo necessária (em segundos) para que uma impressão seja registrada.

É necessário especificar minimumDuration, minimumQuartile ou ambos. Se ambos forem especificados, uma impressão vai atender aos critérios da métrica se um dos requisitos for atendido (o que acontecer primeiro).

minimumQuartile

enum (VideoDurationQuartile)

A duração mínima de visibilidade do vídeo necessária, com base nos quartis do vídeo, para que uma impressão seja registrada.

É necessário especificar minimumDuration, minimumQuartile ou ambos. Se ambos forem especificados, uma impressão vai atender aos critérios da métrica se um dos requisitos for atendido (o que acontecer primeiro).

VideoViewabilityPercent

Possíveis valores percentuais de pixels visíveis de um anúncio em vídeo.

Tipos enumerados
VIEWABILITY_PERCENT_UNSPECIFIED O valor não foi especificado ou é desconhecido nesta versão.
VIEWABILITY_PERCENT_0 0% visível.
VIEWABILITY_PERCENT_25 25% visível.
VIEWABILITY_PERCENT_50 50% visível.
VIEWABILITY_PERCENT_75 75% visível.
VIEWABILITY_PERCENT_100 100% visível.

VideoVolumePercent

Possíveis valores percentuais do volume de reprodução de um anúncio em vídeo.

Tipos enumerados
VIDEO_VOLUME_PERCENT_UNSPECIFIED O valor não foi especificado ou é desconhecido nesta versão.
VIDEO_VOLUME_PERCENT_0 0% de volume.
VIDEO_VOLUME_PERCENT_10 Volume de 10%.

VideoDurationSeconds

Valores possíveis em segundos da duração visível de um anúncio em vídeo.

Tipos enumerados
VIDEO_DURATION_UNSPECIFIED O valor não foi especificado ou é desconhecido nesta versão.
VIDEO_DURATION_SECONDS_NONE Nenhum valor de duração.
VIDEO_DURATION_SECONDS_0 0 segundo.
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

Possíveis valores de quartil da duração visível de um anúncio em vídeo.

Tipos enumerados
VIDEO_DURATION_QUARTILE_UNSPECIFIED O valor não foi especificado ou é desconhecido nesta versão.
VIDEO_DURATION_QUARTILE_NONE Nenhum valor de quartil.
VIDEO_DURATION_QUARTILE_FIRST Primeiro quartil.
VIDEO_DURATION_QUARTILE_SECOND Segundo quartil (ponto médio).
VIDEO_DURATION_QUARTILE_THIRD Terceiro quartil.
VIDEO_DURATION_QUARTILE_FOURTH Quarto quartil (conclusão).

Métodos

get

Recebe um grupo do Floodlight.

patch

Atualiza um grupo do Floodlight.