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 balise 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 les deux sont comprises entre 0 et 90 inclus.

customVariables

object (Struct format)

Variables personnalisées définies par l'utilisateur appartenant au groupe Floodlight. Utilisez des variables Floodlight personnalisées pour créer des données de rapport adaptées aux besoins spécifiques de votre entreprise. Les variables Floodlight personnalisées utilisent les clés U1=, U2=, etc. Elles acceptent toutes les valeurs que vous décidez de leur transférer. Elles vous permettent d'effectuer le suivi de pratiquement n'importe quel type de données que vous collectez concernant vos clients (par exemple, le genre de films qu'ils achètent, le pays vers lequel l'article est expédié, etc.).

Les variables Floodlight personnalisées ne peuvent pas être utilisées pour transmettre des données qui pourraient ê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 sont comprises entre "U1" et "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é des vidéos Active View pour le groupe Floodlight.

WebTagType

Types possibles de balises Web pour un groupe Floodlight.

Enums
WEB_TAG_TYPE_UNSPECIFIED La valeur du 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 Balise dynamique.

LookbackWindow

Indique le nombre de jours déjà é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, depuis la dernière fois qu'un internaute a cliqué sur l'une de vos annonces.

impressionDays

integer

Période d'analyse, en jours, depuis la dernière fois qu'un utilisateur a vu l'une de vos annonces.

ActiveViewVideoViewabilityMetricConfig

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

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 devant être 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 de visibilité minimale requise de la vidéo (en secondes) pour qu'une impression soit enregistrée.

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

minimumQuartile

enum (VideoDurationQuartile)

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

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

VideoViewabilityPercent

Valeurs de pourcentage possibles 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 0% visible.
VIEWABILITY_PERCENT_25 Visible à 25 %.
VIEWABILITY_PERCENT_50 50% visible.
VIEWABILITY_PERCENT_75 75% visible.
VIEWABILITY_PERCENT_100 100% visible.

VideoVolumePercent

Valeurs de pourcentage possibles 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 Volume à 10 %.

VideoDurationSeconds

Valeurs possibles en secondes de la durée de visibilité 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 de visibilité 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 quartile (moitié).
VIDEO_DURATION_QUARTILE_THIRD Troisième quart.
VIDEO_DURATION_QUARTILE_FOURTH Quatrième quart (lecture complète).

Méthodes

get

Récupère un groupe Floodlight.

patch

Met à jour un groupe Floodlight existant.