> 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/integration/es/reporting/reporting-overview.md).

# Descripción general

## Arquitectura física

El Epsilon Retail Media Reporting API proporciona acceso seguro al Epsilon Retail Media almacén de datos. El propio almacén de datos contiene datos e información procedente de la Epsilon Retail Media plataforma.

El Epsilon Retail Media almacén de datos es un modelo distribuido. Algunos datos se guardan localmente dentro de las Epsilon Retail Media instancias de la plataforma, otros datos en un almacén de datos global centralizado.

El siguiente diagrama muestra la estructura del modelo de datos.

<figure><img src="/files/RxjYjJLUc7b7iigiB0gZ" alt="" width="100%"><figcaption></figcaption></figure>

| Capa                                            | Descripción                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| ----------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Datos de la plataforma                          | <p>Datos de origen de la Epsilon Retail Media plataforma. La plataforma en sí está distribuida en múltiples instancias físicas. Existe una instancia por cada gran minorista o, en algunos casos, se comparte de forma segura entre varios minoristas más pequeños.<br>No se permite el acceso directo a los Datos de la plataforma a conexiones externas.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| Datos preparados                                | <p>Los Datos de la plataforma relevantes se preparan en el almacén de datos casi en tiempo real. Los Datos preparados se mantienen por instancia de plataforma en la misma ubicación física que los Datos de la plataforma.<br>Por lo general, no se permite el acceso directo a los Datos preparados a conexiones externas.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| Dataset principal                               | <p>Diariamente, los procesos por lotes toman los Datos preparados y los modelan en un esquema en copo de nieve fácil de usar denominado Dataset principal. El Dataset principal también se mantiene por instancia de plataforma en la misma ubicación física que los Datos preparados y los Datos de la plataforma.<br>Cada hecho del Dataset principal está disponible tanto a nivel de detalle de transacción individual como agregado.<br>El seguimiento de cambios también está presente en muchas dimensiones.<br>Se permite el acceso directo a los Datasets principales (previa solicitud) a ciertos clientes, principalmente a nivel de minorista (sujeto a aprobaciones).</p>                                                                                                                                                                                                                                       |
| Datasets principales agregados                  | <p>Una vez actualizados los Datasets principales, los procesos por lotes toman los Datasets principales individuales y los transfieren a una ubicación centralizada (el almacén de datos global). A continuación, los Datasets principales individuales se consolidan en un único Dataset principal agregado unificado.<br>Tenga en cuenta que en el almacén de datos global solo se almacenan datos de hechos agregados (no datos transaccionales).<br>Por lo general, no se permite el acceso directo al Dataset principal agregado a conexiones externas.</p>                                                                                                                                                                                                                                                                                                                                                             |
| Datamart de informes                            | <p>Una vez actualizado el Dataset principal agregado, los procesos por lotes diarios calculan un Datamart de informes aún más simplificado y agregado.<br>Al igual que los Datasets principales, el Datamart de informes también es un esquema en copo de nieve. Solo se ofrecen versiones actuales de las dimensiones. Los clientes deben mantener el historial de cambios localmente dentro de sus propios almacenes de datos según sea necesario en función de las instantáneas diarias.<br>El Datamart de informes también contiene vistas que decoran ciertos hechos y simplifican aún más las consultas para los clientes.<br>Se permite el acceso directo al Datamart de informes (previa solicitud) a una amplia gama de clientes, tanto minoristas como proveedores (sujeto a aprobaciones).</p>                                                                                                                    |
| <p>Insights<br>\[próximamente]</p>              | <p>Una serie de vistas construidas sobre el Datamart de informes que proporcionan Insights preconstruidos solicitados habitualmente por los clientes. Por ejemplo:<br>Efectividad de la campaña (estadísticas de anuncios logradas, p. ej., CTR/ROAS)<br>Tasas de cobertura de inventario (% de solicitudes que se cubren con publicidad pagada)<br>Cuota de voz (cuota de impresiones del proveedor por categoría/término de búsqueda, etc.)<br>Facturación (gasto de la cartera por campaña por período de tiempo)<br><br>Se permite el acceso a la capa de Insights (previa solicitud) a una amplia gama de clientes, tanto minoristas como proveedores (sujeto a aprobaciones).<br>Este documento también comparte el código SQL utilizado para construir la capa de Insights, de modo que los clientes que copien el Datamart de informes a su almacén de datos puedan entender cómo replicar fácilmente la lógica.</p> |
| <p>Visualización<br>\[lanzamiento limitado]</p> | <p>Una serie de vistas construidas sobre el Datamart de informes y la capa de Insights que proporciona los datos equivalentes a los que se ven en la plataforma BI heredada.<br>Actualmente se permite el acceso a la capa de Visualización (previa solicitud) a clientes, tanto minoristas como proveedores, que requieran acceso a los datos exactamente como se presentaban en nuestra plataforma BI heredada (sujeto a aprobaciones).<br>NOTA: A menos que sea necesario conciliar exactamente con la plataforma BI heredada, se aconseja utilizar en su lugar los equivalentes del Datamart de informes o de la capa de Insights. También contienen datos más granulares durante períodos de tiempo más largos.</p>                                                                                                                                                                                                     |

