Experiment

Es un experimento de Google Ads que les permite a los usuarios experimentar cambios en varias campañas, comparar el rendimiento y aplicar 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 creación en la etapa de configuración antes de comenzar. El sufijo se agregará a los nombres de la campaña experimental y dentro del diseño, de modo que el nombre sea el nombre de la campaña base + 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)

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 establece 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 configura este campo, el experimento finalizará al final de la fecha especificada en la zona horaria del cliente.

Formato: AAAA-MM-DD Ejemplo: 18-04-2019
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 la promoción. Se muestra la operación de larga duración más reciente.
syncEnabled

boolean

Inmutable. Se establece como 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 cuando se crea el experimento.

ExperimentType

Es 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 Es un experimento personalizado que consiste en campañas de video.
DISPLAY_CUSTOM Un experimento personalizado que consiste en campañas de Display
SEARCH_CUSTOM Un experimento personalizado que consiste en campañas de Búsqueda
DISPLAY_AUTOMATED_BIDDING_STRATEGY Un experimento que compara estrategias de ofertas para campañas de Display.
SEARCH_AUTOMATED_BIDDING_STRATEGY Un experimento que compara estrategias de ofertas para campañas de Búsqueda".
SHOPPING_AUTOMATED_BIDDING_STRATEGY Un experimento que compara estrategias de oferta 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 consiste en 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 puede establecerse del estado HABILITADO a través de la API.
PROMOTED El experimento dejará de ser 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 mediante 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, aumenta, disminuye, no cambia.

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

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

Enumeradores
UNSPECIFIED No se especifica.
UNKNOWN El valor es desconocido en esta versión.
NOT_STARTED No comenzó 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.