REST Resource: floodlightGroups

Risorsa: FloodlightGroup

Un singolo gruppo Floodlight.

Rappresentazione JSON
{
  "name": string,
  "floodlightGroupId": string,
  "displayName": string,
  "webTagType": enum (WebTagType),
  "lookbackWindow": {
    object (LookbackWindow)
  },
  "customVariables": {
    object
  },
  "activeViewConfig": {
    object (ActiveViewVideoViewabilityMetricConfig)
  }
}
Campi
name

string

Solo output. Il nome della risorsa del gruppo Floodlight.

floodlightGroupId

string (int64 format)

Solo output. L'ID univoco del gruppo Floodlight. Assegnato dal sistema.

displayName

string

obbligatorio. Il nome visualizzato del gruppo Floodlight.

webTagType

enum (WebTagType)

obbligatorio. Il tipo di tag web attivato per il gruppo Floodlight.

lookbackWindow

object (LookbackWindow)

obbligatorio. La finestra temporale per il gruppo Floodlight. Sono necessari sia clickDays che impressionDays. I valori accettati per entrambi sono compresi tra 0 e 90.

customVariables

object (Struct format)

Variabili personalizzate definite dall'utente di proprietà del gruppo Floodlight. Utilizza le variabili Floodlight personalizzate per creare dati dei report su misura per le esigenze uniche della tua attività. Le variabili Floodlight personalizzate utilizzano le chiavi U1=, U2= e così via e possono assumere qualsiasi valore che decidi di trasmettere. Puoi utilizzarli per monitorare praticamente qualsiasi tipo di dati che raccogli sui tuoi clienti, ad esempio il genere di film che un cliente acquista, il paese in cui viene spedito l'articolo e così via.

Le variabili Floodlight personalizzate non possono essere utilizzate per trasmettere dati che potrebbero essere utilizzati o riconosciuti come informazioni che consentono l'identificazione personale (PII).

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

I valori accettati per le chiavi sono da "U1" a "U100", inclusi. I valori stringa non devono superare i 64 caratteri e non possono contenere i seguenti caratteri: "<>.

activeViewConfig

object (ActiveViewVideoViewabilityMetricConfig)

La configurazione della metrica Visibilità video di Visualizzazione attiva per il gruppo Floodlight.

WebTagType

I possibili tipi di tag web per un gruppo Floodlight.

Enum
WEB_TAG_TYPE_UNSPECIFIED Il valore del tipo non è specificato o è sconosciuto in questa versione.
WEB_TAG_TYPE_NONE Nessun tipo di tag.
WEB_TAG_TYPE_IMAGE Tag immagine.
WEB_TAG_TYPE_DYNAMIC Tag dinamico.

LookbackWindow

Consente di specificare quanti giorni nel passato considerare per determinare se registrare o meno una conversione.

Rappresentazione JSON
{
  "clickDays": integer,
  "impressionDays": integer
}
Campi
clickDays

integer

Finestra temporale, in giorni, dall'ultima volta in cui un determinato utente ha fatto clic su uno dei tuoi annunci.

impressionDays

integer

Finestra temporale, in giorni, dall'ultima volta in cui un determinato utente ha visualizzato un annuncio.

ActiveViewVideoViewabilityMetricConfig

Configurazione per le metriche personalizzate di Visibilità video di Visualizzazione attiva.

Rappresentazione JSON
{
  "displayName": string,
  "minimumViewability": enum (VideoViewabilityPercent),
  "minimumVolume": enum (VideoVolumePercent),
  "minimumDuration": enum (VideoDurationSeconds),
  "minimumQuartile": enum (VideoDurationQuartile)
}
Campi
displayName

string

obbligatorio. Il nome visualizzato della metrica personalizzata.

minimumViewability

enum (VideoViewabilityPercent)

obbligatorio. La percentuale minima dei pixel dell'annuncio video visibili sullo schermo affinché venga registrata un'impressione.

minimumVolume

enum (VideoVolumePercent)

