REST Resource: floodlightGroups

Ressource: FloodlightGroup

Un seul groupe Floodlight

Représentation JSON
{
  "name": string,
  "floodlightGroupId": string,
  "displayName": string,
  "webTagType": enum (WebTagType),
  "lookbackWindow": {
    object (LookbackWindow)
  },
  "customVariables": {
    object
  },
  "activeViewConfig": {
    object (ActiveViewVideoViewabilityMetricConfig)
  }
}
Champs
name

string

Uniquement en sortie. Nom de ressource du groupe Floodlight.

floodlightGroupId

string (int64 format)

Uniquement en sortie. Identifiant unique du groupe Floodlight. Attribué par le système.

displayName

string

Obligatoire. Nom à afficher du groupe Floodlight.

webTagType

enum (WebTagType)

Obligatoire. Type de tag Web activé pour le groupe Floodlight.

lookbackWindow

object (LookbackWindow)

Obligatoire. Période d'analyse du groupe Floodlight. clickDays et impressionDays sont obligatoires. Les valeurs acceptées pour ces deux attributs sont comprises entre 0 et 90, inclus.

customVariables

object (Struct format)

Variables personnalisées définies par l'utilisateur appartenant au groupe Floodlight Les variables Floodlight personnalisées vous permettent de créer des données de rapport adaptées aux besoins spécifiques de votre entreprise. Elles utilisent les clés U1=, U2=, etc., et acceptent toutes les valeurs que vous décidez de leur transférer. Elles vous permettent d'effectuer le suivi de quasiment n'importe quel type de données collectées sur vos clients, comme le genre de film acheté par un client, le pays de livraison de l'article, etc.

Les variables Floodlight personnalisées ne doivent pas être utilisées pour transmettre des données pouvant être utilisées ou reconnues comme des informations permettant d'identifier personnellement l'utilisateur.

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

Les valeurs acceptées pour les clés vont de "U1" à "U100", inclus. Les valeurs de chaîne doivent comporter moins de 64 caractères et ne peuvent pas contenir les caractères suivants: "<>.

activeViewConfig

object (ActiveViewVideoViewabilityMetricConfig)

Configuration de la métrique de visibilité de la vidéo Active View pour le groupe Floodlight.

WebTagType

Types de tags Web possibles pour un groupe Floodlight.

Enums
WEB_TAG_TYPE_UNSPECIFIED La valeur de type n'est pas spécifiée ou est inconnue dans cette version.
WEB_TAG_TYPE_NONE Aucun type de tag.
WEB_TAG_TYPE_IMAGE Tag d'image.
WEB_TAG_TYPE_DYNAMIC Tag dynamique.

LookbackWindow

Indique le nombre de jours écoulés à prendre en compte pour déterminer si une conversion doit être enregistrée ou non.

Représentation JSON
{
  "clickDays": integer,
  "impressionDays": integer
}
Champs
clickDays

integer

Période d'analyse, en jours, à partir du dernier clic d'un utilisateur donné sur l'une de vos annonces.

impressionDays

integer

Période d'analyse, en jours, à partir du moment où un utilisateur donné a vu l'une de vos annonces pour la dernière fois.

ActiveViewVideoViewabilityMetricConfig

Configuration des métriques personnalisées de visibilité des vidéos Active View.

Représentation JSON
{
  "displayName": string,
  "minimumViewability": enum (VideoViewabilityPercent),
  "minimumVolume": enum (VideoVolumePercent),
  "minimumDuration": enum (VideoDurationSeconds),
  "minimumQuartile": enum (VideoDurationQuartile)
}
Champs
displayName

string

Obligatoire. Nom à afficher de la métrique personnalisée.

minimumViewability

enum (VideoViewabilityPercent)

Obligatoire. Pourcentage minimal de pixels de l'annonce vidéo visibles à l'écran pour qu'une impression soit enregistrée.

minimumVolume

enum (VideoVolumePercent)

Obligatoire. Pourcentage minimal du volume de l'annonce vidéo requis pour qu'une impression soit enregistrée.

minimumDuration

enum (VideoDurationSeconds)

