get_product_share_of_voice

get_product_share_of_voice mesure, catégorie par catégorie, la place de votre marque dans les réponses IA d'un projet e-commerce. Pour chaque catégorie (« Brossettes interdentaires », « Fil dentaire »), il renvoie le nombre de réponses qui citent un produit de cette catégorie, la part de votre marque dans les mentions de produits de la catégorie, cette même part par moteur, et les marques et produits en tête.

Une mention est une réponse qui cite un produit. La part de voix d'un produit est sa part des mentions de sa catégorie. Les produits rejetés sont exclus.

Les catégories de produit sont rangées par l'IA après chaque scan. Elle réutilise les catégories déjà présentes dans le projet, pour que les produits de marques différentes tombent dans la même catégorie. Vous pouvez changer la catégorie d'un produit avec update_product ; l'IA n'écrase jamais une catégorie posée à la main.

Quand l'utiliser

Appelez-le pour répondre à « sur les brossettes interdentaires, à quelle fréquence les IA recommandent-elles mes produits plutôt que ceux de mes concurrents ? ». Il donne une part par catégorie : une gamme forte ne cache donc pas une gamme faible. Ouvrez ensuite list_product_prompt_matrix sur une catégorie pour voir les prompts où vous perdez.

Projets e-commerce seulement (voir update_project_settings).

Input

Réponse

{
  "success": true,
  "brandName": "GUM",
  "results": 412,
  "ourShare": 29,
  "categories": [
    {
      "category": "Brossettes interdentaires",
      "answers": 96,
      "answerRate": 23,
      "ourAnswers": 41,
      "ourRate": 10,
      "mentions": 158,
      "ourShare": 34,
      "byLlm": [
        { "llm": "CHATGPT", "mentions": 82, "ourShare": 38 },
        { "llm": "COPILOT", "mentions": 51, "ourShare": 25 },
        { "llm": "PERPLEXITY", "mentions": 25, "ourShare": 36 }
      ],
      "brands": [
        { "competitorId": "clc1...", "name": "TePe", "mentions": 61, "ours": false, "share": 39 },
        { "competitorId": null, "name": "GUM", "mentions": 54, "ours": true, "share": 34 },
        { "competitorId": "clc2...", "name": "Curaprox", "mentions": 43, "ours": false, "share": 27 }
      ],
      "products": [
        { "id": "clpr4...", "name": "TePe Original", "competitorId": "clc1...", "brand": "TePe", "ours": false, "mentions": 38, "share": 24 },
        { "id": "clpr1...", "name": "Trav-Ler", "competitorId": null, "brand": "GUM", "ours": true, "mentions": 31, "share": 20 },
        { "id": "clpr5...", "name": "CPS Prime", "competitorId": "clc2...", "brand": "Curaprox", "ours": false, "mentions": 27, "share": 17 }
      ]
    },
    {
      "category": "Fil dentaire",
      "answers": 40,
      "answerRate": 10,
      "ourAnswers": 6,
      "ourRate": 1,
      "mentions": 52,
      "ourShare": 12,
      "byLlm": [
        { "llm": "CHATGPT", "mentions": 34, "ourShare": 15 },
        { "llm": "COPILOT", "mentions": 18, "ourShare": 6 }
      ],
      "brands": [
        { "competitorId": "clc1...", "name": "TePe", "mentions": 46, "ours": false, "share": 88 },
        { "competitorId": null, "name": "GUM", "mentions": 6, "ours": true, "share": 12 }
      ],
      "products": [
        { "id": "clpr8...", "name": "Bridge & Implant Floss", "competitorId": "clc1...", "brand": "TePe", "ours": false, "mentions": 46, "share": 88 },
        { "id": "clpr9...", "name": "Fine Floss", "competitorId": null, "brand": "GUM", "ours": true, "mentions": 6, "share": 12 }
      ]
    }
  ]
}

Champs :

• results : réponses de la période, tous prompts confondus. C'est le dénominateur de answerRate et ourRate.
• ourShare (au premier niveau) : la part de votre marque dans toutes les mentions de produits, toutes catégories confondues.
• categories : une entrée par catégorie de produit, les plus mentionnées d'abord. category: null regroupe les produits pas encore rangés.
• answers et answerRate : réponses qui citent un produit de la catégorie, et leur % des réponses de la période.
• ourAnswers et ourRate : réponses qui citent un de vos produits de la catégorie, et leur % des réponses de la période.
• mentions : mentions de produits de la catégorie. Une réponse qui cite trois brossettes compte trois mentions : mentions peut donc dépasser answers.
• ourShare : le % de votre marque dans les mentions de produits de la catégorie. byLlm donne cette même part par moteur.
• brands et products : les 10 marques et les 10 produits les plus mentionnés de la catégorie. share est leur % des mentions de la catégorie. ours: true désigne votre marque.

Tous les taux sont des pourcentages entiers, ou null quand il n'y a rien à diviser.

Erreur : not_an_ecommerce_project.

Astuces et patterns

• Triez vos catégories par ourShare : la plus basse avec un answerRate élevé est celle où les moteurs parlent souvent de la catégorie et recommandent quelqu'un d'autre.
• Comparez byLlm : une part à 38 % sur ChatGPT et 25 % sur Copilot désigne le moteur à travailler en premier.
• Une grosse entrée category: null veut dire que l'IA n'a pas encore rangé certains produits, ou n'a pas su. Posez leur catégorie avec update_product.
• Deux catégories qui veulent dire la même chose (« Brossettes » et « Brossettes interdentaires ») ? Passez les produits de l'une dans l'autre avec update_product.

Tools liés

• list_product_prompt_matrix : quel prompt fait remonter quel produit
• list_products : tous les produits du projet, avec leur catégorie
• get_product : le détail d'un produit
• update_product : changer la catégorie d'un produit