Estadísticas de in-apps

Dos métodos devuelven estadísticas para campañas de in-apps instantáneas. Utilice inapps:totals para los totales del período en una o más campañas, y inapps:timeline para una serie temporal de una sola campaña. Los valores coinciden con la pantalla de estadísticas de in-apps en el Panel de Control.

In-apps enviadas desde un Journey

Estos métodos cubren únicamente las campañas de in-apps instantáneas. Las in-apps entregadas por un elemento de Customer Journey se reportan por punto del journey mediante Obtener estadísticas de Journey.

Métricas

Campo	Tipo	Descripción
impressions	número	Cuántas veces se mostró la in-app. Etiquetado como Impresiones en el Panel de Control.
unique_impressions	número	Número de dispositivos únicos a los que se mostró la in-app.
interactions	número	Interacciones con el contenido de la in-app: clics en botones, clics en enlaces y envíos de formularios.
unique_interactions	número	Número de dispositivos únicos que interactuaron con la in-app.
skips	número	Cuántas veces los usuarios descartaron la in-app sin interactuar.
audience	número	Número de dispositivos únicos que produjeron cualquier evento de in-app en el período.

Nota

Las métricas únicas y audience son aproximadas porque utilizan un recuento distintivo probabilístico. Las cifras de la plataforma no suman el total de la campaña: un dispositivo que aparece en dos plataformas se cuenta una vez en el desglose de cada plataforma y una vez en el total de la campaña.

inapps:totals

Devuelve los totales del período. Pase inapp_codes para informar sobre campañas específicas, u omítalo para recorrer cada in-app de la aplicación página por página. Ese es el método a utilizar para una exportación programada.

POST https://api.pushwoosh.com/api/v2/statistics/inapps:totals

Cabeceras

Nombre	Requerido	Descripción
Authorization	Sí	Token de API del servidor en el formato Authorization: Api <Server Key>.

Parámetros del cuerpo de la solicitud

Nombre	Requerido	Tipo	Descripción
application	Sí	String	Código de aplicación.
date_range	Sí	Object	Período de reporte. date_from y date_to usan el formato YYYY-MM-DD y son inclusivos. El período se cuenta en UTC y no debe exceder los 366 días.
inapp_codes	No	Array	Códigos de in-app, hasta 100 por solicitud. Omita para informar sobre todas las in-apps de la aplicación. Si algún código en la lista no pertenece a la aplicación, toda la solicitud falla con 404.
platforms	No	Array	Restringe las métricas a estas plataformas. Valores posibles: "IOS", "ANDROID", "HUAWEI_ANDROID", "AMAZON", "OSX", "WINDOWS", "SAFARI", "CHROME", "FIREFOX", "WEB".
with_platforms	No	Boolean	Agrega un desglose por plataforma a cada elemento.
page	No	Integer	Número de página, comenzando en 0. Se aplica cuando se omite inapp_codes.
per_page	No	Integer	Elementos por página, 20 por defecto, 100 como máximo.

Solicitud de ejemplo

curl -X POST https://api.pushwoosh.com/api/v2/statistics/inapps:totals \
  -H "Authorization: Api YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "application": "XXXXX-XXXXX",
    "date_range": {
      "date_from": "2026-07-01",
      "date_to": "2026-07-31"
    },
    "inapp_codes": ["AAAAA-BBBBB"],
    "with_platforms": true
  }'

Campos de respuesta

total es el número de in-apps que coinciden con la solicitud. Cuando se omite inapp_codes, son todas las in-apps de la aplicación, por lo que la paginación puede recorrerla. items contiene la página actual. page cuenta desde 0.

Respuesta de ejemplo

