Experiment

Un test Google Ads permettant aux utilisateurs de tester les modifications dans plusieurs campagnes, de comparer leurs performances et d'appliquer les modifications effectives

Représentation JSON 
{
  "resourceName": string,
  "name": string,
  "description": string,
  "suffix": string,
  "type": enum (ExperimentType),
  "status": enum (ExperimentStatus),
  "goals": [
    {
      object (MetricGoal)
    }
  ],
  "promoteStatus": enum (AsyncActionStatus),
  "experimentId": string,
  "startDate": string,
  "endDate": string,
  "longRunningOperation": string,
  "syncEnabled": boolean
}
Champs
resourceName

string

Immuable. Nom de ressource du test. Les noms des ressources de test se présentent comme suit:

customers/{customerId}/experiments/{experimentId}
name

string

Obligatoire. Nom du test. Il doit comporter entre 1 et 1 024 caractères. Il doit être unique pour un client.
description

string

Description du test. Il doit comporter entre 1 et 2 048 caractères.
suffix

string

Pour les tests gérés par le système, l'annonceur doit fournir un suffixe lors de la construction, lors de la phase de configuration, avant de passer à "En cours". Le suffixe sera ajouté aux noms des campagnes intégrées et tests de façon à correspondre au nom de la campagne de base suivi du suffixe.
type

enum (ExperimentType)

Obligatoire. Produit/fonctionnalité qui utilise ce test.
status

enum (ExperimentStatus)

État de ce test choisi par l'annonceur.
goals[]

object (MetricGoal)

Objectifs de ce test
promoteStatus

enum (AsyncActionStatus)

Uniquement en sortie. État du processus de promotion du test.
experimentId

string (int64 format)

Uniquement en sortie. ID du test. Lecture seule.
startDate

string

Date de début du test. Par défaut, le test commence maintenant ou à la date de début de la campagne (la date la plus tardive étant retenue). Si ce champ est défini, le test commence au début de la date spécifiée dans le fuseau horaire du client.

Format : AAAA-MM-JJ, exemple : 2019-03-14
endDate

string

Date de fin du test. Par défaut, le test se termine à la date de fin de la campagne. Si ce champ est défini, le test se termine à la date spécifiée dans le fuseau horaire du client.

Format: AAAA-MM-JJ. Exemple: 2019-04-18
longRunningOperation

string

Uniquement en sortie. Nom de ressource de l'opération de longue durée qui peut être utilisé pour interroger l'achèvement de la planification du test ou de sa promotion. L'opération de longue durée la plus récente est renvoyée.
syncEnabled

boolean

Immuable. Définissez la valeur sur "true" si les modifications apportées aux campagnes de base doivent être synchronisées avec les campagnes tests. Les modifications apportées directement aux campagnes tests seront conservées. Vous ne pouvez définir ce champ que lors de la création du test.

ExperimentType

Type de test.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN La valeur est inconnue dans cette version.
DISPLAY_AND_VIDEO_360 Il s'agit d'un test DISPLAY_AND_VIDEO_360.
AD_VARIATION Il s'agit d'un test de variante d'annonce.
YOUTUBE_CUSTOM Il s'agit d'un test personnalisé constitué de campagnes vidéo.
DISPLAY_CUSTOM Il s'agit d'un test personnalisé constitué de campagnes display.
SEARCH_CUSTOM Il s'agit d'un test personnalisé constitué de campagnes sur le Réseau de Recherche.
DISPLAY_AUTOMATED_BIDDING_STRATEGY Il s'agit d'un test qui compare les stratégies d'enchères pour les campagnes display.
SEARCH_AUTOMATED_BIDDING_STRATEGY Un test qui compare les stratégies d'enchères pour les campagnes sur le Réseau de Recherche."
SHOPPING_AUTOMATED_BIDDING_STRATEGY Il s'agit d'un test qui compare les stratégies d'enchères des campagnes Shopping.
SMART_MATCHING OBSOLÈTE. Test de la mise en correspondance intelligente avec les campagnes sur le Réseau de Recherche
HOTEL_CUSTOM Il s'agit d'un test personnalisé constitué de campagnes d'hôtel.

ExperimentStatus

État du test.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN La valeur est inconnue dans cette version.
ENABLED Le test est activé.
REMOVED Le test a été supprimé.
HALTED Le test a été interrompu. Cet état peut passer de ACTIVÉ à l'API.
PROMOTED Le test ne sera plus au stade expérimental.
SETUP État initial du test.
INITIATED Les campagnes du test sont en attente de matérialisation. Cet état peut être défini à partir de l'état CONFIGURATION via l'API.
GRADUATED Le test a été associé à un niveau supérieur.

MetricGoal

Objectif de métrique pour un test.

Représentation JSON 
{
  "metric": enum (ExperimentMetric),
  "direction": enum (ExperimentMetricDirection)
}
Champs
metric

enum (ExperimentMetric)

Métrique de l'objectif. Par exemple, les clics, les impressions, le coût, les conversions, etc.
direction

enum (ExperimentMetricDirection)

Sens de la métrique de l'objectif. Par exemple : augmenter, diminuer, pas de changement.

ExperimentMetric

Type de métrique de test.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN La valeur est inconnue dans cette version.
CLICKS L'objectif du test est le nombre de clics.
IMPRESSIONS L'objectif du test est d'enregistrer des impressions.
COST L'objectif du test est le coût.
CONVERSIONS_PER_INTERACTION_RATE L'objectif du test est le taux de conversion.
COST_PER_CONVERSION L'objectif du test est le coût par conversion.
CONVERSIONS_VALUE_PER_COST L'objectif du test est le rapport valeur/coût de conversion.
AVERAGE_CPC L'objectif du test est le CPC moy.
CTR L'objectif du test est le CTR.
INCREMENTAL_CONVERSIONS L'objectif du test est d'augmenter le nombre de conversions.
COMPLETED_VIDEO_VIEWS L'objectif du test est de visionner des vidéos complètes.
CUSTOM_ALGORITHMS L'objectif du test est la création d'algorithmes personnalisés.
CONVERSIONS L'objectif du test est de générer des conversions.
CONVERSION_VALUE L'objectif du test est la valeur de conversion.

ExperimentMetricDirection

Type d'orientation des métriques de test.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN La valeur est inconnue dans cette version.
NO_CHANGE L'objectif du test n'est pas de modifier la métrique.
INCREASE L'objectif du test est d'incréer la métrique.
DECREASE L'objectif du test est de réduire la métrique.
NO_CHANGE_OR_INCREASE L'objectif du test est de ne pas modifier ni augmenter la métrique.
NO_CHANGE_OR_DECREASE L'objectif du test est de ne pas modifier ni diminuer la métrique.

AsyncActionStatus

État de l'action asynchrone du test.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN La valeur est inconnue dans cette version.
NOT_STARTED L'action n'a pas démarré.
IN_PROGRESS L'action est en cours.
COMPLETED L'action a bien été effectuée.
FAILED Échec de l'action.
COMPLETED_WITH_WARNING L'action s'est terminée avec succès, avec des avertissements.