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. Les champs clickDays et impressionDays sont tous les deux obligatoires. Les valeurs autorisées pour ces deux types de valeurs sont comprises entre 0 et 90 inclus.

customVariables

object (Struct format)

Variables personnalisées définies par l'utilisateur appartenant au groupe Floodlight Utilisez les variables Floodlight personnalisées pour créer des données de rapport adaptées aux besoins uniques 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 recueillies sur vos clients, comme le genre de films qu'un client achète, 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 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é des vidéos Active View pour le groupe Floodlight.

WebTagType

Types de balises 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 balise.
WEB_TAG_TYPE_IMAGE Tag d'image.
WEB_TAG_TYPE_DYNAMIC Tag 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 le dernier clic d'un utilisateur donné sur l'une de vos annonces.

impressionDays

integer

Période d'analyse, en jours, depuis la dernière impression de l'une de vos annonces par un utilisateur donné.

ActiveViewVideoViewabilityMetricConfig

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

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 conditions sont spécifiées, une impression répond aux critères de la métrique si l'une des conditions est remplie (selon la situation qui se produit en premier).

minimumQuartile

enum (VideoDurationQuartile)

Durée minimale de la vidéo visible, 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 conditions sont spécifiées, une impression répond aux critères de la métrique si l'une des conditions est remplie (selon la situation 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 100% visible.

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 0% du volume.
VIDEO_VOLUME_PERCENT_10 10% du volume.

VideoDurationSeconds

Valeurs possibles, en secondes, de 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 quartile (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.