{
  "total": 1,
  "page": 0,
  "per_page": 20,
  "items": [{
    "inapp": {
      "code": "AAAAA-BBBBB",
      "name": "Summer sale",
      "status": "active",
      "rich_media_code": "CCCCC-DDDDD"
    },
    "metrics": {
      "impressions": 15230,
      "unique_impressions": 9120,
      "interactions": 2311,
      "unique_interactions": 1980,
      "skips": 640,
      "audience": 9120
    },
    "platforms": [{
      "platform": "IOS",
      "metrics": {
        "impressions": 8100,
        "unique_impressions": 4900,
        "interactions": 1300,
        "unique_interactions": 1120,
        "skips": 310,
        "audience": 4900
      }
    }],
    "frequency_capping": {
      "suppressions": 45,
      "affected_users": 30,
      "data_available_from": "2026-07-17"
    }
  }]
}

inapps:timeline

Devuelve los totales del período y una serie temporal para una campaña de in-app.

POST https://api.pushwoosh.com/api/v2/statistics/inapps:timeline

Parámetros del cuerpo de la solicitud

Nombre	Requerido	Tipo	Descripción
application	Sí	String	Código de aplicación.
inapp_code	Sí	String	Código de in-app.
date_range	Sí	Object	Período de reporte. date_from y date_to usan el formato YYYY-MM-DD y son inclusivos. El período se cuenta en UTC y no debe exceder los 366 días. interval opcional: "HOUR", "DAY" (predeterminado), "WEEK" o "MONTH". "HOUR" está disponible para períodos de hasta 31 días.
platforms	No	Array	Restringe las métricas a estas plataformas.
with_platforms	No	Boolean	Agrega un desglose por plataforma a los totales y a cada fila.

Solicitud de ejemplo

curl -X POST https://api.pushwoosh.com/api/v2/statistics/inapps:timeline \
  -H "Authorization: Api YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "application": "XXXXX-XXXXX",
    "inapp_code": "AAAAA-BBBBB",
    "date_range": {
      "date_from": "2026-07-01",
      "date_to": "2026-07-07",
      "interval": "DAY"
    }
  }'

Respuesta de ejemplo

{
  "inapp": {
    "code": "AAAAA-BBBBB",
    "name": "Summer sale",
    "status": "active",
    "rich_media_code": "CCCCC-DDDDD"
  },
  "totals": {
    "impressions": 15230,
    "unique_impressions": 9120,
    "interactions": 2311,
    "unique_interactions": 1980,
    "skips": 640,
    "audience": 9120
  },
  "frequency_capping": {
    "suppressions": 45,
    "affected_users": 30,
    "data_available_from": "2026-07-17"
  },
  "rows": [{
    "timestamp": "2026-07-01T00:00:00Z",
    "metrics": {
      "impressions": 2140,
      "unique_impressions": 1700,
      "interactions": 320,
      "unique_interactions": 290,
      "skips": 95,
      "audience": 1700
    }
  }],
  "impression_duration": [
    { "from_seconds": 0, "to_seconds": 5, "count": 3200 },
    { "from_seconds": 5, "to_seconds": 15, "count": 5400 },
    { "from_seconds": 15, "to_seconds": 30, "count": 4100 },
    { "from_seconds": 30, "to_seconds": 0, "count": 2530 }
  ]
}

impression_duration agrupa cuánto tiempo permaneció la in-app en la pantalla. En el último grupo, to_seconds es 0, lo que significa “30 segundos o más”.

Frequency capping

El bloque frequency_capping informa sobre las visualizaciones de in-apps que el frequency capping impidió, y el número de usuarios únicos afectados. Las supresiones no se cuentan en impressions.

Los datos de supresión comienzan el 17 de julio de 2026

Las supresiones no se registraron antes de esa fecha. Para un período que termina antes, el bloque frequency_capping regresa como null en lugar de ceros, para que la falta de datos nunca se confunda con un límite que no suprimió nada. data_available_from en la respuesta indica el primer día cubierto. El frequency capping no tiene un desglose por plataforma.

Retención de datos

Las estadísticas se conservan durante 365 días, por lo que un período que comience antes no devolverá datos para los días no cubiertos.

Códigos de respuesta

Código	Significado
200	Éxito.
400	Solicitud no válida: un date_range faltante o mal formado, un período superior a 366 días, un intervalo por hora de más de 31 días, o más de 100 inapp_codes.
401	Token de API faltante o no válido.
404	No se encontró un código de in-app en esta aplicación.