> ## Documentation Index
> Fetch the complete documentation index at: https://generaltranslation.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Pruebas A/B
export const Button = ({href, children}) => {
return
;
};
## Descripción general
### Introducción
Las pruebas A/B permiten a los anunciantes segmentar a los usuarios a los que alcanzan en X para entender cómo optimizar mejor el rendimiento de las campañas y obtener conclusiones que sirvan para orientar sus estrategias de marketing.
Estos segmentos —denominados divisiones de grupos de usuarios— se asignan de forma aleatoria y son mutuamente excluyentes. Con la aleatorización, los factores que influyen en los resultados se distribuyen de manera uniforme. En otras palabras, no hay diferencias inherentes entre los grupos ni en sus comportamientos esperados. Debido a esto, cuando se aplica una única variación a un grupo de usuarios y no a los demás, la diferencia en el rendimiento de la campaña se puede atribuir a esa variación.
Si bien es posible probar muchas variaciones a la vez, recomendamos encarecidamente probar una sola variación por vez. Esto aísla el factor causal de la diferencia observada en el rendimiento de la campaña.
Las variaciones se establecen a nivel de campaña. Por ejemplo, si el anunciante quiere probar la eficacia de un nuevo creativo, debe crear dos campañas idénticas donde la única diferencia sea ese creativo. En el futuro, planeamos admitir variaciones a nivel de línea de pedido.
### Casos de uso
Las pruebas A/B se utilizan con mayor frecuencia para respaldar (1) casos de uso de optimización para clientes orientados al rendimiento que quieren comprender qué funciona mejor en X a fin de optimizar su inversión y (2) casos de uso de aprendizaje para anunciantes de marca que quieren utilizar esos aprendizajes para orientar su estrategia de marketing.
La API admitirá pruebas A/B para cualquier variable de campaña, incluidos:
* Creatividad
* Segmentación
* Tipo de puja
* Unidad de puja
## Pruebas A/B
Las pruebas A/B permiten a los anunciantes segmentar a los usuarios a los que llegan en X para que puedan entender cómo optimizar mejor el rendimiento de las campañas y extraer conclusiones que orienten sus estrategias de marketing.
Estos segmentos —denominados divisiones de grupos de usuarios— se asignan de forma aleatoria y son mutuamente excluyentes. Con la aleatorización, los factores que influyen en los resultados se distribuyen por igual. En otras palabras, no existen diferencias inherentes entre los grupos ni en sus comportamientos esperados. Debido a esto, cuando se aplica una única variación a un grupo de usuarios y no a los demás, la diferencia en el rendimiento de la campaña puede atribuirse a esa variación.
Si bien es posible probar muchas variaciones a la vez, recomendamos encarecidamente probar una sola variación cada vez. Esto aísla el factor causal de la diferencia observada en el rendimiento de la campaña.
Las variaciones se configuran a nivel de campaña o de grupo de anuncios. El grupo de anuncios se configura a través de [line item](https://developer.x.com/en/docs/twitter-ads-api/campaign-management/api-reference/line-items) en Ads API. Como ejemplo de una variación a nivel de grupo de anuncios, si el anunciante quiere probar la eficacia de una nueva creatividad, debe crear una campaña con 2 grupos de anuncios idénticos donde la única diferencia sea la creatividad.
### Casos de uso
Las pruebas A/B se usan con mayor frecuencia para respaldar (1) casos de uso de optimización para clientes orientados al rendimiento que quieren entender qué funciona mejor en X a fin de optimizar su inversión y (2) casos de uso de aprendizaje para anunciantes de marca que quieren aprovechar esos aprendizajes para definir su estrategia de marketing.
La API permitirá realizar pruebas A/B para cualquier variable de campaña, incluidas:
* Creatividades
* Segmentación
* Tipo de puja
* Unidad de puja
### Atributos
Las pruebas A/B se representan como estructuras anidadas. Hay campos de nivel superior para la propia prueba A/B y un array de objetos de grupos de usuarios, cada uno con un conjunto de campos que lo describen.
A alto nivel, toda prueba A/B debe incluir la siguiente información.
* La duración de la prueba, representada por los campos start\_time y end\_time
* El nivel en el que se producirá la división, representado por el campo entity\_type
* Al menos dos (y como máximo 30) grupos de usuarios, cada uno representado como un objeto en el array user\_groups
Cada grupo de usuarios *debe* incluir la siguiente información.
* El porcentaje de usuarios que se debe asignar al grupo de usuarios dado, representado por el campo size
* Los ids de campañas / ids de elementos de línea que deben conformar el conjunto de usuarios para el grupo de usuarios dado, representados por el array entity\_ids
Opcionalmente, se pueden establecer valores de nombre y descripción para las pruebas A/B y para los grupos de usuarios. La información sobre las reglas de validación y otras restricciones se encuentra a continuación.
Otros metadatos, como el id o la marca de tiempo de creación, también se incluyen, pero se establecen automáticamente por X.
A continuación se muestra un ejemplo de entidad de prueba A/B a nivel de campaña.
```json theme={null}
{
"created_at": "2020-12-01T00:00:00Z",
"created_by": {
"user_id": "756201191646691328",
"username": "apimctestface"
},
"deleted": false,
"description": "documentation example",
"end_time": "2020-12-05T01:00:00Z",
"entity_type": "CAMPAIGN",
"id": "hr7l0",
"name": "first AB test",
"start_time": "2020-12-01T01:00:00Z",
"status": "SCHEDULED",
"user_groups": [
{
"id": "p1bcx",
"name": "first group",
"description": null,
"size": "50.0",
"entity_ids": [
"f2qcw",
"f2tht"
]
},
{
"id": "p1bcy",
"name": "second group",
"description": "second AB test group",
"size": 50,
"entity_ids": [
"f2rqi",
"f2tws"
]
}
],
"updated_at": "2020-12-01T00:00:00Z",
"updated_by": {
"user_id": "756201191646691328",
"username": "apimctestface"
}
}
```
A continuación se muestra un ejemplo de entidad de prueba A/B a nivel de line item.
```json theme={null}
{
"created_by":{
"user_id":"756201191646691328",
"username":"apimctestface"
},
"name":"Test2e",
"start_time":"2022-08-15T00:00:00Z",
"updated_by":{
"user_id":"756201191646691328",
"username":"apimctestface"
},
"description":"My Second AB test",
"entity_type":"LINE_ITEM",
"end_time":"2022-08-30T00:00:00Z",
"id":"1ul",
"user_groups":[
{
"name":"first group",
"size":"50.0",
"description":"first group description",
"entity_ids":[
"ij9dh"
],
"id":"4xe"
},
{
"name":"second group",
"size":"50.0",
"description":"second group description",
"entity_ids":[
"ihng8"
],
"id":"4xf"
}
],
"status":"SCHEDULED",
"created_at":"2022-08-11T00:10:50Z",
"updated_at":"2022-08-11T00:10:50Z",
"deleted":false
}
```
### Uso
Las siguientes subsecciones describen cómo crear y actualizar pruebas A/B. Las operaciones de lectura y eliminación funcionan igual que en todos los demás endpoints de la API de anuncios.
#### Creación
Crea una prueba A/B usando el endpoint [POST accounts/:account\_id/ab\_tests](https://developer.x.com/en/docs/x-ads-api/measurement/api-reference/ab-tests). El endpoint solo acepta cuerpos POST en JSON. El Content-Type debe establecerse en application/json.
Una vez que el anunciante haya configurado dos o más campañas, se puede crear una prueba A/B. Como se indicó arriba, las pruebas A/B *deben* incluir: duración de la prueba, nivel de división y al menos dos grupos de usuarios. Cada grupo de usuarios debe declarar el porcentaje de usuarios que se le debe asignar, así como los IDs de campaña que deben conformar su conjunto de usuarios. Cada uno de estos aspectos se describe con más detalle a continuación.
Duración de la prueba:
* Los valores start\_time y end\_time deben
* Estar en el futuro (en relación con el momento en que se crea la prueba A/B)
* Superponerse con las fechas de ejecución de la campaña/line item
* La prueba debe durar al menos un día para campañas que no están basadas en App y al menos cinco días para campañas basadas en App
Nivel de división:
* El entity\_type se puede establecer en CAMPAIGN o LINE\_ITEM
Grupos de usuarios:
* Cada grupo de usuarios se representa como un objeto en el array user\_groups
* Se requieren al menos dos grupos de usuarios
* Se permiten como máximo 30 grupos de usuarios
* El tamaño de cada grupo de usuarios se establece usando una representación como cadena de un valor numérico entre 1.00 y 99.00
* **Nota**: Los valores de tamaño *de todos los objetos* **deben** sumar 100.00
* Los IDs de campaña deben especificarse en el array entity\_ids de cada grupo de usuarios
Opcionalmente, establece el nombre y la descripción de la prueba A/B o de uno o más grupos de usuarios.
La siguiente solicitud crea una prueba A/B a nivel de campaña que dura cuatro días y tiene dos grupos de usuarios con un 50% de usuarios en cada grupo. El primer grupo de usuarios se basa en las campañas f2qcw y f2tht; el segundo grupo de usuarios se basa en las campañas f2rqi y f2tws. La solicitud también agrega nombres y descripciones a algunas partes de la entidad.
twurl -X POST -H ads-api.x.com "/8/accounts/18ce54d4x5t/ab\_tests" -d '\{"end\_time": "2020-12-05T01:00:00Z", "entity\_type" : "CAMPAIGN", "start\_time": "2020-12-01T01:00:00Z", "user\_groups": \[\{"entity\_ids": \["f2qcw", "f2tht"], "size": "50.00", "name": "first group"},\{"entity\_ids": \["f2rqi", "f2tws"], "size": "50.00", "name": "second group", "description": "second AB test group"}], "name": "first AB test", "description": "documentation example"}'
```json theme={null}
twurl -X POST -H ads-api.x.com "/8/accounts/18ce54d4x5t/ab_tests" -d '{"end_time": "2020-12-05T01:00:00Z", "entity_type" : "CAMPAIGN", "start_time": "2020-12-01T01:00:00Z", "user_groups": [{"entity_ids": ["f2qcw", "f2tht"], "size": "50.00", "name": "first group"},{"entity_ids": ["f2rqi", "f2tws"], "size": "50.00", "name": "second group", "description": "second AB test group"}], "name": "first AB test", "description": "documentation example"}'
{
"request": {
"params": {
"account_id": "18ce54d4x5t",
"end_time": "2020-12-05T01:00:00Z",
"entity_type": "CAMPAIGN",
"start_time": "2020-12-01T01:00:00Z",
"user_groups": [
{
"entity_ids": [
"f2qcw",
"f2tht"
],
"size": "50.0",
"name": "first group"
},
{
"entity_ids": [
"f2rqi",
"f2tws"
],
"size": "50.0",
"name": "second group",
"description": "second AB test group"
}
],
"name": "first AB test",
"description": "documentation example"
}
},
"data": {
"created_at": "2020-12-01T00:00:00Z",
"created_by": {
"user_id": "756201191646691328",
"username": "apimctestface"
},
"deleted": false,
"description": "documentation example",
"end_time": "2020-12-05T01:00:00Z",
"entity_type": "CAMPAIGN",
"id": "hr7l0",
"name": "first AB test",
"start_time": "2020-12-01T01:00:00Z",
"status": "SCHEDULED",
"user_groups": [
{
"id": "p1bcx",
"name": "first group",
"description": null,
"size": "50.0",
"entity_ids": [
"f2qcw",
"f2tht"
]
},
{
"id": "p1bcy",
"name": "second group",
"description": "second AB test group",
"size": "50.0",
"entity_ids": [
"f2rqi",
"f2tws"
]
}
],
"updated_at": "2020-12-01T00:00:00Z",
"updated_by": {
"user_id": "756201191646691328",
"username": "apimctestface"
}
}
}
```
**Para pruebas A/B a nivel de line item**
La principal diferencia entre las pruebas A/B a nivel de campaña y a nivel de line item es el valor de entity\_type. Debemos configurarlo como ‘entity\_type’ = ‘LINE\_ITEM’ para las pruebas A/B a nivel de line item. Esto se aplica a todas las acciones sobre una prueba A/B ya creada que se indican a continuación.
Requisitos:
1. Todos los line items de la campaña de pruebas A/B deben incluirse en el split test.
2. Solo se permite una división equitativa a nivel de line item.
3. El número de line items de grupos de usuarios permitidos en 1 split test debe ser menor o igual a 5.
4. Solo 1 line item por grupo de usuarios.
### Actualización
Actualiza una prueba A/B usando el endpoint [PUT accounts/:account\_id/ab\_tests/:ab\_test\_id](https://developer.x.com/en/docs/x-ads-api/measurement/api-reference/ab-tests). El endpoint requiere que se envíe un blob JSON en la solicitud. El Content-Type debe establecerse en application/json.
Al igual que otros endpoints de actualización, el endpoint [PUT accounts/:account\_id/ab\_tests/:ab\_test\_id](/es/x-ads-api/measurement/ab-testing#get-accounts-account-id-ab-tests) requiere que el id de la prueba A/B se incluya en la URL. En general, las pruebas A/B solo se pueden actualizar mientras el estado es SCHEDULED. Hay una excepción: es posible actualizar el end\_time de la prueba A/B mientras está LIVE.
Este endpoint admite JSON parcial con id de objetos. Se aplican los siguientes principios:
* Para agregar o eliminar objetos o elementos, pasa el array completo (y sus subestructuras); esta es una operación de **reemplazo**
* De lo contrario, modifica (cambia, agrega, elimina) los *campos* existentes haciendo referencia a nombres de clave o id
* Para eliminar un campo, establece su valor en null
* Los campos que no se pasan no se modifican
Por ejemplo, agregar un tercer grupo de usuarios a la prueba A/B creada anteriormente requeriría que enviáramos el array user\_groups con los dos objetos de grupo de usuarios existentes, así como con el nuevo que queremos agregar. Piensa en esto como *recrear* el array user\_groups; pasa los datos como si lo estuvieras creando de esta manera desde el principio (no envíes id de objetos de grupos de usuarios). El array user\_groups en la solicitud de actualización podría representarse de la siguiente manera.
```json theme={null}
[
{
"entity_ids": [
"f2qcw",
"f2tht"
],
"size": "30.0",
"name": "first group"
},
{
"entity_ids": [
"f2rqi",
"f2tws"
],
"size": "30.0",
"name": "second group",
"description": "second AB test group"
},
{
"entity_ids": [
"i1vwr",
"i1xre"
],
"size": "40.0"
}
]
```
Observa que los valores de size de los objetos aún suman 100.00. Si no los hubiéramos actualizado para los dos primeros objetos —antes establecidos en 50.00 cada uno—, la solicitud habría fallado.
Si, en cambio, solo quisiéramos agregar una descripción al primer grupo de usuarios, el array user\_groups en la solicitud de actualización tendría el siguiente aspecto.
```json theme={null}
[
{
"id": "p1bcx",
"description": "updated using a PUT request"
}
]
```
Hacemos referencia al objeto de grupo de usuarios por su id y solo incluimos el campo que queremos modificar.
#### Ejemplos de solicitudes
Esta sección proporciona ejemplos adicionales de solicitudes de actualización. Considéralas como si se ejecutaran de forma secuencial. Los bloques JSON están formateados para facilitar la lectura. Las respuestas se omiten.
Para aplicar las siguientes modificaciones, la solicitud se representaría de la siguiente manera. (Es el mismo ejemplo utilizado anteriormente).
1. Agrega un tercer grupo de usuarios sin nombre ni descripción
2. Cambia el porcentaje de usuarios en cada grupo de usuarios
twurl -X PUT -H ads-api.x.com "/8/accounts/18ce54d4x5t/ab\_tests/hr7l0" -d '
```json theme={null}
twurl -X PUT -H ads-api.x.com "/8/accounts/18ce54d4x5t/ab_tests/hr7l0" -d '
{
"user_groups": [
{
"entity_ids": [
"f2qcw",
"f2tht"
],
"size": "30.00",
"name": "first group"
},
{
"entity_ids": [
"f2rqi",
"f2tws"
],
"size": "30.00",
"name": "second group",
"description": "second AB test group"
},
{
"entity_ids": [
"i1vwr",
"i1xre"
],
"size": "40.00"
}
]
}'
```
Para realizar las siguientes modificaciones, la solicitud sería la siguiente:
1. Elimina la descripción de la prueba A/B
2. Agrega una descripción al primer grupo de usuarios
3. Agrega un id de entidad (f2syz) al segundo grupo de usuarios
twurl -X PUT -H ads-api.x.com "/8/accounts/18ce54d4x5t/ab\_tests/hr7l0" -d '
```json theme={null}
twurl -X PUT -H ads-api.x.com "/8/accounts/18ce54d4x5t/ab_tests/hr7l0" -d '
{
"description": null,
"user_groups": [
{
"id": "p1bcx",
"description": "first AB test group"
},
{
"id": "p1bcy",
"entity_ids": [
"f2rqi",
"f2tws",
"f2syz"
]
}
]
}'
```
La tercera modificación requiere que incluyamos las dos ID de entidad existentes junto con la nueva. Observa que no se hicieron cambios en el tercer grupo de usuarios.
Para realizar las siguientes modificaciones, la solicitud se representaría de la siguiente manera:
1. Elimina el segundo grupo de usuarios
2. Cambia el porcentaje de usuarios en cada grupo de usuarios
```json theme={null}
twurl -X PUT -H ads-api.x.com "/8/accounts/18ce54d4x5t/ab_tests/hr7l0" -d '
{
"user_groups": [
{
"entity_ids": [
"f2qcw",
"f2tht"
],
"size": "55.00",
"name": "first group"
},
{
"entity_ids": [
"i1vwr",
"i1xre"
],
"size": "45.00"
}
]
}'
```
## Referencia de la API
### Pruebas A/B
[]()
#### GET accounts/:account\_id/ab\_tests
Recupera los detalles de algunas o todas las pruebas A/B.
| Name | Description |
| :------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id *required* | El identificador de la cuenta utilizada. Aparece dentro de la ruta del recurso y, por lo general, es un parámetro obligatorio para todas las solicitudes de la Advertiser API excepto [GET accounts](/es/x-ads-api/campaign-management#accounts). La cuenta especificada debe estar asociada con el usuario autenticado.
Type: string
Example: `18ce54d4x5t` |
| ab\_test\_ids *optional* | Limita la respuesta solo a las pruebas A/B deseadas especificando una lista de identificadores separados por comas. Se pueden proporcionar hasta 200 identificadores.
Type: string
Example: `hr7l0` |
| count *optional* | Especifica la cantidad de registros que se intentará recuperar por cada solicitud distinta.
Type: int
Default: `200` Min, Max: `1`, `1000` |
| cursor *optional* | Especifica un cursor para obtener la siguiente página de resultados. Consulta [Paginación](/es/x-ads-api/introduction) para más información.
Type: string
Example: `8x7v00oow` |
| live\_during *optional* | Limita la respuesta a pruebas A/B que estuvieron o estarán activas durante el intervalo de fechas indicado. Esto devuelve pruebas A/B cuyos tiempos de inicio y fin se superponen, parcial o totalmente, con el intervalo de fechas proporcionado.
Especifica los valores como fechas separadas por comas, expresadas en [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). La fecha anterior debe especificarse primero.
Type: string
Example: `2020-11-01T08:00:00Z,2020-12-01T08:00:00Z` |
| q *optional* | Una consulta opcional para limitar el recurso por `name`. Omite este parámetro para recuperar todos los recursos.
Type: string
Min, Max length: `1`, `80` |
| sort\_by *optional* | Ordena por el atributo admitido en orden ascendente o descendente. Consulta [Ordenación](/es/x-ads-api/fundamentals/sorting) para más información.
Type: string
Example: `created_at-asc` |
| status *optional* | Limita la respuesta a pruebas A/B con el estado deseado.
Type: enum
Possible values: `COMPLETED`, `LIVE`, `SCHEDULED` |
| user\_id *optional* | Limita la respuesta a pruebas A/B creadas por el ID de usuario especificado.
**Nota**: No se puede especificar al mismo tiempo que `username`.
Type: long
Example: \`756201191646691328. |
| username *optional* | Limita la respuesta a pruebas A/B creadas por el nombre de usuario especificado. No incluyas el símbolo inicial "@".
**Nota**: No se puede especificar al mismo tiempo que `user_id`.
Type: string
Example: \`apimctestface. |
| with\_deleted *optional* | Incluye los resultados eliminados en tu solicitud.
Type: boolean
Default: `false` Possible values: `true`, `false` |
Crea una nueva prueba A/B.
Todos los parámetros se envían en el cuerpo de la solicitud y es obligatorio usar un `Content-Type` de `application/json`.
##### URL del recurso
`https://ads-api.x.com/12/accounts/:account_id/ab_tests`
##### Parámetros
| Nombre | Descripción |
| :-------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id *obligatorio* | El identificador de la cuenta utilizada. Aparece en la ruta del recurso y, por lo general, es un parámetro obligatorio para todas las solicitudes a la Advertiser API, excluyendo [GET accounts](/es/x-ads-api/campaign-management#accounts). La cuenta especificada debe estar asociada con el usuario autenticado.
Tipo: string
Ejemplo: `18ce54d4x5t` |
| end\_time *obligatorio* | El momento, expresado en formato ISO 8601, en el que finalizará la prueba A/B.
Tipo: string
Ejemplo: `2020-10-02T00:00:00Z` |
| entity\_type *obligatorio* | El tipo de entidad que se utilizará para la segmentación de los grupos de usuarios.
Tipo: enum
Valores posibles: `CAMPAIGN`, `LINE_ITEM` |
| start\_time *obligatorio* | El momento, expresado en formato ISO 8601, en el que comenzará la prueba A/B.
Tipo: string
Ejemplo: `2022-05-30T00:00:00Z` |
| user\_groups *obligatorio* | Describe los grupos de usuarios. Más información en la tabla a continuación. Se pueden especificar entre 2 y 30 grupos de usuarios.
Tipo: array de objetos |
| description *opcional* | La descripción de la prueba A/B. Longitud máxima: 1.024 caracteres.
Tipo: string
Ejemplo: `documentation example` |
| name *opcional* | El nombre de la prueba A/B. Longitud máxima: 255 caracteres.
Tipo: string
Ejemplo: `first AB test` |
#### Grupos de usuarios
| Nombre | Descripción |
| :---------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| entity\_ids *required* | Un array de id de entidad.
**Nota**: Las entidades solo se pueden asociar con una prueba A/B.
Type: array
Example: `["dxi0l", "e66bl"]` |
| size *required* | El porcentaje de usuarios que se asignarán a este grupo de usuarios. Es un valor numérico representado como una cadena con un máximo de dos dígitos después del punto decimal. Por ejemplo, representa el 40 % como: 40, 40.0 o 40.00.
**Nota**: Los valores de size en todos los *objetos* **deben** sumar 100.00.
Type: array
Min, Max: `1.00`, `99.00` |
| description *optional* | La descripción del grupo de usuarios. Longitud máxima: 1,024 caracteres.
Type: string
Example: `second AB test group` |
| name *optional* | El nombre del grupo de usuarios. Longitud máxima: 255 caracteres.
#### PUT accounts/:account\_id/ab\_tests/:ab\_test\_id
Actualiza la prueba A/B especificada.
Todos los parámetros se envían en el cuerpo de la solicitud y es obligatorio que el `Content-Type` sea `application/json`.
Este endpoint admite JSON parcial con id de objeto. Se aplican los siguientes principios:
* Para agregar o eliminar objetos o elementos, envía el array completo (y sus subestructuras); esta es una operación de **reemplazo**
* Piensa en esto como volver a crear el array
* En caso contrario, modifica (cambia, agrega, elimina) los campos existentes haciendo referencia a los nombres de las claves o a los id
* Para eliminar un campo, establece su valor en `null`
* Los campos que no se envían no se modifican
En general, las pruebas A/B solo se pueden actualizar mientras el `status` es `SCHEDULED`. Hay una excepción: es posible actualizar el `end_time` de la prueba A/B mientras está `LIVE`.
##### URL del recurso
`https://ads-api.x.com/12/accounts/18ce54d4x5t/:ab_test_id`
##### Parámetros
| Nombre | Descripción |
| :----------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id *required* | El identificador de la cuenta utilizada. Aparece dentro de la ruta del recurso y, por lo general, es un parámetro obligatorio para todas las solicitudes de la Advertiser API, excepto [GET accounts](/es/x-ads-api/campaign-management#accounts). La cuenta especificada debe estar asociada con el usuario autenticado.
Tipo: string
Ejemplo: `18ce54d4x5t` |
| ab\_test\_id *required* | Una referencia a la prueba A/B que se utiliza en la solicitud.
Tipo: string
Ejemplo: `hr7l0` |
| description *optional* | La descripción de la prueba A/B. Longitud máxima: 1.024 caracteres.
**Nota**: Solo se puede actualizar mientras el `status` de la prueba A/B sea `SCHEDULED`.
Tipo: string
Ejemplo: `documentation example` |
| end\_time *optional* | La hora, expresada en ISO 8601, en la que finalizará la prueba A/B.
**Nota**: Solo se puede actualizar mientras el `status` de la prueba A/B sea `SCHEDULED` o `LIVE`.
Tipo: string
Ejemplo: `2020-10-02T00:00:00Z` |
| name *optional* | El nombre de la prueba A/B. Longitud máxima: 255 caracteres.
**Nota**: Solo se puede actualizar mientras el `status` de la prueba A/B sea `SCHEDULED`.
Tipo: string
Ejemplo: `first AB test` |
| start\_time *optional* | La hora, expresada en ISO 8601, en la que comenzará la prueba A/B.
**Nota**: Solo se puede actualizar mientras el `status` de la prueba A/B sea `SCHEDULED`.
Tipo: string
Ejemplo: `2022-05-30T00:00:00Z` |
| user\_groups *required* | Describe los grupos de usuarios. Más información en la tabla a continuación.
**Nota**: Solo se puede actualizar mientras el `status` de la prueba A/B sea `SCHEDULED`.
Tipo: array of objects |
#### Grupos de usuarios
| Name | Description |
| :----------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| id *sometimes required* | Una referencia al objeto de grupo de usuarios con el que estás operando en la solicitud.
**Nota**: Obligatorio al modificar (cambiar, agregar o eliminar) *campos* de un objeto de grupo de usuarios.
**Nota**: No especifiques un id al agregar o eliminar objetos de grupo de usuarios completos.
Tipo: string
Ejemplo: `p1bcx` |
| description *optional* | La descripción del grupo de usuarios. Longitud máxima: 1,024 caracteres.
**Nota**: Para quitarla, especifica el campo con un valor `null`.
Tipo: string
Ejemplo: `second AB test group` |
| entity\_ids *optional* | Un array de ids de entidad.
**Nota**: Esta es una operación de reemplazo. Sobrescribe cualquier valor configurado previamente.
**Nota**: Las entidades solo pueden estar asociadas con una única prueba A/B.
Tipo: array
Ejemplo: `["dxi0l", "e66bl"]` |
| name *optional* | El nombre del grupo de usuarios. Longitud máxima: 255 caracteres.
**Nota**: Para quitarlo, especifica el campo con un valor `null`.
Tipo: string
Ejemplo: `first group` |
| size *optional* | El porcentaje de usuarios que se asignará a este grupo de usuarios. Es un valor numérico representado como string con un máximo de dos dígitos después del punto decimal. Por ejemplo, representa 40% como: 40, 40.0 o 40.00.
**Nota**: Los valores de size en todos los *objetos* **deben** sumar 100.00.
Tipo: string
Mín., máx.: `1.00`, `99.00` |
##### Ejemplo de solicitud
Esta solicitud realiza las siguientes modificaciones:
1. Elimina la descripción de la prueba A/B
2. Cambia la hora de finalización
3. Agrega una descripción al primer grupo de usuarios
4. Cambia el porcentaje de usuarios en cada grupo de usuarios
5. Agrega un ID de entidad (`f2syz`) al segundo grupo de usuarios
`PUT https://ads-api.x.com/12/accounts/18ce54d4x5t/ab_tests/hr7l0 -d '{"description": null, "end_time": "2022-06-01T01:00:00Z", "user_groups": [{"id": "p1bcx", "description": "first AB test group", "size": "60.00"},{"id": "p1bcy", "size": "40.00", "entity_ids": ["f2rqi", "f2tws", "f2syz"]}]}'`
##### Ejemplo de respuesta
```json theme={null}
{
"request": {
"params": {
"account_id": "18ce54d4x5t",
"ab_test_id": "hr7l0",
"description": null,
"end_time": "2022-06-01T01:00:00Z",
"user_groups": [
{
"id": "p1bcx",
"description": "first AB test group",
"size": "60.0"
},
{
"id": "p1bcy",
"size": "40.0",
"entity_ids": [
"f2rqi",
"f2tws",
"f2syz"
]
}
]
}
},
"data": {
"created_at": "2020-05-25T00:00:00Z",
"created_by": {
"user_id": "756201191646691328",
"username": "apimctestface"
},
"deleted": false,
"description": null,
"end_time": "2022-06-01T01:00:00Z",
"entities": [
{
"id": "p1bcx",
"account_id": "18ce54d4x5t"
},
{
"id": "p1bcy",
"account_id": "18ce54d4x5t"
}
],
"entity_type": "CAMPAIGN",
"id": "hr7l0",
"name": "first AB test",
"start_time": "2022-05-25T01:00:00Z",
"status": "SCHEDULED",
"user_groups": [
{
"id": "p1bcx",
"name": "first group",
"description": "first AB test group",
"size": "60.0",
"entity_ids": [
"f2qcw",
"f2tht"
]
},
{
"id": "p1bcy",
"name": "second group",
"description": "second AB test group",
"size": "40.0",
"entity_ids": [
"f2rqi",
"f2tws",
"f2syz"
]
}
],
"updated_at": "2022-05-25T00:17:23Z",
"updated_by": {
"user_id": "756201191646691328",
"username": "apimctestface"
}
}
}
```
Elimina la prueba A/B especificada.
**Nota**: Eliminar una prueba A/B no se puede deshacer y los intentos posteriores de eliminar el recurso devolverán un código de estado HTTP 404.
##### URL del recurso
`https://ads-api.x.com/12/accounts/:account_id/ab_tests/:ab_test_id`
##### Parámetros
| Nombre | Descripción |
| :----------------------------- | :----------------------------------------------------------------------------------------------------------------- |
| ab\_test\_id *required* | Una referencia a la prueba A/B que se utiliza en la solicitud.