## Modelo de datos lógico

Según su tipo de acceso, los datos disponibles incluyen muchas áreas temáticas solicitadas habitualmente de la Epsilon Retail Media plataforma como:

(consulte el Glosario para ver más definiciones)

* Datos dimensionales
  * Campañas
  * Catálogos de productos
  * Productos
  * Equipos
    * Minoristas
    * Proveedores
  * Carteras
  * Términos de búsqueda
  * Categorías
  * Ubicaciones
* Datos de hechos
  * Estadísticas de solicitudes de anuncios (número de solicitudes por término de búsqueda o categoría, etc.)
  * Estadísticas de anuncios logradas (impresiones/clics/gasto publicitario por término de búsqueda o categoría, etc.)
  * Estadísticas de atribución mejoradas (solo donde esté configurado: atribución view-through por impresión, atribución de clics por efecto halo, etc.)
  * Estadísticas de gasto de campaña FTA
  * Resúmenes de transacciones del libro mayor (información de facturación, recargas de billetera, etc.)
  * Estadísticas de pedidos

La API de informes se utiliza típicamente para compartir los esquemas dentro del conjunto de datos principal o del Datamart de informes. Ambos esquemas cubren las áreas temáticas mencionadas anteriormente, solo que a diferentes niveles de agregación (el conjunto de datos principal ofrece detalles a nivel de transacción para hechos, así como agregados).

<figure><img src="/files/FNPYy3L6nZ7eZvAqePOT" alt="Namespace Diagram" width="100%"><figcaption></figcaption></figure>

## Tipo de usuario

Las áreas temáticas que podrá ver estarán restringidas según lo que su organización tenga derecho a ver. Existen 4 tipos de acceso organizacional:

* Nivel de espacio de nombres: un cliente que controla una red completa de equipos (tanto equipos de proveedores como de minoristas). El acceso a nivel de espacio de nombres otorga visibilidad a todos los datos para una implementación dada de Epsilon Retail Media.
* Nivel de minorista: un cliente que es un equipo minorista específico (o un grupo de equipos minoristas) únicamente.
* Nivel de proveedor: un cliente que es un equipo de proveedor específico (o un grupo de equipos de proveedores) únicamente.
  * Nivel de integrador: una extensión del nivel de proveedor, excepto que tienen acceso completo a ciertos objetos a nivel de minorista (solo a discreción del minorista).

Estas son las áreas temáticas clave que se cubren y cómo se aplican a los 3 tipos de acceso.

