Service du webtracking
Contrat WSDLhttp://apitmapreprod.dolist.net/V2/WebTrackingService.svc?Wsdl
Exemple disponible
  • Implémentation en .NET C# 4.0

    • Définition

    Le service de gestion du webtracking vous permet de récupérer l'ensemble des sites disponibles.
    Récupérez l'url, sa description, le trackingID, son typage et la date des dernieres données collectés pour les sites.

    Récupération de la liste des sites

    Nom de la méthode : GetLightSiteList

    Cette méthode récupère le descriptif complet ('url, description, trackingID, typage, date des dernieres données collectés ...) des sites de la base, disponibles sur la plateforme DOLIST-V8.
    Les paramètres attendus en entrée
    ChampTypeDescription
    authenticationTokenContextAuthenticationTokenContextJeton d'authentification
    requestGetLightSiteListRequestObjet contenant la liste des sites, le nombre retourné ainsi que le total
    Les valeurs renvoyées
    TypeDescription
    GetLightSiteListResultParamètres de la requête (filtres)
    Liste des erreurs possibles
    Erreurs communes
    CodeNomDescription
    4ForbiddenActionExceptionL'action demandée n'est pas autorisée

    Les objets du service de webtracking

    AuthenticationTokenContext

    ChampTypeDescription
    AccountIDintIdentifiant du client
    KeystringClé du jeton d'authentification
    ListIDintIdentifiant du client: obsolète. Utilisez AccountID à la place

      GetLightSiteListRequest

      la classe hérite de : BaseServiceRequest
      ChampTypeDescription
      Culturestring(Facultatif) - Langue de l'utilisateur (ex: fr-FR)
      UserEmailstring(Facultatif) - [Options et Droits de l'utilisateur] - Adresse e-mail de l'utilisateur
      Offsetint(Facultatif) - Offset de lecture
      Limitint(Facultatif) - Nombre d'éléments à retourner
      • Les paramètres Offset et Limit ne peuvent pas fonctionner séparément. L'Offset définit la position de départ et la Limit le nombre d'enregistrements à retourner.
      • Les cultures possibles sont en_US et fr_FR.

      BaseServiceRequest

      ChampTypeDescription
      Culturestring(Facultatif) - Langue de l'utilisateur (ex: fr-FR)
      UserEmailstring(Facultatif) - [Options et Droits de l'utilisateur] - Adresse e-mail de l'utilisateur

        GetLightSiteListResult

        ChampTypeDescription
        TotalintNombre total de sites
        CountintNombre de sites retournés
        LightSiteListLightSite[] Liste des sites

          LightSite

          la classe hérite de : Site
          ChampTypeDescription
          IDintIdentifiant du site
          TrackingIDstringIdentifiant du tracking
          URLstringUrl du site
          DescriptionstringDescription du site
          LastImportDatedateTimeDate des derniers données collectées pour le site
          TypeIDintIdentifiant du type de site
          TypeNamestringNom du type de site
          • TypeID : Les valeurs possible sont e-commerce (TypeID=1) et Site web (TypeID=2). Pour la récupération de statistiques de webtracking pour les campagnes d'un site, en fonction du type de site, vous devez appeler certaines méthodes :
            • Statistiques de webtracking pour les sites de e-commerce ici
            • Statistiques de webtracking pour les sites web ici

          Site

          ChampTypeDescription
          IDintIdentifiant du site
          TrackingIDstringIdentifiant du tracking

            ServiceException

            ChampTypeDescription
            TicketstringLe numéro de ticket
            MessagestringLe message d'erreur
            DescriptionstringLa description de l'erreur
            ErrorCodeTypeErrorCodeTypeType du code de l'erreur
            ErrorCodeintCode de l'erreur

              ValidationFault

              ChampTypeDescription
              DetailsValidationDetail[] Liste des détails de l'erreur de validation de la requête

                ValidationDetail

                ChampTypeDescription
                KeystringNom du champ à valider
                MessagestringRésultat de la validation
                TagstringTag de validation

                  Liste des erreurs communes

                  CodeNomDescription
                  0UnexpectedExceptionErreur inattendue
                  1AuthenticationExceptionErreur d'authentification
                  2NullTokenExceptionLe token est null, vérifiez que l'objet est correctement passé à la méthode et que les propriétés sont renseignées
                  3NullRequestExceptionL'objet 'request' est null, vérifiez que l'objet est correctement passé à la méthode et que les propriétés sont renseignées
                  4ForbiddenActionExceptionL'action demandée n'est pas autorisée
                  5InvalidArgumentExceptionLes arguments passés à la méthode ne sont pas valides, vérifiez les types des propriétés, leurs noms et leur nullité
                  6BadRequestExceptionLa requête n'est pas correcte
                  7NothingToDoExceptionLa requête demandée n'effectue aucun traitement, car les données soient déjà à jour, il est possible que la requête ai été exécuté plusieurs fois
                  8InvalidDataTypeExceptionLe type de donnée n'est pas valide
                  9UnknownTicketExceptionLe ticket n'est pas connu, vérifiez la valeur de celui-ci
                  10UnavailableTicketResultExceptionLe résultat associé n'est pas disponible, le traitement de la demande n'est pas terminé, veuillez réessayer plus tard.
                  11InvalidDatePeriodExceptionL'intervalle de temps n'est pas valide, vérifiez les dates passées à la requête
                  999998TokenNullLe token est null, vérifiez que l'objet est correctement passé à la méthode et que les propriétés sont renseignées
                  999999TokenNotAuthorizedL'objet 'token' n'est pas autorisé, vérifiez les propriétés