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 abilitato per il gruppo Floodlight.

lookbackWindow

object (LookbackWindow)

Obbligatorio. La finestra temporale per il gruppo Floodlight. È obbligatorio specificare clickDays e impressionDays. I valori accettabili 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 adatti alle 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 utilizzarle per monitorare praticamente qualsiasi tipo di dati raccolti sui tuoi clienti, ad esempio il genere di film che un cliente acquista, il paese in cui il prodotto viene spedito 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 accettabili per le chiavi vanno da "U1" a "U100", inclusi. I valori di stringa devono avere una lunghezza inferiore a 64 caratteri e non possono contenere i seguenti caratteri: "<>.

activeViewConfig

object (ActiveViewVideoViewabilityMetricConfig)

La configurazione della metrica di 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 stabilire se registrare o meno una conversione.

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

integer

La 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 uno dei tuoi annunci.

ActiveViewVideoViewabilityMetricConfig

Configurazione delle 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 registrare un'impressione.

minimumDuration

enum (VideoDurationSeconds)

La durata minima visibile del video richiesta (in secondi) per la registrazione di un'impressione.

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

minimumQuartile

enum (VideoDurationQuartile)

La durata minima del video visibile richiesta, in base ai quartili video, per registrare un'impressione.

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

VideoViewabilityPercent

Possibili valori percentuali dei pixel visibili di un annuncio video.

Enum
VIEWABILITY_PERCENT_UNSPECIFIED Il valore non è specificato o è sconosciuto in questa versione.
VIEWABILITY_PERCENT_0 0% di visibilità.
VIEWABILITY_PERCENT_25 Visibilità del 25%.
VIEWABILITY_PERCENT_50 Visibile 50%.
VIEWABILITY_PERCENT_75 Visibilità del 75%.
VIEWABILITY_PERCENT_100 Visibilità del 100%.

VideoVolumePercent

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

Enum
VIDEO_VOLUME_PERCENT_UNSPECIFIED Il valore non è specificato o è sconosciuto in questa versione.
VIDEO_VOLUME_PERCENT_0 Volume al 0%.
VIDEO_VOLUME_PERCENT_10 Volume al 10%.

VideoDurationSeconds

Valori possibili in secondi della durata visibile di un annuncio video.

Enum
VIDEO_DURATION_UNSPECIFIED Il valore non è specificato o è sconosciuto in questa versione.
VIDEO_DURATION_SECONDS_NONE Nessun valore di 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 del quartile della durata visibile di un annuncio video.

Enum
VIDEO_DURATION_QUARTILE_UNSPECIFIED Il valore non è specificato o è sconosciuto in questa versione.
VIDEO_DURATION_QUARTILE_NONE Nessun valore 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.