/message/stats
Obtiene el resumen y estadísticas de una campaña o mensaje de automatización.
| Parámetros |
| Nombre |
Descripción |
message_id
integer |
ID numérico del mensaje. Puede ser mensaje de campaña o de automatización. |
nocache
boolean |
El sistema almacena los últimos datos de las estadísticas en memoria cache. Utilice este parámetro en TRUE para volver a calcular las estadísticas. Esto podría demorar un tiempo más en devolver el resultado. |
| Valores de retorno |
| status |
Devuelve el estado actual del mensaje. “completed”, “scheduled”, “stopped”, “saved”, “sending”, “restarting”. |
| recipients |
Número de destinatarios total. |
| from_name |
Nombre del remitente. |
| from_mail |
Email del remitente. |
| track_opens |
Opción para seguimiento de aperturas. 1 define activado. |
| track_clicks |
Opción para seguimiento de clicks. 1 define activado. |
| g_analytics |
Opción para integración con Google Analytics. 1 define activado. |
| clicktale |
Opción para integración con ClickTale. 1 define activado. |
| date_created |
Fecha de creación del mensaje en formato UNIX. |
| date_start |
Fecha de inicio del envío del mensaje en formato UNIX. Solo para campañas. |
| date_completed |
Fecha de envío completado en formato UNIX, solo para campañas. |
| lists |
Array de listas de destinatarios.
| name |
Nombre de la lista. |
| list_id |
ID de la lista. |
|
| stats |
Estadísticas del mensaje.
| sent |
Array con la cantidad de emails enviados.
| value |
Cantidad numérica. |
| per |
Porcentaje relativo a la cantidad de suscriptores. |
|
| not_sent |
Array con la cantidad de emails no enviados.
| value |
Cantidad numérica. |
| per |
Porcentaje relativo a la cantidad de suscriptores. |
|
| delivered |
Array con la cantidad de emails entregados.
| value |
Cantidad numérica. |
| per |
Porcentaje relativo a la cantidad de suscriptores. |
|
| pending |
Array con la cantidad de emails pendientes de envío.
| value |
Cantidad numérica. |
| per |
Porcentaje relativo a la cantidad de suscriptores. |
|
| bounced |
Array con la cantidad de emails rechazados.
| value |
Cantidad numérica. |
| per |
Porcentaje relativo a la cantidad de emails enviados. |
| type |
Array. Tipos de rechazo, “soft”, “hard”, “spam”, “invalid”. (Ver detalles debajo).
soft/hard/spam/invalid
Array |
| value |
Valor numérico total |
| per |
Porcentaje relativo a la cantidad de rechazados |
| abs_per |
Porcentaje relativo a la cantidad de emails enviados |
|
|
|
| unsubscribed |
Array con la cantidad de emails desuscriptos.
| value |
Cantidad numérica. |
| per |
Porcentaje relativo a la cantidad de emails entregados. |
|
| opens |
Array con la cantidad de aperturas.
| value |
Cantidad numérica de suscriptores que abrieron el email. |
| per |
Porcentaje relativo a la cantidad de emails entregados. |
| total |
Total de aperturas incluyendo repeticiones. |
| ratio |
Diferencia entre aperturas totales y únicas (suscriptores). |
| firstDayReads |
Dia de la primera apertura. Array. |
| data |
Array con los datos de aperturas por días de la semana y horas del día. |
|
| clicks |
Array con la cantidad de emails desuscriptos.
| unique |
Clicks únicos. |
| total |
Porcentaje relativo a la cantidad de emails entregados. |
| subscribers |
Cantidad de suscriptores que hicieron click en uno o más enlaces |
| data_list |
Array con la información de los links y clicks.
| link |
URL del link html escaped. |
| url |
URL del link. |
| clicks |
Cantidad de suscriptores que hicieron click. |
| clicks_totales |
Cantidad de clicks. |
| id |
ID numérico del link. |
|
| per |
Porcentaje de clicks/suscriptores relativo a la cantidad de emails entregados. |
|
| referred |
Array con la cantidad de emails desuscriptos.
| value |
Cantidad numérica de referidos. |
| reads |
Array con la información de aperturas de los referidos.
| value |
Cantidad numérica de aperturas. |
| per |
Porcentaje de aperturas relativo a la cantidad de referidos. |
|
| per |
Porcentaje de clicks/suscriptores relativo a la cantidad de emails entregados. |
|
| complaints |
Array con la cantidad de emails suscriptores que han marcado el email como spam.
| value |
Cantidad numérica. |
| per |
Porcentaje relativo a la cantidad de emails entregados. |
|
| device |
Array con la estadística de dispositivos utilizados para leer los emails. |
| device_data |
Array con la estadística de dispositivos utilizados para leer los emails. |
| ctr |
Porcentaje decimal Click-Through Rate (relativo a los emails entregados). |
| ctor |
Porcentaje decimal Click-Through Open Rate (relativo a las aperturas). |
|
| Códigos de error |
| M05101D |
Mensaje no encontrado. |
Estados del mensaje de campaña
- completed: El mensaje ha sido enviado a toda la lista de suscriptores.
- scheduled: el mensaje esta programado para ser enviado en la fecha determinada por el usuario.
- stopped: el mensaje se ha detenido y no continua enviándose. Permite reanudar el envío.
- sending: el mensaje esta actualmente enviándose a la lista de suscriptores. La estadística de envía indicara la cantidad y porcentaje de enviados.
- restarting: el mensaje ha sido reiniciado y esta en espera de continuar su envío.
- starting: el mensaje esta iniciando su envío.
Estadística de rechazados
En la variable stats.bounced se detallan los emails rechazados. “type” define el tipo de rechazo, siendo “hard” y “soft” las categorías padre, donde “hard” son rechazados permanentes” y “soft” son rechazados temporales, como podría ser rechazado por casilla llena.
Los tipos “invalid” y “spam” son subcategorías de “hard” y “soft” respectivamente. “invalid” se refiere a los rechazados cuando la casilla de email no existe y “spam” se refiere a cuando el rechazo es a causa de que el email fue interpretado como SPAM. El sistema trata a los rechazados “spam” como temporales.
