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. Sia clickDays che impressionDays sono obbligatori. I valori accettabili per entrambi sono da 0 a 90 inclusi.

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 specifiche 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 tracciare praticamente qualsiasi tipo di dati raccolti sui clienti, come 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 sono da "U1" a "U100", inclusi. I valori stringa devono contenere meno di 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 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 degli 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 relative alla 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 richiesta per la registrazione di un'impressione.

minimumDuration

enum (VideoDurationSeconds)

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

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 dell'evento che si verifica per primo).

minimumQuartile

enum (VideoDurationQuartile)

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

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 dell'evento che si verifica per primo).

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 Visibile al 100%.

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% del volume.
VIDEO_VOLUME_PERCENT_10 volume al 10%.

VideoDurationSeconds

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 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 di quartili 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

Consente di aggiornare un gruppo Floodlight esistente.