list_product_prompt_matrix

list_product_prompt_matrix croise les prompts d'un projet e-commerce avec ses produits : pour chaque prompt, combien de réponses citent chaque produit. Les produits de votre marque viennent en premier dans les colonnes, puis ceux de vos concurrents.

Un prompt est perdu quand un produit concurrent est cité et aucun des vôtres. Les prompts perdus sortent en premier, avec le produit concurrent qui les gagne.

Quand l'utiliser

Appelez-le après get_product_share_of_voice, sur la catégorie où votre part est faible, pour répondre à « sur quelles questions les moteurs recommandent-ils les brossettes TePe et jamais les miennes ? ». Passez filters.lostOnly: true pour ne garder que ces prompts.

La liste est vide sur un projet qui n'est pas en mode e-commerce (voir update_project_settings).

Input

Réponse

{
  "data": [
    {
      "id": "clp7...",
      "text": "Quelles brossettes interdentaires choisir pour des espaces très serrés ?",
      "results": 14,
      "ours": 0,
      "theirs": 11,
      "lost": true,
      "winner": { "id": "clpr4...", "name": "TePe Original", "brand": "TePe" },
      "cells": { "clpr4...": 9, "clpr5...": 5 }
    },
    {
      "id": "clp2...",
      "text": "Meilleure brossette interdentaire pour porteur d'appareil dentaire ?",
      "results": 14,
      "ours": 8,
      "theirs": 6,
      "lost": false,
      "winner": null,
      "cells": { "clpr1...": 8, "clpr4...": 4, "clpr5...": 3 }
    }
  ],
  "pageInfo": { "hasMore": true, "nextCursor": "20", "totalCount": 37 },
  "columns": [
    { "id": "clpr1...", "name": "Trav-Ler", "brand": "GUM", "ours": true, "mentions": 31 },
    { "id": "clpr3...", "name": "Soft-Picks Comfort Flex", "brand": "GUM", "ours": true, "mentions": 18 },
    { "id": "clpr4...", "name": "TePe Original", "brand": "TePe", "ours": false, "mentions": 38 },
    { "id": "clpr5...", "name": "CPS Prime", "brand": "Curaprox", "ours": false, "mentions": 27 }
  ],
  "summary": { "prompts": 37, "lost": 12 }
}

Champs :

• data : une ligne par prompt où au moins un produit est cité sur la période. Les prompts perdus d'abord, puis ceux qui ont le plus de mentions de produits.
• results : réponses au prompt sur la période.
• ours et theirs : réponses qui citent un de vos produits, et réponses qui citent un produit concurrent. Ils comptent tous les produits de la catégorie, pas seulement les colonnes.
• lost : true quand ours vaut 0 et theirs est au-dessus de 0.
• winner : sur un prompt perdu, le produit concurrent le plus cité. null sinon.
• cells : réponses qui citent chaque produit en colonne, par id de produit. Une colonne absente de cells n'est pas citée sur ce prompt.
• columns : les colonnes produits, les plus mentionnées d'abord dans chaque camp. mentions additionne les réponses qui citent le produit sur l'ensemble des prompts.
• summary : prompts où un produit est cité, et combien sont perdus. Calculé avant lostOnly : pageInfo.totalCount peut donc être plus bas.

Astuces et patterns

• lostOnly: true avec une category : la liste des questions à reprendre sur une catégorie, chacune avec le produit à battre dans winner.
• Ouvrez le winner avec get_product pour voir ses revendeurs, prix et note.
• Appelez ensuite get_recommendation sur un prompt perdu pour le plan qui ferait citer votre produit.
• Les colonnes ne portent que des produits cités au moins une fois. Vos produits sans aucune réponse sortent de list_products avec neverCited: true.

Tools liés

• get_product_share_of_voice : votre part de voix par catégorie de produit
• list_products : tous les produits du projet
• get_product : le détail d'un produit
• get_recommendation : le plan d'un prompt