Experimentos

La colección experiments es un conjunto de recursos experiment y cada uno describe un experimento de contenido disponible para un usuario autenticado.

Al final de esta página encontrarás la lista de los métodos que se utilizan para este recurso.

Representaciones de recurso

Plantilla JSON para recurso de experimento de Analytics.

{
  "id": string,
  "kind": "analytics#experiment",
  "selfLink": string,
  "accountId": string,
  "webPropertyId": string,
  "internalWebPropertyId": string,
  "profileId": string,
  "name": string,
  "description": string,
  "created": datetime,
  "updated": datetime,
  "objectiveMetric": string,
  "optimizationType": string,
  "status": string,
  "winnerFound": boolean,
  "startTime": datetime,
  "endTime": datetime,
  "reasonExperimentEnded": string,
  "rewriteVariationUrlsAsOriginal": boolean,
  "winnerConfidenceLevel": double,
  "minimumExperimentLengthInDays": integer,
  "trafficCoverage": double,
  "equalWeighting": boolean,
  "snippet": string,
  "variations": [
    {
      "name": string,
      "url": string,
      "status": string,
      "weight": double,
      "won": boolean
    }
  ],
  "servingFramework": string,
  "editableInGaUi": boolean,
  "parentLink": {
    "type": "analytics#profile",
    "href": string
  }
}
Nombre de propiedad Valor Descripción Notas
accountId string ID de cuenta al que pertenece este experimento. Este campo es de solo lectura.
created datetime Hora a la que se creó el experimento. Este campo es de solo lectura.
description string Notas sobre este experimento. editable
editableInGaUi boolean Si el valor es true, el usuario final podrá modificar el experimento mediante la interfaz de usuario de Google Analytics. editable
endTime datetime Hora de finalización del experimento (el estado de tiempo se ha cambiado de RUNNING a ENDED). Este campo solo se encuentra si el experimento ha finalizado. Este campo es de solo lectura.
equalWeighting boolean Campo booleano que especifica si el tráfico se distribuirá uniformemente en todas las variaciones. Si el valor es false, los experimentos de contenido siguen el comportamiento predeterminado de ajustar el tráfico dinámicamente según el rendimiento de las variaciones. Opcional; el valor predeterminado es false. Este campo no se puede cambiar en un experimento cuyo estado sea ENDED. editable
id string ID de experimento. Obligatorio para el parche y la actualización. No se permite para la creación.
internalWebPropertyId string ID interno de la propiedad web a la que pertenece este experimento. Este campo es de solo lectura.
kind string Tipo de recurso de un experimento de Analytics. Este campo es de solo lectura.
minimumExperimentLengthInDays integer Número entero en [3, 90]. Especifica la duración mínima del experimento. Se puede cambiar en un experimento en ejecución. Este campo no se puede cambiar en un experimento cuyo estado sea ENDED. editable
name string Nombre del experimento. Este campo no se puede cambiar en un experimento cuyo estado sea ENDED. Este campo es obligatorio al crear un experimento. editable
objectiveMetric string Métrica que está optimizando el experimento. Valores válidos: "ga:goal(n)Completions", "ga:adsenseAdsClicks", "ga:adsenseAdsViewed", "ga:adsenseRevenue", "ga:bounces", "ga:pageviews", "ga:sessionDuration", "ga:transactions" y "ga:transactionRevenue". Este campo es obligatorio si el estado es "RUNNING" y servingFramework tiene el valor "REDIRECT" o "API". editable
optimizationType string Indica si objectiveMetric se debe minimizar o maximizar. Valores posibles: "MAXIMUM" y "MINIMUM". Opcional; el valor predeterminado es "MAXIMUM". No se puede especificar sin objectiveMetric. No se puede modificar si el estado es "RUNNING" o "ENDED". editable
parentLink.href string Enlace a la vista (perfil) a la que pertenece este experimento. Este campo es de solo lectura.
parentLink.type string El valor es "analytics#profile". Este campo es de solo lectura.
profileId string ID de vista (perfil) al que pertenece el experimento. Este campo es de solo lectura.
reasonExperimentEnded string Motivo por el que ha finalizado el experimento. Valores posibles: "STOPPED_BY_USER", "WINNER_FOUND", "EXPERIMENT_EXPIRED", "ENDED_WITH_NO_WINNER" o "GOAL_OBJECTIVE_CHANGED". "ENDED_WITH_NO_WINNER" significa que el experimento no ha acabado, pero no se ha proyectado encontrar ningún ganador. Si el estado del experimento se cambia mediante la API a ENDED se configura como STOPPED_BY_USER. Este campo es de solo lectura.
rewriteVariationUrlsAsOriginal boolean Campo booleano que especifica si las URL de las variaciones se reescriben para coincidir con las originales. Este campo no se puede cambiar en un experimento cuyo estado sea ENDED. editable
servingFramework string Marco de trabajo utilizado para publicar las variaciones del experimento y evaluar los resultados. Uno de estos valores:
  • REDIRECT: Google Analytics redirecciona el tráfico a diferentes páginas de variaciones, registra la variación elegida y evalúa los resultados.
  • API: Google Analytics elige y registra la variación que se publicará, y evalúa los resultados; el objeto que ha realizado la llamada es responsable de publicar la variación seleccionada.
  • EXTERNAL: las variaciones se publicarán externamente y la variación elegida se notificará a Google Analytics. El objeto que ha realizado la llamada es responsable de publicar la variación seleccionada y de evaluar los resultados.
