Odoo 19.0 Community · Persistant

mailing.trace : champs, relations et API

Le modèle mailing.trace (« Statistiques des e-mails ») est un modèle persistant déclaré par le module E-mail Marketing, puis enrichi par 1 autre module. Il expose 31 champs, dont 25 déclarés directement sur le modèle ; 2 champs d'autres modèles pointent vers lui. Retrouvez ci-dessous chaque champ avec son nom technique, son type, son libellé français et ses relations, puis un exemple d'appel à l'API JSON-2 d'Odoo 19.

Voir le code source Rechercher un autre modèle

Fiche d'identité

Nom technique: mailing.trace
Libellé: Statistiques des e-mails
Type: Persistant (models.Model)
Table SQL: mailing_trace
Module d'origine: E-mail Marketing (mass_mailing)
Étendu par: mass_mailing_sms
Tri par défaut (_order): create_date DESC
Champ d'affichage (_rec_name): id

Champs du modèle

25 champs propres, 0 hérités des mixins et 6 champs automatiques de l'ORM. Cliquez sur un nom pour obtenir le lien direct vers le champ.

Masquer les champs hérités

31 champs affichés sur 31

Nom technique	Libellé	Type	Détails
campaign_id	Campagne	`many2one` → utm.campaign	lecture seule related : `mass_mailing_id.campaign_id`
email	E-mail Adresse e-mail normalisée	`char`
failure_reason	Motif de l'échec	`text`	lecture seule
failure_type	Type d'échec	`selection`	Valeurs : `unknown` (Erreur inconnue), `mail_bounce` (Rebond), `mail_spam` (Détecté comme spam), `mail_email_invalid` (Adresse e-mail non valide), `mail_email_missing` (Adresse e-mail manquante), `mail_from_invalid` (Adresse d'envoi invalide), `mail_from_missing` (Adresse d'envoi manquante), `mail_smtp` (La connexion a échoué (problème de serveur de messagerie sortant)), `mail_bl` (Adresses sur liste noire), `mail_dup` (E-mail dupliqué), `mail_optout` (Désinscrit)
is_test_trace	Généré pour tests	`boolean`
links_click_datetime	Cliqué le Sauvegarde le datetime du dernier clic en cas de clics multiples.	`datetime`
links_click_ids	Nombre de clics sur les liens	`one2many` → link.tracker.click	inverse : `mailing_trace_id`
mail_mail_id	E-mail	`many2one` → mail.mail
mail_mail_id_int	ID e-mail (tech) ID du mail_mail lié. Ce champ est un entier car le mail_mail lié peut être supprimé séparément depuis les statistiques. Cependant cet ID est requis pour plusieurs actions et contrôleurs.	`integer`
mass_mailing_id	Mailing	`many2one` → mailing.mailing
medium_id	Médium	`many2one` → utm.medium	related : `mass_mailing_id.medium_id`
message_id	ID du message	`char`
model	Modèle de document	`char`	requis
open_datetime	Ouvert le	`datetime`
reply_datetime	Répondu le	`datetime`
res_id	ID document	`many2one_reference`
sent_datetime	Envoyé le	`datetime`
sms_code	Code	`char`	ajouté par SMS Marketing (`mass_mailing_sms`)
sms_id	SMS	`many2one` → sms.sms	calculé ajouté par SMS Marketing (`mass_mailing_sms`)
sms_id_int	ID SMS	`integer`	ajouté par SMS Marketing (`mass_mailing_sms`)
sms_number	Numéro	`char`	ajouté par SMS Marketing (`mass_mailing_sms`)
sms_tracker_ids	Trackers SMS	`one2many` → sms.tracker	inverse : `mailing_trace_id` ajouté par SMS Marketing (`mass_mailing_sms`)
source_id	Source	`many2one` → utm.source	related : `mass_mailing_id.source_id`
trace_status	Statut	`selection`	Valeurs : `outgoing` (Sortant), `process` (En cours de traitement), `pending` (Envoyé), `sent` (Délivré), `open` (Ouvert), `reply` (Répondu), `bounce` (Rejeté), `error` (Exception), `cancel` (Annulé)
trace_type	Type	`selection`	requis Valeurs : `mail` (E-mail)
create_date	Créé le	`datetime`	lecture seuleautomatique
create_uid	Créé par	`many2one` → res.users	lecture seuleautomatique
display_name	Nom affiché	`char`	lecture seulecalculéautomatique
id	ID	`integer`	lecture seuleautomatique
write_date	Dernière mise à jour le	`datetime`	lecture seuleautomatique
write_uid	Dernière mise à jour par	`many2one` → res.users	lecture seuleautomatique

Relations

Modèles liés depuis ce modèle

link.tracker.click : links_click_ids
mail.mail : mail_mail_id
mailing.mailing : mass_mailing_id
sms.sms : sms_id
sms.tracker : sms_tracker_ids
utm.campaign : campaign_id
utm.medium : medium_id
utm.source : source_id

Champs d'autres modèles qui pointent ici

link.tracker.click : mailing_trace_id
sms.tracker : mailing_trace_id

Lire ce modèle par l'API

Exemple d'appel à l'API JSON-2 d'Odoo 19 : lecture des cinq premiers enregistrements avec des champs réels du modèle. Remplacez l'instance, la base et la clé API par les vôtres.

curl

curl -X POST "https://votre-instance.odoo.com/json/2/mailing.trace/search_read" \
  -H "Authorization: bearer $ODOO_API_KEY" \
  -H "X-Odoo-Database: votre-base" \
  -H "Content-Type: application/json" \
  -d '{"domain":[],"fields":["id","model","trace_type","campaign_id","mail_mail_id"],"limit":5}'

Python (requests)

import requests

BASE_URL = "https://votre-instance.odoo.com/json/2"
headers = {"Authorization": f"bearer {API_KEY}", "X-Odoo-Database": "votre-base"}

res = requests.post(
    f"{BASE_URL}/mailing.trace/search_read",
    headers=headers,
    json={"domain": [], "fields": ["id","model","trace_type","campaign_id","mail_mail_id"], "limit": 5},
)
res.raise_for_status()
print(res.json())

L'accès à l'API externe est réservé à la formule Custom d'Odoo.
XML-RPC et JSON-RPC seront retirés dans Odoo 22 (automne 2028) : préférez JSON-2.
Les droits d'accès et règles d'enregistrement de l'utilisateur de la clé s'appliquent.

Citer cet outil

Vous rédigez un tutoriel, une documentation interne ou une réponse sur un forum ? Copiez ce lien pour renvoyer vos lecteurs vers la fiche à jour.

<a href="https://aidoo.ai/fr/outils/explorateur-modeles-odoo/mailing-trace">mailing.trace (Odoo 19.0)</a>

Sources

Données vérifiées le 23 septembre 2026 · Odoo 19.0 Community

Vous avez un projet Odoo ou souhaitez exploiter votre ERP avec l'IA ? Échangeons

Intégration, développement de modules, connexion de Claude ou ChatGPT à vos données : décrivez-nous votre contexte, nous vous répondons sous 24 heures ouvrées.

Nous contacter Voir une démo