Documentation

Introduction

Cette documentation décrit de manière exhaustive la structure de données qui représente les résultats d'un audit Oracle. Ce livrable JSON est téléchargeable via le bouton « Exportation des données » du menu latéral de votre audit Oracle, au format <Entreprise>-<Date>-<Type>.json.

Ce livrable reflète l'intégralité des résultats d'un audit Oracle : Il est destiné aussi bien aux utilisateurs des solutions Maple Labs souhaitant archiver ou analyser leurs données qu'aux intégrateurs techniques qui consomment le JSON de façon programmatique.

Objet racine

L'objet racine contient six champs obligatoires décrivant l'audit complet : la date, le type (tier), les axes décisionnels, l'entreprise auditée, les concurrents et les données d'exploration.

{
  "date": "09-02-26",
  "type": "pro",
  "axis": { ... },
  "company": { ... },
  "competitors": { ... },
  "data": { ... }
}

AuditAxis

Dictionnaire indexé par AxisID (string numérique, ex : "100000"). Chaque entrée représente un axe décisionnel identifié lors de l'audit.

{
  "100000": {
    "category": "trends",
    "label": "Durabilité des matériaux",
    "description": "Les consommateurs privilégient...",
    "crawled": [
      "https://example.com/article-1",
      "https://example.com/article-2"
    ]
  }
}

AuditCompanyTarget (company)

Objet décrivant l'entreprise auditée. Hérite de AuditCompanyBase et rend le champ context obligatoire.

"context": {
  "sector": "Mode et textile",
  "perimeter": "France métropolitaine",
  "products": "Vêtements homme et femme, accessoires"
}

"company": {
  "name": "Mon Entreprise",
  "domain": "mon-entreprise.fr",
  "context": {
    "sector": "Mode et textile",
    "perimeter": "France métropolitaine",
    "products": "Vêtements, accessoires"
  },
  "scores": { "sov": 12.5, "ps": 34.8 },
  "adequacy": {
    "100000": { ... },
    "100001": { ... }
  }
}

AuditAdequacy

Objet d'adéquation associé à un axe décisionnel pour une entreprise donnée. Présent dans company.adequacy[axisId] et competitors[domain].adequacy[axisId].

"100000": {
  "trust_sources": [
    {
      "name": "Guide Achat Mode",
      "domain": "guide-achat-mode.fr",
      "covered": true,
      "constat": "L'entreprise est citée...",
      "crawled": ["https://guide-achat-mode.fr/page"]
    }
  ],
  "recommandation": {
    "keywords": ["durabilité", "matériaux recyclés"],
    "impact": "Amélioration de la visibilité...",
    "presence_score_impact": 4.2
  }
}

AuditTrustSources

Objet représentant une source de validation (site tiers) analysée pour vérifier la couverture d'une entreprise sur un axe décisionnel donné.

{
  "name": "Trustpilot",
  "domain": "trustpilot.com",
  "covered": true,
  "constat": "L'entreprise dispose d'un profil actif...",
  "crawled": [
    "https://trustpilot.com/review/example.com"
  ]
}

AuditRecommendation (recommandation)

Recommandation stratégique associée à un axe décisionnel pour améliorer la couverture et le Présence Score.

"recommandation": {
  "keywords": ["durabilité", "matériaux recyclés", "éco-responsable"],
  "impact": "Couvrir cet axe permettrait de...",
  "presence_score_impact": 4.2
}

AuditCompanyCompetitor (competitors)

Dictionnaire indexé par le domaine du concurrent. Chaque entrée hérite de AuditCompanyBase (même structure que company sans context obligatoire).

"competitors": {
  "concurrent-a.fr": {
    "name": "Concurrent A",
    "domain": "concurrent-a.fr",
    "scores": { "sov": 18.3, "ps": 42.1 },
    "adequacy": {
      "100000": { ... }
    }
  }
}

AuditData (data)

Objet contenant les données d'exploration brutes : les requêtes soumises par les assistants IA et les top domaines identifiés par catégorie.

AuditQueries (queries)

Objet regroupant les requêtes de recherche soumises par les assistants IA, organisées par catégorie. Chaque catégorie contient un tableau de SearchQuery ou null.

{
  "query": "meilleures marques mode durable France",
  "browsed_urls": [
    "https://example.com/guide-mode-durable",
    "https://example.com/top-marques"
  ]
}

AuditTopDomains (top_domains)

Objet contenant les domaines web les plus fréquemment rencontrés lors de l'exploration, organisés par catégorie. Ces données sont une source d'exécution (non recalculées côté UI).

"top_domains": {
  "competitors": ["concurrent-a.fr", "concurrent-b.com"],
  "criteria": ["guide-achats.fr"],
  "painpoints": ["forum-consommateurs.fr"],
  "trends": ["blog-mode.fr", "fashion-tech.com"]
}

Glossaire

Définitions des termes métier utilisés dans la documentation et dans les données d'audit.