> For the complete documentation index, see [llms.txt](https://help.citrusad.com/retail-media-interface/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.citrusad.com/retail-media-interface/partner/es/partner-api-overview/frequently-asked-questions.md).
# Preguntas frecuentes
## Operaciones masivas con las API de partners
### ¿Qué son las operaciones masivas?
Las operaciones masivas le permiten crear, editar o aprobar varias campañas, carteras o equipos en una sola solicitud de API en lugar de realizar llamadas individuales.
### ¿Las operaciones masivas son síncronas o asíncronas?
Asíncronas. Envía un trabajo y realiza sondeos para obtener resultados utilizando el id. masivo.
### ¿Qué sucede si fallan algunos elementos de mi solicitud masiva?
Cada elemento se valida de forma independiente. Obtendrá resultados detallados que muestran cuáles se realizaron correctamente y cuáles fallaron con mensajes de error específicos.
## Equipo y usuario
### ¿Qué es una invitación?
Una invitación permite a un usuario unirse a un equipo en la Epsilon Retail Media plataforma. Por lo general, las invitaciones las envían los administradores del equipo y deben aceptarse por correo electrónico o dentro de la plataforma antes de que el usuario pueda acceder a los recursos del equipo.
### ¿Cómo creo un equipo nuevo?
Utilice el [Crear equipo](/retail-media-interface/partner/es/team-user-api/team/createteam-1.md) punto de enlace con los campos obligatorios, como el nombre del equipo, la información de la empresa y el ID de espacio de nombres. Necesitará los permisos adecuados para crear equipos dentro de su organización.
### ¿Puedo pertenecer a varios equipos?
Sí, los usuarios pueden pertenecer a varios equipos simultáneamente. Cada pertenencia a un equipo puede tener diferentes niveles de permisos y roles.
### ¿Cuál es la diferencia entre los equipos de minoristas y los de proveedores?
Los equipos de minoristas gestionan y revisan las campañas, mientras que los equipos de proveedores (anunciantes) crean y gestionan las campañas. El tipo de equipo determina las funciones y los permisos disponibles.
### ¿Cómo cambio mis permisos de usuario?
Los administradores de equipo pueden modificar los permisos de usuario mediante el punto de enlace Modificar permiso de usuario. Los tipos de permisos incluyen Acceso total y Vista de informes para las funciones de minorista y proveedor.
### ¿Qué sucede cuando elimino a un usuario de un equipo?
Al eliminar a un usuario, se le revoca el acceso a los recursos, las campañas y los datos de ese equipo. El usuario ya no recibirá notificaciones del equipo ni podrá realizar acciones específicas del equipo.
### ¿Durante cuánto tiempo son válidos los tokens de invitación?
Los tokens de invitación tienen un periodo de caducidad. Póngase en contacto con el administrador de su equipo si su invitación ha caducado y necesita una nueva.
### ¿Puedo actualizar la información del equipo después de haberlo creado?
Sí, utilice el punto de enlace Actualizar un equipo para modificar los detalles del equipo, incluidos el nombre, la información de la empresa, el número de teléfono, la URL del sitio web y la dirección.
### ¿Qué tipos de archivos puedo cargar para los logotipos?
El [Cargar un archivo](/retail-media-interface/partner/es/team-user-api/user-1/uploadfile-1.md) punto de enlace admite formatos de imagen habituales para logotipos de perfiles de usuario y de equipo. Consulte la documentación de la API para conocer los requisitos específicos de formato y tamaño de archivo.
### ¿Cómo encuentro equipos a los que puedo unirme?
Utilice el punto de enlace Muestra una lista con todos los equipos con los filtros adecuados, como el nombre, `namespace_id`, or `seller_id` para descubrir los equipos disponibles dentro de su organización.
## Listar campañas
### ¿Cuándo debo utilizar `managedOnly`?
En el Epsilon Retail Media sistema, algunas campañas las gestionan los minoristas en lugar de los proveedores. Para los anuncios de productos, el único tipo de gasto disponible es la Ubicación fija. Utilice el `managedOnly` parámetro para recuperar solo las campañas con Ubicación fija.
## Crear o actualizar campañas
### ¿Cuándo utilizo `managerTeamId`?
Utilice el `managerTeamId` parámetro al crear o actualizar campañas de Ubicación fija. Al especificar `managerTeamId`, también deberá especificar la configuración de estrategia de Ubicación fija correspondiente.
### ¿Qué es un `namespaceId`?
El `namespaceId` es el identificador único del espacio de nombres donde se crean o actualizan las campañas. Para obtener más información, consulte Espacios de nombres. También puede ponerse en contacto con su Ingeniero de integración de clientes (CIE) para obtener este valor.
### ¿Qué es un `placementId`?
Las ubicaciones especifican los lugares donde se muestran los anuncios. Cada ubicación en el Epsilon Retail Media sistema tiene un identificador único denominado `placementId`.
Utilice la [Devuelve una lista de ubicaciones](/retail-media-interface/partner/es/global-api/placements/listplacements.md) API para obtener el `placementId`. Como alternativa, póngase en contacto con su CIE para obtener este valor.
### ¿Qué es un `walletId`?
Un walletId es el identificador de la cartera de un anunciante. Cada anunciante puede tener una o varias carteras. Cada cartera tendrá un valor de créditos que puede gastar. Al establecer el walletId, está estableciendo qué cartera de anunciante se cobrará por la campaña.
### ¿Qué es un `templateId`?
El `templateId` se utiliza en las implementaciones de Ad Genius. La mayoría de los clientes no lo utilizan habitualmente y, por lo general, se puede ignorar.
### ¿Qué son los campos personalizados?
En la Epsilon Retail Media plataforma, algunos minoristas necesitan atributos personalizados para las campañas, como órdenes de compra y datos del comprador. A continuación se muestra un ejemplo:
Si su integración no los requiere, puede ignorar este campo. Si los requiere, su CIE le proporcionará los ID necesarios.
### ¿Qué son las preguntas personalizadas?
En los espacios de nombres con datos integrados de segmentación de clientes, los anunciantes pueden dirigirse a segmentos de clientes mediante `key:value` combinaciones. Para obtener más información, consulte Datos de clientes.
En los espacios de nombres con preguntas personalizadas, puede indicar a los anunciantes si estas preguntas son opcionales u obligatorias y proporcionar la configuración pertinente. Su CIE puede proporcionarle el `customQuestionIds` si están configurados en su espacio de nombres.
### ¿Tengo que especificar `startTime` y `endTime`?
Puede omitir esto si la intención es que la campaña esté siempre activa. Si su anunciante desea establecer un periodo activo, debe proporcionar ambos valores en formato ISO-8601.
### ¿Cómo puedo actualizar una propiedad específica sin enviar todo el objeto de la campaña al realizar una actualización (PATCH)?
Nuestras API utilizan una `mask` propiedad que le permite actualizar una propiedad específica sin enviar todo el objeto de la campaña.
#### Puntos clave
* Ubicación\*\*: Asegúrese de que la `mask` propiedad esté correctamente posicionada en su solicitud.
* **Gestión de errores:** Si encuentra un error de permisos, compruebe el formato de la máscara en su solicitud.
#### Ejemplos
**Para cambiar una propiedad simple** como el nombre de la campaña, utilice lo siguiente:
```json
{
"productCampaign": {
"name": "new campaign name"
},
"mask": "name"
}
```
Para cambiar una propiedad anidada\*\* como el `maxBid`:
```json
{
"productCampaign": {
"strategy": {
"auction": {
"maxBid": "5"
}
}
},
"mask": "strategy.auction.maxBid"
}
```
Para cambiar varias propiedades\*\* como `searchTerms` y el `maxBid`, utilice una lista delimitada por comas con las propiedades que va a actualizar en `mask` propiedad:
```json
{
"productCampaign": {
"targeting": {
"searchTerms": [
{
"matchType": "MATCH_TYPE_EXACT_MATCH",
"phrase": "yoghurt_new",
"suggested": false
},
{
"matchType": "MATCH_TYPE_EXACT_MATCH",
"phrase": "dairy",
"suggested": false
},
{
"matchType": "MATCH_TYPE_EXACT_MATCH",
"phrase": "cheezy_new",
"suggested": false
}
]
},
"strategy": {
"auction": {
"maxBid": "6.5"
}
}
},
"mask": "targeting.searchTerms,strategy.auction"
}
```
## Monedero
### ¿Por qué necesito un monedero?
Los monederos se utilizan para gestionar los fondos de las campañas y garantizar que las transacciones se procesen en la moneda correcta. Para obtener más información, consulta Propósito.
### ¿Puedo tener varios monederos?
Sí, puedes crear varios monederos para gestionar diferentes monedas o presupuestos de campaña por separado. Para obtener más información, consulta Varios monederos.
### ¿Dónde puedo encontrar el ID de un monedero?
Para encontrar el ID de un monedero, puedes seguir estos pasos:
**Plataforma heredada:** Ve a la página **Facturación del equipo** para ver tu ID de monedero.
**Nueva interfaz de usuario:** Abre el **Gestor de monederos** para encontrar tu ID de monedero.
{% hint style="info" %}
Algunos equipos pueden tener varios monederos en diferentes monedas, así que asegúrate de seleccionar el correcto.
{% endhint %}
### ¿Cuál es el saldo actual?
El saldo actual es el saldo del monedero sin recargas de crédito ni límites aplicados.
### ¿Cuál es el saldo disponible?
El saldo disponible es el importe total en el monedero que está disponible para gastar en cualquier momento. Incluye el saldo actual más cualquier límite de crédito.
### ¿Qué es un límite diario o gasto diario?
Un límite diario es el importe máximo que tu monedero puede gastar en un solo día.
### ¿Qué es el ritmo presupuestario?
El ritmo presupuestario significa que los fondos no gastados del límite diario se acumularán para el límite diario del día siguiente.
### ¿Cuál es el límite diario restante?
El límite diario restante son los fondos no gastados del límite diario del día anterior.
### ¿Cuál es el saldo disponible topado?
El saldo disponible topado es el importe que el monedero te permite gastar durante el día, teniendo en cuenta cualquier límite de gasto o créditos de recarga. Este valor es crucial porque determina si hay dinero disponible para gastar.
**Cálculo del saldo disponible topado**:
* **Solo límite de crédito**: Saldo disponible topado = Saldo disponible.
* **Solo límite diario**: Saldo disponible topado = Límite diario + acumulado no gastado
* **Se aplican tanto el límite de crédito como el límite diario**: El mínimo entre (Saldo disponible, Límite diario + acumulado)
Aquí tienes algunos ejemplos:
* **Ejemplo 1**: El límite de crédito es 10, el saldo del monedero es 20.
* **Ejemplo 2**: El presupuesto diario es 1000, el saldo del monedero es 10.000.
* **Ejemplo 3**: El presupuesto diario es 250, el límite de crédito es 20, el saldo del monedero es 200. En este caso, el saldo disponible topado es 220 porque el saldo disponible (saldo actual + límite de crédito) es inferior al límite diario más el acumulado no gastado (250).
{% hint style="info" %}
Los límites de crédito son una función heredada y la mayoría de los minoristas no los admiten.
{% endhint %}
### ¿Puede el saldo del monedero ser negativo?
No. Los saldos de los monederos no se pueden establecer intencionadamente como negativos a través de la Partner API. Aunque la actividad de la campaña puede afectar temporalmente a los saldos, este comportamiento lo gestiona el sistema y no el usuario.
### ¿Por qué no puedo seleccionar un monedero al crear una campaña?
La moneda del monedero debe coincidir con la moneda del catálogo. Por ejemplo, si tu catálogo está en AUD, no puedes seleccionar un monedero en GBP. Para obtener más información, consulta [Compatibilidad de moneda con catálogos](/retail-media-interface/partner/es/billing-api/wallet.md#currency-compatibility-with-catalogs).
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://help.citrusad.com/retail-media-interface/partner/es/partner-api-overview/frequently-asked-questions.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.