Experiment

Un experimento de Google Ads para que los usuarios realicen cambios en varias campañas, comparen el rendimiento y apliquen los cambios efectivos

Representación 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
}
Campos
resourceName

string

Inmutable. Es el nombre del recurso del experimento. Los nombres de los recursos del experimento tienen el siguiente formato:

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

string

Obligatorio. Es el nombre del experimento. Debe tener una longitud mínima de 1 y una máxima de 1,024. Debe ser único para cada cliente.
description

string

Es la descripción del experimento. Debe tener una longitud mínima de 1 y una máxima de 2,048.
suffix

string

En el caso de los experimentos administrados por el sistema, el anunciante debe proporcionar un sufijo durante la construcción, en la etapa de configuración, antes de pasar a la etapa iniciada. El sufijo se agregará a los nombres de las campañas en fase de diseño y experimental, de modo que el nombre sea el nombre de la campaña de base y el sufijo.
type

enum (ExperimentType)

Obligatorio. Es el producto o la función que usa este experimento.
status

enum (ExperimentStatus)

Es el estado que eligió el anunciante para este experimento.
goals[]

object (MetricGoal)

Los objetivos de este experimento.
promoteStatus

enum (AsyncActionStatus)

Solo salida. Es el estado del proceso de promoción del experimento.
experimentId

string (int64 format)

Solo salida. Es el ID del experimento. Solo lectura.
startDate

string

Fecha en la que comienza el experimento. De forma predeterminada, el experimento comienza ahora o en la fecha de inicio de la campaña, lo que ocurra más tarde. Si se configura este campo, el experimento comenzará al comienzo de la fecha especificada en la zona horaria del cliente.

Formato: AAAA-MM-DD Ejemplo: 2019-03-14
endDate

string

Fecha en la que finaliza el experimento. De forma predeterminada, el experimento finaliza en la fecha de finalización de la campaña. Si se establece este campo, el experimento finalizará al final de la fecha especificada en la zona horaria del cliente.

Formato: AAAA-MM-DD Ejemplo: 2019-04-18
longRunningOperation

string

Solo salida. El nombre del recurso de la operación de larga duración que se puede usar para sondear la finalización del programa del experimento o promoverlo. Se muestra la operación de larga duración más reciente.
syncEnabled

boolean

Inmutable. Se establece en verdadero si los cambios en las campañas de base deben sincronizarse con las campañas de prueba. Se conservarán los cambios realizados directamente en las campañas de prueba. Este campo solo se puede configurar durante la creación del experimento.

ExperimentType

Es el tipo de experimento.

Enumeraciones
UNSPECIFIED No se especifica.
UNKNOWN El valor es desconocido en esta versión.
DISPLAY_AND_VIDEO_360 Este es un experimento de DISPLAY_AND_VIDEO_360.
AD_VARIATION Este es un experimento de variaciones del anuncio.
YOUTUBE_CUSTOM Un experimento personalizado compuesto por campañas de video.
DISPLAY_CUSTOM Un experimento personalizado que incluye campañas de Display.
SEARCH_CUSTOM Un experimento personalizado que consta de campañas de Búsqueda.
DISPLAY_AUTOMATED_BIDDING_STRATEGY Un experimento que compara las estrategias de ofertas para las campañas de Display.
SEARCH_AUTOMATED_BIDDING_STRATEGY Un experimento que compara las estrategias de ofertas para las campañas de Búsqueda".
SHOPPING_AUTOMATED_BIDDING_STRATEGY Un experimento que compara las estrategias de ofertas para las campañas de Shopping.
SMART_MATCHING OBSOLETO. Un experimento de concordancia inteligente con campañas de Búsqueda.
HOTEL_CUSTOM Un experimento personalizado que incluye campañas de hoteles.

ExperimentStatus

Es el estado del experimento.

Enumeraciones
UNSPECIFIED No se especifica.
UNKNOWN El valor es desconocido en esta versión.
ENABLED El experimento está habilitado.
REMOVED Se quitó el experimento.
HALTED Se detuvo el experimento. Este estado se puede establecer desde el estado HABILITADO a través de la API.
PROMOTED El experimento saldrá del estado experimental.
SETUP Estado inicial del experimento.
INITIATED Las campañas del experimento están pendientes de materialización. Este estado se puede establecer desde el estado CONFIGURACIÓN a través de la API.
GRADUATED Se actualizó el experimento.

MetricGoal

Es un objetivo de métrica para un experimento.

Representación JSON 
{
  "metric": enum (ExperimentMetric),
  "direction": enum (ExperimentMetricDirection)
}
Campos
metric

enum (ExperimentMetric)

Es la métrica del objetivo. Por ejemplo, clics, impresiones, costo, conversiones, etcétera.
direction

enum (ExperimentMetricDirection)

Es la dirección de la métrica del objetivo. Por ejemplo, aumento, disminución, sin cambios.

ExperimentMetric

Es el tipo de métrica del experimento.

Enumeraciones
UNSPECIFIED No se especifica.
UNKNOWN El valor es desconocido en esta versión.
CLICKS El objetivo del experimento son los clics.
IMPRESSIONS El objetivo del experimento son las impresiones.
COST El objetivo del experimento es el costo.
CONVERSIONS_PER_INTERACTION_RATE El objetivo del experimento es el porcentaje de conversiones.
COST_PER_CONVERSION El objetivo del experimento es el costo por conversión.
CONVERSIONS_VALUE_PER_COST El objetivo del experimento es el valor de conversión por costo.
AVERAGE_CPC El objetivo del experimento es el CPC prom.
CTR El objetivo del experimento es ctr.
INCREMENTAL_CONVERSIONS El objetivo del experimento son las conversiones incrementales.
COMPLETED_VIDEO_VIEWS El objetivo del experimento son las vistas de video completadas.
CUSTOM_ALGORITHMS El objetivo del experimento son los algoritmos personalizados.
CONVERSIONS El objetivo del experimento son las conversiones.
CONVERSION_VALUE El objetivo del experimento es el valor de conversión.

ExperimentMetricDirection

Es el tipo de dirección de la métrica del experimento.

Enumeraciones
UNSPECIFIED No se especifica.
UNKNOWN El valor es desconocido en esta versión.
NO_CHANGE El objetivo del experimento es no cambiar la métrica.
INCREASE El objetivo del experimento es increar la métrica.
DECREASE El objetivo del experimento es disminuir la métrica.
NO_CHANGE_OR_INCREASE El objetivo del experimento es no cambiar ni aumentar la métrica.
NO_CHANGE_OR_DECREASE El objetivo del experimento es no cambiar ni disminuir la métrica.

AsyncActionStatus

Es el estado de acción asíncrona del experimento.

Enumeraciones
UNSPECIFIED No se especifica.
UNKNOWN El valor es desconocido en esta versión.
NOT_STARTED No se inició la acción.
IN_PROGRESS La acción está en curso.
COMPLETED La acción se completó correctamente.
FAILED No se pudo realizar la acción.
COMPLETED_WITH_WARNING La acción se completó correctamente con advertencias.