Passer au contenu

Statistiques de l'application et des abonnés

getAppStats

Anchor link to

Obtenez les statistiques d’une application spécifique pour une période définie.

POST https://cp.pushwoosh.com/json/1.3/getAppStats

Paramètres de la requête
Anchor link to
Nom
RequisTypeDescription
authOuistringJeton d’accès API depuis le Panneau de contrôle Pushwoosh.
applicationOuistringCode d’application Pushwoosh
datefromOuistringDate et heure de début de la période de reporting. Format : Y-m-d H:i:s.
datetoOuistringDate et heure de fin de la période de reporting. Format : Y-m-d H:i:s.
Exemple de requête
Anchor link to
{
"request": {
"auth": "yxoPUlwqm…………pIyEX4H", // requis. Jeton d'accès API depuis le Panneau de contrôle Pushwoosh
"application": "XXXXX-XXXXX", // requis. Code d'application Pushwoosh
"datefrom": "2013-06-04 00:00:00", // requis. Date et heure, début de la période de reporting
"dateto": "2013-06-07 00:00:00" // requis. Date et heure, fin de la période de reporting
}
}
Exemple de réponse
Anchor link to
{
"status_code": 200,
"status_message": "OK",
"response": {
"request_id": "c93a202f439235f9adaaa06d651548ab"
}
}

Comprendre les statistiques

Anchor link to

Les statistiques affichent les actions enregistrées pour une application, un appareil ou un message dans le laps de temps spécifié.

Les rapports sont automatiquement agrégés en utilisant les règles suivantes :

  • Annuel : Si la période est supérieure à un an.
  • Mensuel : Si la période est supérieure à un mois.
  • Quotidien : Si la période est supérieure à un jour.
  • Horaire : Si la période est supérieure à trois heures.
  • Par minute : Dans tous les autres cas.
Types d’action
Anchor link to
  • Niveau Application : _open_, _install_
  • Niveau Appareil : _register_, _unregister_
  • Niveau Message : _send_, _open_
Format de réponse
Anchor link to

Tous les objets de statistiques ont le même format :

Champ
TypeDescription
formatterstringÉchelle du rapport : annuel, mensuel, quotidien, horaire, par minute.
rowslistContient les données du rapport pour chaque action enregistrée.

Chaque ligne du rapport contient :

Champ
TypeDescription
countintNombre d’actions enregistrées.
actionstringLe type d’action enregistrée.
datetimestringDate formatée : Y-m-d H:i:s.

Récupération des résultats de la requête planifiée

Anchor link to
Corps de la réponse
Anchor link to
Champ
TypeDescription
request_idstringID de la requête planifiée. Référez-vous à /getResults pour plus de détails.
Corps de la réponse planifiée (/getResults)
Anchor link to
Champ
TypeDescription
applicationsdictionaryStatistiques pour les applications.
devicesdictionaryStatistiques pour les appareils.
messagesdictionaryStatistiques pour les messages.
{
"error": {
"code": 0,
"message": "OK"
},
"json_data": {
"applications": {
"formatter": "hourly",
"rows": [{
"count": 0,
"action": "open",
"datetime": "2013-06-06 00:00:00"
}, {
...
}]
}
}
}

getApplicationSubscribersStats

Anchor link to

Affiche la liste des abonnés de l’application, regroupée par type d’appareil.

POST https://api.pushwoosh.com/json/1.3/getApplicationSubscribersStats

Corps de la requête
Anchor link to
Nom
RequisTypeDescription
authOuistringJeton d’accès API depuis le Panneau de contrôle Pushwoosh.
applicationOuistringCode d’application Pushwoosh

Exemple de requête

{
"request": {
"auth": "yxoPUlwqm…………pIyEX4H", // requis. Jeton d'accès API depuis le Panneau de contrôle Pushwoosh
"application": "XXXXX-XXXXX" // requis. Code d'application Pushwoosh
}
}
{
"status_code": 200,
"status_message": "OK",
"response": {
"IOS": 1,
"ANDROID": 1,
"OSX": 0,
"WINDOWS": 0,
"AMAZON": 0,
"SAFARI": 0,
"FIREFOX": 0
}
}

getSubscribersStatistics

Anchor link to

Récupère les statistiques des abonnés de l’application pour une période donnée.

POST https://api.pushwoosh.com/api/v2/statistics/application/getSubscribersStatistics

| Nom

| Requis | Type | Description |
|-----------------|----------|--------|--------------------------------------------------------------------------------------------------------------|
| Authorization | Oui | string | Jeton d’accès API au format : Key PKX.......NHg. |
| Content-Type | Oui | string | Doit être défini sur application/json. |

Paramètres de la requête
Anchor link to

| Nom

| Requis | Type | Description |
|------------------|----------|--------|--------------------------------------------------------------------------|
| application_code | Oui | string | Code d’application Pushwoosh |
| timestamp_from | Oui | string | Date et heure de début de la période de statistiques (format : YYYY-MM-DD hh:mm:ss, UTC+0). |
| timestamp_to | Oui | string | Date et heure de fin de la période de statistiques (format : YYYY-MM-DD hh:mm:ss, UTC+0). |

Exemple de requête

Terminal window
curl --location --request POST 'https://go.pushwoosh.com/api/v2/statistics/application/getSubscribersStatistics' \
--header 'Authorization: Key 3a2X......828JreCk48f' \
--header 'Content-Type: application/json' \
--data-raw '{
"application_code": "12345-67890", // Code d'application Pushwoosh
"timestamp_from": "2022-08-01 00:00:00", // UTC+0
"timestamp_to": "2022-09-01 00:00:00" // UTC+0
}'

Exemple de réponse

{
"statistics": [{
"timestamp": "YYYY-MM-DD hh:mm:ss", // UTC+0
"platform": 1,
"push_enabled": 100,
"push_disabled": 100
}]
}

Codes de réponse

{
"statistics": [{
"timestamp": "YYYY-MM-DD hh:mm:ss",
"platform": 1,
"push_enabled": 100,
"push_disabled": 100
}]
}

Explication : La requête a réussi et les statistiques sont retournées.

Règles d’intervalle d’horodatage

Anchor link to

| Période demandée

| Intervalle dans la réponse
|
|-------------------|--------------------|
| Plus d’un an | 1 an |
| 1 an | 1 mois |
| 1 mois - 1 an | 1 jour |
| Moins d’un mois| 1 heure |