editable
snippet string Fragmento de código para incluir en las páginas de control. Este campo es de solo lectura.
startTime datetime Hora de inicio del experimento (el estado de tiempo se ha cambiado de READY_TO_RUN a RUNNING). Este campo solo se encuentra si el experimento se ha iniciado. Este campo es de solo lectura.
status string Estado del experimento. Valores posibles: "DRAFT", "READY_TO_RUN", "RUNNING" y "ENDED". Los experimentos se pueden crear con el estado "DRAFT", "READY_TO_RUN" o "RUNNING". Este campo es obligatorio al crear un experimento. editable
trafficCoverage double Número de coma flotante entre 0 y 1. Especifica la fracción del tráfico que participa en el experimento. Se puede cambiar en un experimento en ejecución. Este campo no se puede cambiar en un experimento cuyo estado sea ENDED. editable
updated datetime Hora a la que se modificó el experimento por última vez. Este campo es de solo lectura.
variations[] list Matriz de variaciones. La primera variación de la matriz es el original. El número de variaciones no se puede cambiar una vez que el experimento se encuentre en el estado RUNNING. Se requieren al menos dos variaciones para que el estado se pueda configurar como RUNNING. editable
variations[].name string Nombre de la variación. Este campo es obligatorio al crear un experimento. Este campo no se puede cambiar en un experimento cuyo estado sea ENDED. editable
variations[].status string Estado de la variación. Valores posibles: "ACTIVE" e "INACTIVE". Las variaciones con el estado INACTIVE no se publican. Este campo no se puede cambiar en un experimento cuyo estado sea ENDED. editable
variations[].url string URL de la variación. Este campo no se puede cambiar en un experimento cuyo estado sea RUNNING o ENDED. editable
variations[].weight double Ponderación que debe recibir esta variación. Solo se muestra si el experimento está en ejecución. Este campo es de solo lectura.
variations[].won boolean "True" si el experimento ha finalizado y esta variación ha tenido, estadísticamente, un rendimiento superior al original. Este campo es de solo lectura.
webPropertyId string ID de propiedad web al que pertenece el experimento. El ID de propiedad web tiene el formato UA-XXXXX-YY. Este campo es de solo lectura.
winnerConfidenceLevel double Número de coma flotante entre 0 y 1. Especifica el nivel de confianza necesario para elegir un ganador. Este campo no se puede cambiar en un experimento cuyo estado sea ENDED. editable
winnerFound boolean Valor booleano que especifica si se ha encontrado un ganador para este experimento. Este campo es de solo lectura.

Métodos

delete
Suprimir un experimento.
get
Devuelve un experimento al que el usuario tiene acceso.
insert
Crear un experimento nuevo.
list
Enumera los experimentos a los que tiene acceso el usuario.
patch
Actualiza un experimento. Este método es compatible con la semántica de parches.
update
Actualiza un experimento.