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. Les champs clickDays et impressionDays sont tous les deux obligatoires. Les valeurs autorisées pour ces deux valeurs vont de 0 à 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 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. Ils vous permettent d'effectuer le suivi de quasiment n'importe quel type de données recueillies 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 autorisées pour les clés sont "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 tags Web disponibles 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 Tag dynamique.

LookbackWindow

Spécifie 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 de la dernière fois qu'un utilisateur a cliqué sur l'une de vos annonces.

impressionDays

integer

Période d'analyse, en jours, à partir de la dernière fois qu'un utilisateur donné 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 la vidéo visible (en secondes) nécessaire 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 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 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 Visible à 0 %
VIEWABILITY_PERCENT_25 Visible à 25 %
VIEWABILITY_PERCENT_50 50% visible.
VIEWABILITY_PERCENT_75 Visible à 75 %
VIEWABILITY_PERCENT_100 100% visibles.

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

VideoDurationSeconds

Valeurs possibles, en secondes, pour 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 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 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.