Arquitectura física
La API de informes de CitrusAd proporciona acceso seguro al almacén de datos de CitrusAd. El almacén de datos contiene datos e información obtenidos de la plataforma de CitrusAd.
El almacén de datos de CitrusAd es un modelo distribuido. Algunos datos se conservan localmente en las instancias de la plataforma CitrusAd, otros en un almacén de datos centralizado y global.
El siguiente diagrama muestra la estructura del modelo de datos.
| Capa | Descripción |
|---|---|
| Datos de la plataforma | Origen de datos de la plataforma de CitrusAd. La propia plataforma se distribuye en varias 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. No se permite el acceso directo a los datos de la plataforma a conexiones externas. |
| Datos almacenados provisionalmente | Los datos relevantes de la plataforma se almacenan temporalmente en el almacén de datos casi en tiempo real. Los datos provisionales se mantienen por instancia de plataforma en la misma ubicación física que los datos de plataforma. Por lo general, no se permite el acceso directo a los datos almacenados a las conexiones externas. |
| Conjunto de datos principal | Diariamente, los procesos por lotes toman los datos por etapas y los modelan en un esquema de copo de nieve fácil de usar denominado conjunto de datos principal. El conjunto de datos principal también se mantiene por instancia de plataforma en la misma ubicación física que los datos almacenados temporalmente y los datos de la plataforma. Cada hecho del conjunto de datos principal está disponible tanto en la transacción individual como en el nivel de detalle agregado. El seguimiento de los cambios también está presente en muchas dimensiones. Se permite el acceso directo a los conjuntos de datos principales (previa solicitud) a determinados clientes, principalmente a nivel minorista (previa autorización). |
| Conjuntos de datos principales agregados | Una vez actualizados los conjuntos de datos principales, los procesos por lotes toman los conjuntos de datos principales individuales y los transfieren a una ubicación centralizada (el almacén de datos global). A continuación, los conjuntos de datos principales individuales se consolidan en un único conjunto de datos principal agregado unificado. Tenga en cuenta que en el almacén global de datos solo se almacenan datos agregados de hechos (no datos transaccionales). Por lo general, no se permite el acceso directo al conjunto de datos principal agregado a las conexiones externas. |
| Datamart de informes | Una vez actualizado el conjunto de datos principal agregado, los procesos diarios por lotes calculan un datamart de informes más simplificado y agregado. Al igual que los conjuntos de datos principales, el datamart de informes también es un esquema de 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, basándose en instantáneas diarias. El datamart de informes también contiene vistas que decoran ciertos hechos y simplifican aún más las consultas para los clientes. Se permite el acceso directo al datamart de informes (previa solicitud) a una amplia gama de clientes, tanto minoristas como proveedores (previa autorización). |
| Perspectivas [próximamente] | Una serie de vistas creadas sobre el datamart de informes que proporcionan información prediseñada que suelen solicitar los clientes. Por ejemplo: Eficacia de la campaña (estadísticas de los anuncios realizados, como CTR/ROAS) Índices de llenado del inventario (% de solicitudes que se llenan con publicidad de pago) Cuota de voz (porcentaje de impresiones de los proveedores por categoría o término de búsqueda, etc.) Facturación (gasto del monedero por campaña y período) El acceso a la capa de información está permitido (previa solicitud) a una amplia gama de clientes, tanto minoristas como proveedores (sujeto a aprobaciones). Este documento también comparte el código SQL utilizado para crear la capa de información, 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. |
| Visualización [difusión limitada] | Una serie de vistas construidas sobre el datamart de informes y la capa de información que proporcionan los datos equivalentes a los que se ven en la plataforma de BI heredada. Actualmente, se permite el acceso a la capa de visualización (previa solicitud) a los clientes, tanto minoristas como proveedores que requieren acceso a los datos exactamente como se presentaron en nuestra plataforma de BI heredada (sujeto a aprobaciones). NOTA: A menos que sea necesario conciliar exactamente la plataforma de BI heredada, se recomienda utilizar los equivalentes del datamart de informes o de la capa de información. También contienen datos más detallados sobre períodos más largos. |
Modelo lógico de datos
Dependiendo de su tipo de acceso, los datos disponibles incluyen muchas de las áreas temáticas más solicitadas de la plataforma de CitrusAd, como:
(consulte el glosario para obtener más definiciones)
- Datos dimensionales
- Campañas
- Catálogos de productos
- Productos
- Equipos
- Minoristas
- Proveedores
- Monederos
- Términos de búsqueda
- Categorías
- Ubicaciones
- Datos fácticos
- Estadísticas de solicitudes de anuncios (número de solicitudes por término de búsqueda o categoría, etc.)
- Estadísticas de anuncios realizados (impresiones/clics/gasto publicitario por término de búsqueda o categoría, etc.)
- Estadísticas de atribución mejoradas (solo cuando están configuradas: vista de impresión a través de atribución, atribución de clics de halo, etc.)
- Estadísticas de gasto de campaña de FTA
- Resúmenes de transacciones contables (información de facturación, recargas de monedero, etc.)
- Estadísticas de pedidos
La API de generación de informes se utiliza normalmente para compartir los esquemas dentro del conjunto de datos principal o el datamart de informes. Ambos esquemas cubren las áreas temáticas mencionadas anteriormente, solo en diferentes niveles de agregación (el conjunto de datos principal que ofrece detalles a nivel de transacción para hechos y agregados).
Tipo de usuario
Las áreas temáticas que podrá ver se restringirán de acuerdo con lo que su organización tiene derecho a ver. Hay 4 tipos de acceso organizativo:
- Nivel de espacio de nombres: Un cliente que controla toda una red de equipos (tanto equipos de proveedores como de minoristas). El acceso a nivel de espacio de nombres otorga visibilidad a todos los datos de una implementación determinada de CitrusAd.
- Nivel minorista: Un cliente que es solo un equipo minorista específico (o un grupo de equipos minoristas).
- Nivel de proveedor: Un cliente que solo es un equipo proveedor específico (o un grupo de equipos proveedores).
- Nivel integrador: Una extensión del nivel de proveedor, salvo por el hecho que ofrece acceso a determinados objetos del nivel de minorista en su totalidad (solo a discreción del minorista).
Estas son las áreas temáticas clave que se cubren y la forma como se aplican a los 3 tipos de acceso.
| Área temática | Espacio de nombres | Minorista | Proveedor | Integrador |
|---|---|---|---|---|
| Campañas | Todos los datos | Relacionados con los equipos minoristas | Relacionados con los equipos proveedores | Relacionados con los equipos proveedores |
| Catálogos de productos | Todos los datos | Relacionados con los equipos minoristas | Sin datos | Relacionados con los equipos minoristas que han concedido la aprobación al integrador |
| Productos | Todos los datos | Relacionados con los equipos minoristas | Solo para los productos que aparecen en la tabla supplier_product de estadísticas de anuncios realizados | Relacionados con los equipos minoristas que han concedido la aprobación al integrador |
| Equipos | Todos los datos | Relacionados con los equipos minoristas | Relacionados con los equipos proveedores | Relacionados con los equipos proveedores |
| Minoristas | Todos los datos | Relacionados con los equipos minoristas | Solo para los minoristas que aparecen en la tabla supplier_retailer de estadísticas de anuncios realizados | Solo para los minoristas que aparecen en las estadísticas de anuncios realizados |
| Proveedores | Todos los datos | Solo para los proveedores que aparecen en la tabla retailer_supplier de estadísticas de anuncios realizados | Relacionados con los equipos proveedores | Relacionados con los equipos proveedores |
| Monederos | Todos los datos | Solo monederos de equipos minoristas | Solo monederos de equipos proveedores | Solo monederos de equipos proveedores |
| Términos de búsqueda | Todos los datos | Relacionados con los equipos minoristas | Solo para los términos de búsqueda que aparecen en las estadísticas de anuncios realizados (solo aparece tal cual en la tabla de hechos) | Solo para los términos de búsqueda que aparecen en las estadísticas de anuncios realizados (solo aparece tal cual en la tabla de hechos) |
| Categorías | Todos los datos | Relacionados con los equipos minoristas | Solo para las categorías que aparecen en las estadísticas de anuncios realizados (solo aparece tal cual en la tabla de hechos) | Solo para las categorías que aparecen en las estadísticas de anuncios realizados (solo aparece tal cual en la tabla de hechos) |
| Estadísticas de solicitudes de anuncios | Todos los datos | Relacionados con los equipos minoristas | Sin datos | Sin datos |
| Estadísticas de atribuciones mejoradas | Todos los datos | Relacionados con los equipos minoristas | Relacionados con los equipos proveedores | Relacionados con los equipos proveedores |
| Estadísticas de gasto de campaña de FTA | Todos los datos | Relacionados con los equipos minoristas | Relacionados con los equipos proveedores | Relacionados con los equipos proveedores |
| Resúmenes de transacciones contables | Todos los datos | Solo monederos de equipos minoristas | Solo monederos de equipos proveedores | Solo monederos de equipos proveedores |
| Estadísticas de pedidos | Todos los datos | Relacionados con los equipos minoristas | Sin datos | Sin datos |
| Estadísticas de anuncios realizados (impresiones/clics, gastos de publicidad, etc.) | Todos los datos | Relacionados con los equipos minoristas | Relacionados con los equipos proveedores | Relacionados con los equipos proveedores |
| Ubicaciones | Todos los datos | Relacionados con los equipos minoristas | Solo para las ubicaciones que aparecen en las estadísticas de solicitudes de anuncios y anuncios realizados. | Relacionados con los equipos minoristas que han concedido la aprobación al integrador |
Método de acceso de usuario
Existen dos tipos de método de acceso, dependiendo de las plataformas en nube utilizadas.
| Tipo de usuario | Método de acceso |
|---|---|
| Usuario nativo de Google Cloud Platform (GCP) | Acceso directo Dado que nuestro almacén de datos se implementa en BigQuery (el servicio de almacenamiento de datos de GCP), los clientes que estén en 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 GCP. Solo tiene que facilitarnos una dirección de correo electrónico de su proyecto GCP y le concederemos los privilegios correspondientes (pendientes de aprobación). Tenga en cuenta que los usuarios de Direct Access también pueden realizar llamadas a la API de BigQuery a través de scripts, etc. (además de utilizar la API de BigQuery). |
| Otros usuarios (que no usen GCP) | API Si no utiliza GCP (por ejemplo, Azure o AWS), CitrusAd creará una cuenta para usted (cuenta de servicio) y le proporcionará las credenciales (pendientes de aprobación). Esta cuenta le proporcionará acceso solo a nivel de la API de BigQuery (no le permitirá acceder a la consola en la nube). |
Versión: f34ea10