Partager via

API de plateforme numérique - Vérifier les statistiques d’utilisation

Avertissement

Avis alpha-bêta

Ce champ ou cette fonctionnalité fait partie de la fonctionnalité actuellement en phase Alpha ou Bêta. Il est donc susceptible d’être modifié.

Appel d’API REST

Lorsque vous effectuez un appel à l’API pour récupérer des statistiques, les champs suivants peuvent être définis dans la chaîne de requête :

  • agg peut être omis afin d’obtenir un rapport horaire/détaillé.
  • agg=true peut être utilisé pour obtenir un rapport agrégé.
  • start la date doit être définie au format suivant : 2015-11-01+01:00:00.
  • end la date doit être définie au format suivant : 2015-12-01+01:00:00.
curl -H "Authorization: hbapi:123456:9876abcd54321:nym2"-XGET"https://streaming-data.appnexus.com/rt-segment-processed?member_id=100&start=2014-05-22+00:00:00&end=2014-05-22+01:00:00"

Les statistiques sont dédupliquées par requête adressée au service. Par exemple, si le même utilisateur est ajouté au même segment dans trois requêtes différentes et num_valid_addsnum_valid_users affiche "3". Lors de l’utilisation agg=truede , il y aura une entrée dans la propriété de rapport de la réponse. Il s’agit d’une agrégation de toutes les statistiques d’utilisation dans la plage de dates spécifiée. error_log_lines et segment_log_lines sont vides, et l’heure de traitement correspond à la dernière heure de la plage de dates spécifiée. Toutefois, si aucune plage de dates n’est spécifiée, le rapport affiche les données des deux dernières semaines.

Exemple : rapport d’utilisation agrégée

{
    "response": {
        "report": {
            "error_log_lines": null,
            "match_rate": 87.7,
            "member_id": 123,
            "num_inactive_segments": 0,
            "num_invalid_segments": 0,
            "num_invalid_users": 25,
            "num_other_errors": 0,
            "num_unauth_segments": 0,
            "num_valid_adds": 181,
            "num_valid_removes": 2,
            "num_valid_users": 179,
            "processed_hour": "2015-11-08 01:00:00",
            "segment_log_lines": null
        },
        "status": "OK"
    }
}

Exemple : rapport horaire

{
    "response": {
        "report": [
            {
                "error_log_lines": "",
                "match_rate": 100.0,
                "member_id": 123,
                "num_inactive_segments": 0,
                "num_invalid_segments": 0,
                "num_invalid_users": 0,
                "num_other_errors": 0,
                "num_unauth_segments": 0,
                "num_valid_adds": 2,
                "num_valid_removes": 0,
                "num_valid_users": 1,
                "processed_hour": "2015-11-03 18:00:00",
                "segment_log_lines": "Valid users: 1580557697843484206
Valid segments (id, code, segment owner member id): (3737552, 'segment_3737552', 123), (3737547, 'segment_3737547', 123)
Valid additions (user id, segment id, expiration): (1580557697843484206, 3737552, 1440), (1580557697843484206, 3737547, 1440)"
            },
            {
                "error_log_lines": "Inactive users: 15805576978434842
Inactive segments (id, code, segment owner member id): (321456, 'segment_312456', 123)
Invalid segments (id, code, segment owner member id): (0, 'segment_654321', 123)
Unauthorized segments (id, code, segment owner member id): (0, 'segment_123456', 123)",
                "match_rate": 50.0,
                "member_id": 123,
                "num_inactive_segments": 1,
                "num_invalid_segments": 1,
                "num_invalid_users": 1,
                "num_other_errors": 0,
                "num_unauth_segments": 1,
                "num_valid_adds": 0,
                "num_valid_removes": 2,
                "num_valid_users": 1,
                "processed_hour": "2015-11-03 19:00:00",
                "segment_log_lines": "Valid users: 1580557697843484206
Valid segments (id, code, segment owner member id): (3737552, 'segment_3737552', 123), (3737547, 'segment_3737547', 123)
Valid removals (user id, segment id, expiration): (1580557697843484206, 3737552, -1), (1580557697843484206, 3737547, -1)"
            }
        ]
    }
    }

Objet de rapport JSON pour les objets dans le tableau de rapports

Nom du champ Description Exemple de valeur
processed_hour Heure pendant laquelle les chargements ont été effectuées. "2014-05-22 00:00:00"
match_rate Pourcentage d’utilisateurs valides chargés (num_valid_users/(num_valid_users+num_invalid_users)). 75.00
num_valid_users Nombre total d’utilisateurs valides qui ont été diffusés en continu via le service. Il ne s’agit PAS du nombre d’utilisateurs uniques pour l’heure. 124578
num_valid_adds Nombre total d’associations ajoutées (c’est-à-dire, paires utilisateur-segment, expiration !=-1). 98765432
num_valid_removes Nombre total d’associations supprimées (c’est-à-dire, paires utilisateur-segment avec expiration = -1). 98765432
num_invalid_users Nombre total d’utilisateurs qui étaient dans des demandes, mais qui n’existent pas sur la plateforme de Xandr. 4000
num_unauth_segments Nombre total d’associations ayant échoué en raison d’une tentative d’accès à des segments non autorisés. 500
num_inactive_segments Nombre total d’associations ayant échoué en raison d’une tentative d’accès à des segments inactifs. 200
num_invalid_segments Nombre total d’associations ayant échoué en raison d’une tentative d’accès à des segments non valides. 3
num_other_errors Nombre total d’appels ayant échoué pour d’autres raisons. 0
error_log_lines Exemple de ligne 200 mis à jour des erreurs qui ont empêché la réussite des associations d’utilisateurs et de segments. "Inactive users: 15805576978434842 Inactive segments (id, code, segment owner member id): (321456, 'segment_312456', 123)
Invalid segments (id, code, segment owner member id): (0, 'segment_654321', 123)
Unauthorized segments (id, code, segment owner member id): (0, 'segment_123456', 123)"
segment_log_lines Un exemple de ligne 200 mis à jour des segments et le nombre d’associations valides pour chacun d’eux. "Valid users: 1580557697843484206
Valid segments (id, code, segment owner member id): (3737552, 'segment_3737552', 123), (3737547, 'segment_3737547', 123)
Valid additions (user id, segment id, expiration): (1580557697843484206, 3737552, 1440), (1580557697843484206, 3737547, 1440)
Valid removals (user id, segment id, expiration): (1580557697843484206, 3737552, -1), (1580557697843484206, 3737547, -1)"
  • Last updated on