Experiment

Un experimento de Google Ads para que los usuarios experimenten 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
}
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 longitud 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 longitud 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 creación, en la etapa de configuración, antes de pasar a la etapa inicial. El sufijo se agregará a los nombres de las campañas experimentales y en el diseño para que sean el nombre de la campaña base y el sufijo.
type

enum (ExperimentType)

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

enum (ExperimentStatus)

Es el estado elegido por el anunciante de este experimento.
goals[]

object (MetricGoal)

Son 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 después. Si se configura este campo, el experimento comenzará al principio 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 de la programación del experimento o su promoción. Se muestra la operación de larga duración más reciente.

ExperimentType

Indica el tipo de experimento.

Enumeradores
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 que consta de campañas de video
DISPLAY_CUSTOM Un experimento personalizado que consiste en 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 de las campañas de Display.
SEARCH_AUTOMATED_BIDDING_STRATEGY Un experimento que compara estrategias de ofertas para las campañas de Búsqueda".
SHOPPING_AUTOMATED_BIDDING_STRATEGY Un experimento que compara estrategias de ofertas de 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 consta de campañas de hoteles

ExperimentStatus

Es el estado del experimento.

Enumeradores
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 HABILITADO mediante la API.
PROMOTED El experimento dejará de estar en 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 SETUP a través de la API.
GRADUATED Se modificó el experimento.

MetricGoal

Es un objetivo métrico 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.

Enumeradores
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 el CTR.
INCREMENTAL_CONVERSIONS El objetivo del experimento son las conversiones incrementales.
COMPLETED_VIDEO_VIEWS El objetivo del experimento es completar las vistas de video.
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

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

Enumeradores
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 crear 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 la acción asíncrona del experimento.

Enumeradores
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.