Aller au contenu
Trustt

Playbook — Analyser une campagne ambassadeur

Utilisez cette page pour croiser, sur une campagne, les réponses d’inscription, les fiches du panel, les tests d’usage, les avis déposés et les publications déjà rattachées. La fiche de toutes les candidatures (y compris refusées) est une lecture à part, en fin de page.

Public : tous les profils utilisateurs (depuis le 01/09/2026) Connexion : menu Assistant IA (MCP) > Connexion (Claude / Cursor en un clic ; autres assistants via l’URL MCP) Intention : analyser une campagne ambassadeur (inscription, fiche, tests d’usage, avis, publications) Module requis : Community Builder (accès lecture à la campagne) Personas primaires : Influence / Community, Brand / Product Manager

Pourquoi : cinq lectures séparées, jointes par la même personne, évitent d’ouvrir le formulaire, la fiche, le test, l’avis et la publication un écran après l’autre.

Bénéfice : un brief qualitatif du panel (ce qui a été répondu, noté, publié) sans mélanger le catalogue produit ni la liste des actions en attente.

Selon votre profil

Profil Ce qu’il faut faire en priorité
Influence / Community Lancer les cinq lectures sur la campagne, relier les lignes par candidate_uuid, repérer qui a répondu au test, déposé un avis, publié.
Brand / Product Manager Lire les verbatims de test et les avis de la campagne. Ces avis ne sont pas les avis publiés du catalogue.
Marketing Lead Demander une synthèse (thèmes, notes, EMV). L’e-mail, le ton Qualité email, le nom, l’indicateur influenceur, l’audience des comptes scannés et les étiquettes CRM ne sortent que de la fiche.

1. Prompt type

Analyse la campagne [nom] : réponses d’inscription du panel, fiches, tests d’usage, avis déposés et publications rattachées.
Même identifiant de campagne pour les cinq lectures. Relie les lignes par candidate_uuid.
Rappelle le curseur tant que next_cursor n’est pas none.
E-mail, ton Qualité email, nom, indicateur influenceur, audience des comptes scannés et étiquettes CRM seulement depuis la fiche.

2. Chaîne d’outils

  1. get_user_brands — retrouver la marque si besoin
  2. get_brand_campaigns — retrouver campaign_uuid à partir du nom. La liste indique aussi, pour chaque campagne, si elle attend des tests d’usage (expectsUsageTest), un avis sur le site marchand (expectsMerchantReview, avec l’adresse de la boutique dans merchantReviewUrl) ou un avis sur le site de livraison (expectsExternalDeliveryReview). Sans test d’usage attendu, la lecture get_campaign_usage_test_answers est inutile.
  3. Les cinq lectures ci-dessous, avec le même campaign_uuid
  4. Joindre les lignes sur candidate_uuid
  5. Page suivante : rappeler cursor = next_cursor tant que la valeur n’est pas none

⚠️ get_campaign_ambassadors liste les actions en attente du panel. Il ne remplace aucune des cinq lectures.

⚠️ get_product_reviews lit les avis publiés d’un produit (catalogue). get_campaign_reviews lit les avis déposés par les ambassadeurs de la campagne.


3. Les cinq lectures

Toutes : scope campaigns.read, format texte lines, plafond 60 000 caractères par page, clé personne candidate_uuid. Il n’y a pas de uuid_tester dans ces sorties. Paramètre commun optionnel : user_uuid.