obbligatorio. La percentuale minima del volume dell'annuncio video necessaria per la registrazione di un'impressione.

minimumDuration

enum (VideoDurationSeconds)

La durata minima del video visibile richiesta (in secondi) affinché un'impressione venga registrata.

Devi specificare minimumDuration, minimumQuartile o entrambi. Se vengono specificati entrambi, un'impressione soddisfa i criteri della metrica se viene soddisfatto uno dei due requisiti (a seconda di quale condizione si verifica per prima).

minimumQuartile

enum (VideoDurationQuartile)

La durata minima del video visibile richiesta, in base ai quartili video, affinché un'impressione venga registrata.

Devi specificare minimumDuration, minimumQuartile o entrambi. Se vengono specificati entrambi, un'impressione soddisfa i criteri della metrica se viene soddisfatto uno dei due requisiti (a seconda di quale condizione si verifica per prima).

VideoViewabilityPercent

Possibili valori percentuali dei pixel visibili di un annuncio video.

Enum
VIEWABILITY_PERCENT_UNSPECIFIED Valore non specificato o sconosciuto in questa versione.
VIEWABILITY_PERCENT_0 0% visibile.
VIEWABILITY_PERCENT_25 25% visibile.
VIEWABILITY_PERCENT_50 50% visibile.
VIEWABILITY_PERCENT_75 75% visibile.
VIEWABILITY_PERCENT_100 100% visibile.

VideoVolumePercent

Possibili valori percentuali del volume di riproduzione di un annuncio video.

Enum
VIDEO_VOLUME_PERCENT_UNSPECIFIED Valore non specificato o sconosciuto in questa versione.
VIDEO_VOLUME_PERCENT_0 0% di volume.
VIDEO_VOLUME_PERCENT_10 10% di volume.

VideoDurationSeconds

I valori possibili in secondi della durata visibile di un annuncio video.

Enum
VIDEO_DURATION_UNSPECIFIED Valore non specificato o sconosciuto in questa versione.
VIDEO_DURATION_SECONDS_NONE Nessun valore relativo alla durata.
VIDEO_DURATION_SECONDS_0 0 secondi.
VIDEO_DURATION_SECONDS_1 1 secondo.
VIDEO_DURATION_SECONDS_2 2 secondi.
VIDEO_DURATION_SECONDS_3 3 secondi.
VIDEO_DURATION_SECONDS_4 4 secondi.
VIDEO_DURATION_SECONDS_5 5 secondi.
VIDEO_DURATION_SECONDS_6 6 secondi.
VIDEO_DURATION_SECONDS_7 7 secondi.
VIDEO_DURATION_SECONDS_8 8 secondi.
VIDEO_DURATION_SECONDS_9 9 secondi.
VIDEO_DURATION_SECONDS_10 10 secondi.
VIDEO_DURATION_SECONDS_11 11 secondi.
VIDEO_DURATION_SECONDS_12 12 secondi.
VIDEO_DURATION_SECONDS_13 13 secondi.
VIDEO_DURATION_SECONDS_14 14 secondi.
VIDEO_DURATION_SECONDS_15 15 secondi.
VIDEO_DURATION_SECONDS_30 30 secondi.
VIDEO_DURATION_SECONDS_45 45 secondi.
VIDEO_DURATION_SECONDS_60 60 secondi.

VideoDurationQuartile

Possibili valori di quartile della durata visibile di un annuncio video.

Enum
VIDEO_DURATION_QUARTILE_UNSPECIFIED Valore non specificato o sconosciuto in questa versione.
VIDEO_DURATION_QUARTILE_NONE Nessun valore di quartile.
VIDEO_DURATION_QUARTILE_FIRST Primo quartile.
VIDEO_DURATION_QUARTILE_SECOND Secondo quartile (punto intermedio).
VIDEO_DURATION_QUARTILE_THIRD Terzo quartile.
VIDEO_DURATION_QUARTILE_FOURTH Quarto quartile (completamento).

Metodi

get

Recupera un gruppo Floodlight.

patch

Aggiorna un gruppo Floodlight esistente.