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. 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.

customVariables

object (Struct format)

Variáveis personalizadas definidas pelo usuário e pertencentes ao grupo do Floodlight. Use variáveis personalizadas do Floodlight para criar dados de relatórios sob medida para suas necessidades comerciais. As variáveis personalizadas do Floodlight usam as chaves U1=, U2= e assim por diante, e podem receber qualquer valor que você escolher transmitir para elas. É possível usá-las para rastrear praticamente qualquer tipo de dado coletado sobre os clientes, como o gênero de filme que o cliente compra, o país para onde o item é enviado etc.

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 tipos possíveis de tags da Web para um grupo do Floodlight.

Enums
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 determinado usuário clicou em um dos seus anúncios.

impressionDays

integer

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

ActiveViewVideoViewabilityMetricConfig

Configuração para métricas personalizadas de visibilidade de vídeos 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 dos 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 de vídeo visível 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 atenderá aos critérios de métrica se um dos requisitos for atendido (o que ocorrer primeiro).

minimumQuartile

enum (VideoDurationQuartile)

É a duração mínima de vídeo visível 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 atenderá aos critérios da métrica se um dos requisitos for atendido (o que acontecer primeiro).

VideoViewabilityPercent

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

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

Enums
VIDEO_VOLUME_PERCENT_UNSPECIFIED O valor não foi especificado ou é desconhecido nesta versão.
VIDEO_VOLUME_PERCENT_0 0% do volume.
VIDEO_VOLUME_PERCENT_10 10% do volume.

VideoDurationSeconds

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

Enums
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 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

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

Enums
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 existente do Floodlight.