Peux-ton récupérer les informations de campagnes UTM ?

Collecter les UTMs comme propriétés UTM dédiées (portée événement)

Par défaut, les paramètres UTM sont reconnus et collectés grâce au paramétrage par défaut de la clé de configuration enableUTMTracking.

Lorsqu'activés, les UTMs sont collectés dans des propriétés dédiées :

• utm_term (utm_term)

• utm_source (utm_source)

• utm_medium (utm_medium)

• utm_content (utm_content)

• utm_campaign (utm_campaign)

Important : Les UTMs ont une portée événement par conception

Les propriétés UTM ont une portée événement, ce qui signifie qu'elles ne sont valorisées que sur les événements envoyés lorsque les paramètres UTM sont présents dans l'URL (typiquement le premier page.display après l'arrivée sur une URL de campagne). Durant la même visite, les événements suivants peuvent avoir des propriétés UTM vides si l'URL ne contient plus d'UTMs.

C'est une raison courante de confusion lors de l'analyse des conversions/transactions : les événements de transaction se produisent souvent sur des URLs sans UTMs, donc les propriétés UTM peuvent être vides sur ces événements même si la visite a commencé à partir d'un lien de campagne.

Si vous avez besoin d'une attribution de campagne unique et cohérente sur tous les événements d'une visite (y compris les transactions), utilisez les propriétés source à portée visite (src_…) comme décrit ci-dessous.

Utiliser les UTMs dans l'attribution de source (portée visite) avec le SDK

Le SDK Piano Analytics permet de prendre en compte les paramètres UTM dans l'algorithme d'attribution de source si le paramètre campaignPrefix est défini pour prendre en compte les paramètres UTM :

pa.setConfiguration("campaignPrefix", ["at_", "utm_"]);

Avec cette configuration, les UTMs peuvent contribuer à l'attribution de source marketing au niveau de la visite :

• src_medium et src_campaign (obligatoires pour compter une source marketing) seront valorisés par utm_medium et utm_campaign (lorsque les paramètres at_ ne sont pas présents).

• Si at_ et utm_ sont tous deux présents, l'ordre dans campaignPrefix détermine la priorité. Avec ["at_", "utm_"], at_ a la priorité. Si vous voulez prioriser les UTMs, placez utm_ en premier (par exemple ["utm_", "at_"]).

Autres paramètres UTM comme sources (src_…)

Les autres paramètres UTM seront comptés comme sources si des propriétés personnalisées sont déclarées avec un préfixe src_ (par exemple src_source, src_term, src_content). Cela est typiquement utilisé pour rendre des valeurs comme utm_source, utm_term, ou utm_content disponibles comme propriétés à portée visite pour l'analyse d'attribution et de conversion.

src_ est un préfixe fixe utilisé par le mécanisme d'attribution de source.

Questions fréquentes

"Campagne non classée" ou campagne non comptée comme source marketing

Cela se produit le plus souvent lorsque :

• utm_medium et/ou utm_campaign est manquant dans l'URL, ou

• Les UTMs sont collectés comme propriétés d'événement mais ne sont pas mappés/configurés pour peupler src_medium et src_campaign (portée visite).

UTMs visibles sur les pages vues mais manquants sur les transactions

C'est attendu lorsque les UTMs sont collectés uniquement comme propriétés à portée événement. Utilisez les propriétés source à portée visite (src_…) pour l'analyse d'attribution de conversion/transaction.

Source de visite existante non remplacée par un nouveau lien UTM

Une visite n'a qu'une seule source. Si un visiteur clique sur un lien avec des UTMs alors qu'une visite est déjà ouverte (par exemple, en naviguant entre des sous-domaines qui partagent des cookies), la source de visite existante n'est pas remplacée sauf si vous la forcez explicitement (par exemple avec src_force: true, selon votre implémentation et vos contraintes de consentement).