Statistics

Este microservicio permite consultar e insertar estadísticas de cualquier fuente. Creado con el fin de recibir y procesar peticiones muy personalizadas.

https://statistics.service.wortise.com

Statistics es uno de los microservicios más importantes. Es esencial que se le preste mucha atención a esta documentación y sus detalles.

Estructura de la estadística

Para comenzar, es importante saber qué atributos tiene cada estadística. De esta forma se comprenderá qué datos tenemos, qué cosas pueden agruparse y cuáles son las limitaciones.

Esta es una tabla donde se especifica cada dato con su correcta nomenclatura:

Atributo	Nombre técnico	Tipo de dato
Fecha y hora	date	String
Cuenta	account	String
Plataforma	platform	String
Categoría	category	String
Aplicación	asset	String
Unidad de anuncio	adunit	String
Tipo de unidad de anuncio	type	String
Fuente	source	String
País	country	String
Campaña	campaign	Long
Creativo	banner	Long
Red	network	String
Canal de demanda	demandChannel	String
Socio de rendimiento	partner	String
Anunciante	advertiser	String
Comprador	buyer	String
Peticiones	requests	Long
Impresiones	impressions	Long
Visibilidad	viewability	Long
Clicks	clicks	Long
Ganancia	revenue	Float
Ganancia base	baseRevenue	Float

Atributo

Nombre técnico

Tipo de dato

Fecha y hora

date

String

Cuenta

account

String

Plataforma

platform

String

Categoría

Generación del revenue

Las fórmulas matemáticas, que llevan a cabo la generación del revenue final, descontando comisiones, son las siguientes:

Este es un vistazo general y no contempla comisiones como AdServing fee o canal de demanda Ad Server.

br      = Base Revenue
r       = Final Revenue
fee     = Comisión Wortise
partner = Comisión Partner

1) r = br - br * (fee * -1)

2) r = r - r * (partner / 100)

Agrupaciones

Este servicio utiliza agrupaciones para consultar estadísticas a nuestras bases de datos. Este sistema es muy similar a la estructura dimensión-columna que podemos encontrar en Google Ad Manager.

Las columnas ya están configuradas y pre-seleccionadas (todas) en las consultas a este servicio. Pero en cambio, las dimensiones si son configurables.

Si tuviéramos que identificar a cada atributo de la estadística como dimensión o columna, quedaría así:

date
account (accounts)
platform (platforms)
category (categories)
asset (assets)
adunit (adunits)
type (types)
source (sources)
country (countries)
campaign (campaigns)
banner (banners)
network (networks)
demandChannel (demandChannels)
partner (partners)
advertiser (advertisers)
buyer (buyers)

Request

Ya con todos los conceptos básicos adquiridos, se puede avanzar con una consulta de ejemplo analizando su estructura:

Estadísticas Generales

POST https://statistics.service.wortise.com/pub

{
    "query": {
        "start": "2023-08-20",
        "end": "2023-08-25",
        "sources": [], // newton, sinew, gam, admob, unity, vungle
        "assets": [],
        "adunits": [],
        "types": [], // push, banner, interstitial, app_open, rewarded, native
        "countries": [],
        "categories": [],
        "accounts": [],
        "platforms": [], // android, ios, web
        "campaigns": [],
        "banners": [],
        "networks": [],
        "demandChannels": [], // Open Bidding, Ad Exchange, Ad server, Mediation, SDK Bidding
        "partners": [], // Meta, Magnite, YieldMo, AppLovin, etc.
        "advertisers": [], // Unclassified advertisers, Alibaba Group Holding, etc.
        "buyers": [] // Pangle, OneTag (EB), ScaleOut, Addictive Mobility, etc.
    },
    "interval": "day", // day, week, month, quarter, year, all
    "timezone": "America/Argentina/Buenos_Aires", // +02:00, -01:00, etc.
    "groupBy": [], // source, asset, category, adunit, country, account, campaign, banner, demandChannel, partner, advertiser, buyer
    "missing": true, // El default es false
    "monetizable": true // El default es true
}

La configuración missing, es para que las estadísticas que se analicen no tengan que obligatoriamente pertenecer a las dimensiones ingresadas (groupBy). En el caso de que la estadística no sea parte de las dimensiones seleccionadas, se devolverá como N/A.

Aunque, activar missing podría aumentar el tiempo de respuesta. Es altamente recomendable detectar en qué situaciones es necesario activarlo o no.

La configuración monetizable, tiene importancia solamente en la fuente Newton. Tenerla en true, hace que solo se traigan las estadísticas de campañas que generen revenue. Por ejemplo, evitaría que se traigan datos de campañas de Cross Promotion, los cuales tienen impresiones con revenue cero. Con esto evitamos, que por ejemplo, un publisher vea su eCPM bajo.

Información calculada por el SDK de Wortise

POST https://statistics.service.wortise.com/pub/sdk

{
    "query": {
        "start": "2023-08-20",
        "end": "2023-08-25",
        "accounts": [],
        "assets": []
    }
}

POST https://statistics.service.wortise.com/pub/v2/sdk

{
    "query": {
        "start": "2023-08-20",
        "end": "2023-08-25",
        "accounts": [],
        "assets": []
    },
    "interval": "day",
    "groupBy": [] // account, asset,
    "missing": true
}

La versión 2, ofrece agrupaciones. Pero, solo devolverá los totales de DAUs y MAUS.

Last updated 2 hours ago