Outil Rôle Paramètres utiles Ligne (après les en-têtes)
get_campaign_registration_answers Réponses au formulaire d’inscription ambassadors_only défaut true (panel sélectionné) ; false = aussi les candidats non retenus ; candidate_uuid ; limit défaut 50, plafond 100 ; cursor candidate_uuid | date | qN:valeur — en-têtes # form= et # legend:
get_campaign_ambassador_profiles Fiche du panel sélectionné : prénom, nom, e-mail, ton Qualité email, téléphone, adresse, indicateur influenceur, réseaux et audience du compte scanné, étiquettes CRM, rappel court des critères d’inscription candidate_uuid ; limit 50 / 100 ; cursor candidate_uuid | prénom | nom | e-mail | mail | téléphone | adresse | inf | réseaux | étiquettes | qN
get_campaign_usage_test_answers Réponses reçues aux tests d’usage (formulaire de type test, pas l’inscription) candidate_uuid ; limit 50 / 100 ; cursor candidate_uuid | date | qN:valeur — en-têtes # form= et # legend:
get_campaign_reviews Avis déposés par les ambassadeurs de la campagne candidate_uuid ; limit défaut 40, plafond 80 ; min_rating / max_rating de 1 à 5 ; cursor candidate_uuid | uuid_review | date | note | texte | ph:n | v:0|1 — en-tête # ratings
get_campaign_social_posts Publications sociales déjà rattachées aux ambassadeurs candidate_uuid ; limit 50 / 100 ; cursor personne, date, réseau, type, compte, URL (identité de la publication), likes, commentaires, vues, partages, EMV campagne, légende

ph:n = nombre de photos (ph:0 s’il n’y en a pas). v:1 = avis avec vidéo, v:0 = sans vidéo. Sur une publication, les chiffres sont préfixés lk: (likes), cm: (commentaires), vw: (vues), sh: (partages), emv: (EMV campagne).

ambassadors_only à false inclut des candidats non retenus : ces personnes n’ont pas de ligne dans get_campaign_ambassador_profiles. Leur fiche est dans la lecture de toutes les candidatures.

Fiche — ton d’e-mail. mail a trois valeurs, les mêmes que la pastille Qualité email : joignable, injoignable, non_verifie. L’absence d’injoignable n’est pas joignable : un e-mail non vérifié reste non_verifie.

Fiche — influenceur et comptes scannés. inf=1 seulement si le compte est marqué influenceur ; toute autre situation donne inf=0. Le jeton est toujours présent. Sur un réseau, st=0 signifie compte scanné non utilisable : pas d’abonnés ni de moyennes ; la date scan= reste si elle existe. Une valeur de st autre que 0 (en pratique st=1, compte utilisable) ajoute f (abonnés), l (likes moyens), c (commentaires moyens), e (engagement moyen), emv (EMV moyen) et s (partages moyens), plus scan (dernier scan). Une moyenne absente en base n’apparaît pas ; f=0 et e=0.0 sont des valeurs réelles. Un réseau sans st est un compte déclaré, non rapproché d’un scan : le nom seul. Aucune lecture ne relance un scan.

Fiche — étiquettes CRM. Le segment liste les étiquettes déjà liées au contact de l’entreprise de la marque. Préfixe sys: si l’étiquette est système (Product explorer, Risky, et toute autre étiquette système liée). Une étiquette de l’entreprise s’écrit sans préfixe. Segment vide s’il n’y a pas de contact correspondant ou pas d’étiquette. Pas d’identifiant, pas de couleur.

L’assistant connecté reçoit le détail de chaque clé directement du serveur MCP.


4. Pagination et jointure

Chaque page annonce le total, le nombre de lignes renvoyées et next_cursor.

Signal Action
next_cursor a une valeur autre que none Rappeler l’outil avec cursor = cette valeur, mêmes filtres (candidate_uuid, et ambassadors_only pour l’inscription)
next_cursor = none Dernière page
Page plus courte que limit Le plafond de 60 000 caractères a coupé la page : le curseur reste valable, le rappeler

La jointure se fait uniquement sur candidate_uuid. Une publication n’a pas d’UUID : son identité est l’URL.


5. Contenu exposé