| Área temática                                                                     | Espacio de nombres | Minorista                                                                                                  | Proveedor                                                                                                           | Integrador                                                                                                          |
| --------------------------------------------------------------------------------- | ------------------ | ---------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| Campañas                                                                          | Todos los datos    | Relacionado con el equipo o equipos minoristas                                                             | Relacionado con el equipo o equipos proveedores                                                                     | Relacionado con el equipo o equipos proveedores                                                                     |
| Catálogos de productos                                                            | Todos los datos    | Relacionado con el equipo o equipos minoristas                                                             | Sin datos                                                                                                           | Relacionado con el equipo o equipos minoristas que hayan otorgado aprobación al integrador                          |
| Productos                                                                         | Todos los datos    | Relacionado con el equipo o equipos minoristas                                                             | Solo para productos que aparecen en la tabla supplier\_product de Realised Ad Statistics únicamente                 | Relacionado con el equipo o equipos minoristas que hayan otorgado aprobación al integrador                          |
| Equipos                                                                           | Todos los datos    | Relacionado con el equipo o equipos minoristas                                                             | Relacionado con el equipo o equipos proveedores                                                                     | Relacionado con el equipo o equipos proveedores                                                                     |
| Minoristas                                                                        | Todos los datos    | Relacionado con el equipo o equipos minoristas                                                             | Solo para minoristas que aparecen en la tabla supplier\_retailer de Realised Ad Statistics únicamente               | Solo para minoristas que aparecen en Realised Ad Statistics                                                         |
| Proveedores                                                                       | Todos los datos    | Solo para los proveedores que aparecen en la tabla retailer\_supplier de Realised Ad Statistics únicamente | Relacionado con el equipo o equipos proveedores                                                                     | Relacionado con el equipo o equipos proveedores                                                                     |
| Carteras                                                                          | Todos los datos    | Billeteras de equipos minoristas únicamente                                                                | Billeteras de equipos proveedores únicamente                                                                        | Billeteras de equipos proveedores únicamente                                                                        |
| Términos de búsqueda                                                              | Todos los datos    | Relacionado con el equipo o equipos minoristas                                                             | Solo para términos de búsqueda que aparecen en Realised Ad Statistics (solo aparece tal cual en la tabla de hechos) | Solo para términos de búsqueda que aparecen en Realised Ad Statistics (solo aparece tal cual en la tabla de hechos) |
| Categorías                                                                        | Todos los datos    | Relacionado con el equipo o equipos minoristas                                                             | Solo para categorías que aparecen en Realised Ad Statistics (solo aparece tal cual en la tabla de hechos)           | Solo para categorías que aparecen en Realised Ad Statistics (solo aparece tal cual en la tabla de hechos)           |
| Estadísticas de solicitudes de anuncios                                           | Todos los datos    | Relacionado con el equipo o equipos minoristas                                                             | Sin datos                                                                                                           | Sin datos                                                                                                           |
| Estadísticas de atribución mejoradas                                              | Todos los datos    | Relacionado con el equipo o equipos minoristas                                                             | Relacionado con el equipo o equipos proveedores                                                                     | Relacionado con el equipo o equipos proveedores                                                                     |
| Estadísticas de gasto de campaña FTA                                              | Todos los datos    | Relacionado con el equipo o equipos minoristas                                                             | Relacionado con el equipo o equipos proveedores                                                                     | Relacionado con el equipo o equipos proveedores                                                                     |
| Resúmenes de transacciones del libro mayor                                        | Todos los datos    | Billeteras de equipos minoristas únicamente                                                                | Billeteras de equipos proveedores únicamente                                                                        | Billeteras de equipos proveedores únicamente                                                                        |
| Estadísticas de pedidos                                                           | Todos los datos    | Relacionado con el equipo o equipos minoristas                                                             | Sin datos                                                                                                           | Sin datos                                                                                                           |
| Estadísticas de anuncios realizados (impresiones/clics, gasto publicitario, etc.) | Todos los datos    | Relacionado con el equipo o equipos minoristas                                                             | Relacionado con el equipo o equipos proveedores                                                                     | Relacionado con el equipo o equipos proveedores                                                                     |
| Ubicaciones                                                                       | Todos los datos    | Relacionado con el equipo o equipos minoristas                                                             | Solo para ubicaciones que aparecen en Ad Request y Realised Ad Statistics.                                          | Relacionado con el equipo o equipos minoristas que hayan otorgado aprobación al integrador                          |

## Método de acceso de usuario

Existen dos tipos de métodos de acceso, según las plataformas en la nube que utilice.

| Tipo de usuario                               | Método de acceso                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| --------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Usuario nativo de Google Cloud Platform (GCP) | Acceso directo Como nuestro almacén de datos está desplegado en BigQuery (el servicio de almacén de datos de GCP), los clientes que utilicen GCP podrán acceder directamente a los conjuntos de datos. Esto le permitirá ver los objetos y consultarlos a través de la interfaz de usuario de BigQuery en su propio proyecto de GCP. Solo necesita proporcionarnos una dirección de correo electrónico de su proyecto de GCP y le otorgaremos los privilegios correspondientes (sujeto a aprobaciones). Tenga en cuenta que los usuarios de acceso directo también pueden hacer llamadas a la API de BigQuery a través de scripts, etc. (además de usar la API de BigQuery). |
| Otros usuarios (que no son de GCP)            | API Si no está en GCP (por ejemplo, Azure o AWS), entonces Epsilon Retail Media creará una cuenta para usted (cuenta de servicio) y le proporcionará las credenciales (sujeto a aprobaciones). Esta cuenta le dará acceso únicamente a nivel de la API de BigQuery (no podrá acceder a la consola en la nube).                                                                                                                                                                                                                                                                                                                                                               |

Versión: 1ace13f


---

# 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/integration/es/reporting/reporting-overview.md?ask=<question>&goal=<endgoal>
```

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