Spécification d'une date avant ou après laquelle les données doivent être prises en compte dans une URL d'API Indicateurs les plus importants avec des tendances

Vous pouvez configurer une URL d'API d'Indicateurs les plus importants avec tendances pour qu'elle prenne en compte les données avant ou après une certaine date. Par exemple, vous pouvez spécifier une date de la semaine précédente et renvoyer des résultats pour les 10 semaines précédentes. Vous pouvez aussi demander une date antérieure de plusieurs semaines et renvoyer des résultats de cette date à aujourd'hui.

Pourquoi et quand exécuter cette tâche

Vous pouvez demander une période quotidienne, hebdomadaire ou mensuelle.

Remarque : L'URL montrée ici est répartie sur plusieurs lignes pour des raisons de lisibilité. L'URL réelle ne comporte pas de sauts de ligne. Utilisez le nom de domaine de service IBM® Digital Analytics approprié pour votre organisation.

Procédure

  1. Ajoutez des valeurs de paramètre à une URL d'API d'Indicateurs les plus importants avec tendances.

    Utilisez la syntaxe suivante :

    https://welcome.coremetrics.com/analyticswebapp/api/1.0/
    toplinetrend-data/topline.ftl?clientId=id_client
    &username=nom_utilisateur&userAuthKey=jeton_API&language=Langue
    &viewID=nom_vue.ftl

    Pour des informations sur les paramètres, voir Syntaxe de base pour les URL d'API Digital Analytics.

  2. Spécifiez une date, un sens et le nombre de périodes antérieures ou postérieures à prendre en compte. Utilisez la syntaxe suivante :
    https://welcome.coremetrics.com/analyticswebapp/api/1.0/
    toplinetrend-data/topline.ftl?clientId=id_client&username=id_utilisateur
    &format=format_fichier&userAuthKey=jeton_API&language=Langue&viewID=nom_vue.ftl
    &period_a=type_période+ID_DATE&direction=sens&numPeriods=nombre_de_périodes

    où :

    period_a
    Identifie la date (au format aaaammjj) et le type de période dont vous voulez considérer l'antériorité ou la postérité par rapport à cette date. Préfixez la date avec le type de période : d pour quotidienne, w pour hebdomadaire ou m pour mensuelle. Par exemple, period_a=w20130301 correspond à la semaine du 1er mars 2013.
    direction=
    Identifie le sens pour le renvoi des données à partir de la date de début. Spécifiez forward ou backward.
    numPeriods=
    Identifie le nombre de périodes à consulter en mode prospectif ou rétrospectif.