Attention:Vous consultez la documentation de l'interface REST de l'API. La plupart de nos bibliothèques clientes officielles utilisent gRPC. Pour en savoir plus, consultez la présentation de REST.

Cette page a été traduite par l'API Cloud Translation.

Experiment

Représentation JSON
ExperimentType
ExperimentStatus
MetricGoal
- Représentation JSON
ExperimentMetric
ExperimentMetricDirection
AsyncActionStatus

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

Représentation JSON

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 }

{
  "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
}

Champs
`resourceName`	`string` Immuable. Nom de ressource du test. Les noms des ressources de test se présentent sous la forme suivante: `customers/{customerId}/experiments/{experimentId}`
`name`	`string` Obligatoire. Nom du test. Il doit avoir une longueur minimale de 1 et une longueur maximale de 1 024. Elle doit être unique pour chaque client.
`description`	`string` Description du test. Sa longueur doit être comprise 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 à l'état "En cours". Le suffixe sera ajouté aux noms des campagnes intégrées à la conception et du test, de sorte qu'il corresponde au nom de la campagne de base suivi du suffixe.
`type`	`enum (ExperimentType)` Obligatoire. Produit/fonctionnalité qui utilise ce test.
`status`	`enum (ExperimentStatus)` État choisi par l'annonceur pour ce test.
`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 fin de 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. Ce nom peut être utilisé pour vérifier si le test est terminé ou pour le promouvoir. L'opération de longue durée la plus récente est renvoyée.

ExperimentType

Type de test.

Enums
`UNSPECIFIED`	Non spécifié.
`UNKNOWN`	La valeur est inconnue dans cette version.
`DISPLAY_AND_VIDEO_360`	Ceci est un test DISPLAY_AND_VIDEO_360.
`AD_VARIATION`	Il s'agit d'un test de variante d'annonce.
`YOUTUBE_CUSTOM`	Test personnalisé constitué de campagnes vidéo.
`DISPLAY_CUSTOM`	Test personnalisé constitué de campagnes display.
`SEARCH_CUSTOM`	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 des campagnes display.
`SEARCH_AUTOMATED_BIDDING_STRATEGY`	Un test qui compare les stratégies d'enchères des 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 fonctionnalité Smart Matching avec les campagnes sur le Réseau de Recherche
`HOTEL_CUSTOM`	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 l'état ACTIVÉ via l'API.
`PROMOTED`	Le test n'est plus considéré comme expérimental.
`SETUP`	État initial du test.
`INITIATED`	Les campagnes du test sont en attente de matérialisation. Cet état peut être défini depuis l'état "CONFIGURATION" via l'API.
`GRADUATED`	Le test a été validé.

MetricGoal

Objectif de métrique pour un test.

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

Champs

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.

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 de générer des conversions incrémentielles.
`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 le nombre de 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 d'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`	Action en cours.
`COMPLETED`	L'action a bien été effectuée.
`FAILED`	Échec de l'action.
`COMPLETED_WITH_WARNING`	L'action a bien été effectuée, mais des avertissements ont été générés.