Odoo 20.0 Community · Persistant

utm.campaign : champs, relations et API

Le modèle utm.campaign (« Campagne UTM ») est un modèle persistant déclaré par le module UTM Trackers, puis enrichi par 10 autres modules. Il expose 36 champs, dont 30 déclarés directement sur le modèle ; 14 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 20.

Voir le code source Rechercher un autre modèle

Fiche d'identité

Nom technique: utm.campaign
Libellé: Campagne UTM
Type: Persistant (models.Model)
Table SQL: utm_campaign
Module d'origine: UTM Trackers (utm)
Étendu par: crm, sale, hr_recruitment, link_tracker, mass_mailing, mass_mailing_crm, mass_mailing_sms, mass_mailing_crm_sms, mass_mailing_sale, mass_mailing_sale_sms
Champ d'affichage (_rec_name): title

Champs du modèle

30 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

36 champs affichés sur 36

Nom technique	Libellé	Type	Détails
ab_testing_completed	Campagne de test A/B terminée	`boolean`	lecture seulecalculé, stocké ajouté par E-mail Marketing (`mass_mailing`)
ab_testing_mailings_count	Envois de tests A/B #	`integer`	calculé ajouté par E-mail Marketing (`mass_mailing`)
ab_testing_mailings_sms_count	SMS de tests A/B #	`integer`	calculé ajouté par SMS Marketing (`mass_mailing_sms`)
ab_testing_schedule_datetime	Envoyer le définitif le Date qui sera utilisée pour savoir quand déterminer et envoyer l'envoi gagnant	`datetime`	ajouté par E-mail Marketing (`mass_mailing`)
ab_testing_sms_winner_selection	Sélection du gagnant par SMS	`selection`	Valeurs : `manual` (Manuelle), `clicks_ratio` (Taux de clic le plus élevé) ajouté par SMS Marketing (`mass_mailing_sms`)
ab_testing_winner_mailing_id	Envoi au gagnant de la campagne A/B	`many2one` → mailing.mailing	ajouté par E-mail Marketing (`mass_mailing`)
ab_testing_winner_selection	Sélection du gagnant Sélection pour déterminer le mailing gagnant qui sera envoyé.	`selection`	Valeurs : `manual` (Manuelle), `opened_ratio` (Taux d'ouverture le plus élevé), `clicks_ratio` (Taux de clic le plus élevé), `replied_ratio` (Taux de réponse le plus élevé) ajouté par E-mail Marketing (`mass_mailing`)
active	Actif	`boolean`
bounced_ratio	Taux de rebond	`float`	calculé ajouté par E-mail Marketing (`mass_mailing`)
click_count	Nombre de clics générés par la campagne	`integer`	calculé ajouté par Tracker de liens (`link_tracker`)
color	Couleur	`integer`
crm_lead_count	Nombre de pistes/opportunités	`integer`	calculé ajouté par CRM (`crm`)
currency_id	Devise	`many2one` → res.currency	calculé ajouté par Ventes (`sale`)
invoiced_amount	Revenus générés par la campagne	`monetary`	calculé ajouté par Ventes (`sale`)
is_auto_campaign	Campagne générée automatiquement Nous permet de filtrer les campagnes pertinentes	`boolean`
is_mailing_campaign_activated	Est une campagne de mailing activée	`boolean`	calculé ajouté par E-mail Marketing (`mass_mailing`)
mailing_mail_count	Nombre d'envois de masse	`integer`	calculé ajouté par E-mail Marketing (`mass_mailing`)
mailing_mail_ids	E-mail Marketing	`one2many` → mailing.mailing	inverse : `campaign_id` ajouté par E-mail Marketing (`mass_mailing`)
mailing_sms_count	Nombre de SMS envoyés de masse	`integer`	calculé ajouté par SMS Marketing (`mass_mailing_sms`)
mailing_sms_ids	SMS de masse	`one2many` → mailing.mailing	inverse : `campaign_id` ajouté par SMS Marketing (`mass_mailing_sms`)
name	Identifiant de la campagne	`char`	requiscalculé, stocké
opened_ratio	Taux d'ouverture	`float`	calculé ajouté par E-mail Marketing (`mass_mailing`)
quotation_count	Nombre de devis	`integer`	calculé ajouté par Ventes (`sale`)
received_ratio	Taux de réception	`float`	calculé ajouté par E-mail Marketing (`mass_mailing`)
replied_ratio	Taux de réponse	`float`	calculé ajouté par E-mail Marketing (`mass_mailing`)
stage_id	Étape	`many2one` → utm.stage	requis
tag_ids	Étiquettes	`many2many` → utm.tag
title	Nom de la campagne	`char`	requistraduisible
use_leads	Utiliser les pistes	`boolean`	calculé ajouté par CRM (`crm`)
user_id	Responsable	`many2one` → res.users	requis
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

mailing.mailing : ab_testing_winner_mailing_id, mailing_mail_ids, mailing_sms_ids
res.currency : currency_id
res.users : user_id
utm.stage : stage_id
utm.tag : tag_ids

Champs d'autres modèles qui pointent ici

account.move : campaign_id
crm.lead : campaign_id
event.registration : utm_campaign_id
hr.applicant : campaign_id
hr.recruitment.source : campaign_id
link.tracker : campaign_id
link.tracker.click : campaign_id
mail.compose.message : campaign_id
mailing.mailing : campaign_id
mailing.trace : campaign_id
sale.order : campaign_id
sale.report : campaign_id
sms.composer : utm_campaign_id
utm.mixin : campaign_id

Lire ce modèle par l'API

Exemple d'appel à l'API JSON-2 d'Odoo 20 : 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/utm.campaign/search_read" \
  -H "Authorization: bearer $ODOO_API_KEY" \
  -H "X-Odoo-Database: votre-base" \
  -H "Content-Type: application/json" \
  -d '{"domain":[],"fields":["title","name","stage_id","user_id","ab_testing_winner_mailing_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}/utm.campaign/search_read",
    headers=headers,
    json={"domain": [], "fields": ["title","name","stage_id","user_id","ab_testing_winner_mailing_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/utm-campaign">utm.campaign (Odoo 20.0)</a>

Sources

Données vérifiées le 25 septembre 2026 · Odoo 20.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