Lecture Exposé Non exposé
Inscription candidate_uuid, date, réponses qN E-mail, nom
Fiche Prénom, nom, e-mail, mail (joignable, injoignable ou non_verifie), téléphone, adresse, inf=1 ou inf=0, réseaux, audience du compte scanné quand il est utilisable, étiquettes CRM (sys: si étiquette système), rappel des critères d’inscription Réponses détaillées de test d’usage (elles sont dans l’outil test). Pas d’audience si le compte scanné n’est pas utilisable (st=0) ou s’il n’est pas rapproché. Pas le formulaire d’inscription entier
Test d’usage candidate_uuid, date, réponses qN E-mail, nom
Avis de campagne candidate_uuid, uuid_review, date, note, texte, compteur de photos, indicateur vidéo Pseudo, e-mail, nom
Publications candidate_uuid, date, réseau, type, compte, URL, likes, commentaires, vues, partages, EMV campagne, légende (coupée à 400 caractères) E-mail, nom, UUID de publication

6. Garde-fous

Règle Détail
Lecture seule Aucune écriture, aucun envoi, aucune modération
Scope campaigns.read
Hors widget Trustt AI Ces cinq lectures, et la fiche de toutes les candidatures, ne sont pas préchargées dans le widget. Une question dans Trustt AI ne renvoie pas ces textes
Panel Sauf ambassadors_only à false sur l’inscription : panel sélectionné, hors ambassadeurs de démonstration
Publications Hors posts supprimés, hors posts sans ambassadeur, hors posts de démonstration
Avis catalogue Verbatims d’un produit e-shop → Avis publiés d’un produit

Les schémas et codes d’erreur sont fournis à l’assistant par le serveur MCP — contrats get_campaign_registration_answers, get_campaign_ambassador_profiles, get_campaign_candidate_profiles, get_campaign_usage_test_answers, get_campaign_reviews, get_campaign_social_posts.


7. Limites connues

Plafonds relus sur le contrat serveur le 03/10/2026. Indicateur influenceur, audience des comptes scannés, ton Qualité email, étiquettes CRM et fiche de toutes les candidatures relus le 05/10/2026.

  • Page coupée à 60 000 caractères, avant limit s’il le faut.
  • Légende de publication coupée à 400 caractères.
  • Avis de campagne : pas de statut de modération dans cette lecture (note supérieure à 0, personne du panel).
  • Les questions qN des tests, de l’inscription et des avis ne partagent pas la même numérotation : l’en-tête # legend: de chaque page fait foi.
  • Un candidate_uuid hors population renvoie un total à 0, sans erreur.
  • La fiche du panel ne couvre pas les candidatures refusées ni les candidatures pas encore retenues. Ces personnes sont dans la fiche de toutes les candidatures.

8. Fiche de toutes les candidatures

get_campaign_candidate_profiles reprend la même fiche (identité, mail, inf, réseaux, étiquettes, rappel qN) sur toutes les candidatures de la campagne, y compris refusées et déjà passées ambassadeur. Scope campaigns.read. Hors widget Trustt AI. Plafond 60 000 caractères, limit défaut 50, plafond 100, curseur opaque.

Quatre jetons en plus, après les étiquettes :

Jeton Sens
reg Date d’inscription. Segment vide s’il n’y a pas de date
form=1 / form=0 Formulaire d’inscription complet, ou non
sel Verdict. En-tête coselection=1 : untreated, validated, to_study, refused. En-tête coselection=0 : untreated ou retained
prosp=1 / prosp=0 prosp=1 si la personne est dans une séquence de cette campagne, même compte, et que la date d’inscription est postérieure au début calendaire de la séquence. Les trois écrans SaaS (tableau de bord, Candidatures, page séquence) attribuent autrement : inscription strictement après le premier email envoyé à ce contact — un prosp=1 peut donc dépasser le chiffre affiché dans l’interface

Filtres : candidate_uuid ; selection (all par défaut, untreated, to_study, retained, refused) ; from_prospecting (absent = pas de filtre ; oui = seulement prosp=1 ; non = seulement prosp=0).

selection=retained alors que la co-sélection est active garde les personnes dont la ligne affiche sel=validated. to_study ou refused alors que la co-sélection est éteinte : page vide et avertissement coselection_off.

Cette lecture ne score pas les candidatures (le score reste Sélection du panel) et ne renvoie pas le formulaire entier (les réponses détaillées restent get_campaign_registration_answers).


Alternative dans la plateforme


Voir aussi