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 la 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 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. Grâce aux variables Floodlight personnalisées, vous pouvez créer des rapports contenant exactement les données dont vous avez besoin. Ces variables utilisent les clés U1=, U2=, etc. Elles acceptent toutes les valeurs que vous décidez de leur transmettre. Elles permettent d'effectuer le suivi de la quasi-totalité des types de données collectées sur vos clients, comme le genre de films achetés, le pays de livraison de l'article, etc.

Les variables Floodlight personnalisées ne doivent 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 "U1" à "U100", inclus. Les valeurs de chaîne doivent comporter moins de 64 caractères et ne pas contenir les caractères suivants : "<>.

activeViewConfig

object (ActiveViewVideoViewabilityMetricConfig)

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

WebTagType

Types de balises Web possibles 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 balise.
WEB_TAG_TYPE_IMAGE Balise 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, 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 internaute a vu l'une de vos annonces.

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

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

minimumQuartile

enum (VideoDurationQuartile)

Durée minimale de visibilité de la vidéo 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 vous spécifiez les deux, une impression remplit les 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 pour les 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 25 % visible.
VIEWABILITY_PERCENT_50 50 % visible.
VIEWABILITY_PERCENT_75 75 % visible.
VIEWABILITY_PERCENT_100 100% visible.

VideoVolumePercent

Valeurs de pourcentage possibles pour le 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 0% du volume.
VIDEO_VOLUME_PERCENT_10 Volume à 10 %.

VideoDurationSeconds

Valeurs possibles de la durée visible d'une annonce vidéo (en secondes).

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 secondes.
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 possibles des quartiles de 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 quart.
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 quartile (finalisation).

Méthodes

get

Récupère un groupe Floodlight.

patch

Met à jour un groupe Floodlight existant.