Durée minimale de la vidéo visible (en secondes) requise pour qu'une impression soit enregistrée.

Vous devez spécifier minimumDuration, minimumQuartile ou les deux. Si les deux critères sont spécifiés, une impression répond aux critères de la métrique si l'une ou l'autre des conditions est remplie (selon l'événement qui se produit en premier).

minimumQuartile

enum (VideoDurationQuartile)

Durée minimale de la vidéo visible requise, basée sur les quarts de vidéo, pour qu'une impression soit enregistrée.

Vous devez spécifier minimumDuration, minimumQuartile ou les deux. Si les deux critères sont spécifiés, une impression répond aux critères de la métrique si l'une ou l'autre des conditions est remplie (selon l'événement qui se produit en premier).

VideoViewabilityPercent

Valeurs possibles en pourcentage des pixels visibles d'une annonce vidéo.

Enums
VIEWABILITY_PERCENT_UNSPECIFIED La valeur n'est pas spécifiée ou est inconnue dans cette version.
VIEWABILITY_PERCENT_0 Visible à 0 %.
VIEWABILITY_PERCENT_25 Visible à 25 %.
VIEWABILITY_PERCENT_50 Visible à 50 %.
VIEWABILITY_PERCENT_75 Visible à 75 %.
VIEWABILITY_PERCENT_100 Visible à 100 %.

VideoVolumePercent

Valeurs possibles en pourcentage du volume de lecture d'une annonce vidéo.

Enums
VIDEO_VOLUME_PERCENT_UNSPECIFIED La valeur n'est pas spécifiée ou est inconnue dans cette version.
VIDEO_VOLUME_PERCENT_0 Volume à 0 %.
VIDEO_VOLUME_PERCENT_10 10% de volume.

VideoDurationSeconds

Valeurs possibles, en secondes, pour la durée visible d'une annonce vidéo.

Enums
VIDEO_DURATION_UNSPECIFIED La valeur n'est pas spécifiée ou est inconnue dans cette version.
VIDEO_DURATION_SECONDS_NONE Aucune valeur de durée.
VIDEO_DURATION_SECONDS_0 0 seconde.
VIDEO_DURATION_SECONDS_1 1 seconde.
VIDEO_DURATION_SECONDS_2 2 secondes.
VIDEO_DURATION_SECONDS_3 3 secondes.
VIDEO_DURATION_SECONDS_4 4 secondes.
VIDEO_DURATION_SECONDS_5 5 secondes.
VIDEO_DURATION_SECONDS_6 6 secondes.
VIDEO_DURATION_SECONDS_7 7 secondes.
VIDEO_DURATION_SECONDS_8 8 secondes.
VIDEO_DURATION_SECONDS_9 9 secondes.
VIDEO_DURATION_SECONDS_10 10 secondes.
VIDEO_DURATION_SECONDS_11 11 secondes.
VIDEO_DURATION_SECONDS_12 12 secondes.
VIDEO_DURATION_SECONDS_13 13 secondes.
VIDEO_DURATION_SECONDS_14 14 secondes.
VIDEO_DURATION_SECONDS_15 15 secondes.
VIDEO_DURATION_SECONDS_30 30 secondes
VIDEO_DURATION_SECONDS_45 45 secondes.
VIDEO_DURATION_SECONDS_60 60 secondes.

VideoDurationQuartile

Valeurs de quartile possibles pour la durée visible d'une annonce vidéo.

Enums
VIDEO_DURATION_QUARTILE_UNSPECIFIED La valeur n'est pas spécifiée ou est inconnue dans cette version.
VIDEO_DURATION_QUARTILE_NONE Aucune valeur de quartile.
VIDEO_DURATION_QUARTILE_FIRST Premier quart.
VIDEO_DURATION_QUARTILE_SECOND Deuxième quart (moitié).
VIDEO_DURATION_QUARTILE_THIRD Troisième quart.
VIDEO_DURATION_QUARTILE_FOURTH Quatrième quart (achèvement).

Méthodes

get

Récupère un groupe Floodlight.

patch

Met à jour un groupe Floodlight existant.