Security, Privacy, AI and CSR information for all Piano products now lives in one place. Explore our Compliance Center.
Analytics
English French
English French

What are unclassified campaigns?

An unclassified campaign is a visit counted as marketing traffic whose source type can't be determined because the src_medium property is empty or missing. Marketing campaigns need at least two properties to be processed correctly: src_medium and src_campaign. If Piano Analytics collects src_campaign without src_medium, the visit is still counted as a marketing source, but it's classified as Unclassified campaign. The source type is defined only by src_medium.

Causes

Unclassified campaigns usually happen when one of the required marketing source properties isn't populated at collection time. The most common cases are:

  • src_campaign is present, but src_medium is empty or missing.

  • The URL parameters don't provide a medium value, for example utm_medium is missing, so src_medium can't be derived or mapped.

Because src_medium determines the type of the source, a missing src_medium prevents Piano Analytics from putting the campaign in a medium-based category.

Reduce unclassified campaigns

  • Include a medium in your tagging: if you use UTM parameters, make sure your campaign links always include a medium value, for example utm_medium, so that src_medium can be filled in.

  • Use a processing rule: if utm_medium isn't reliably present, you can use a processing rule that sets src_medium from another available parameter, such as utm_source, when src_medium is empty. A common rule is:

    • Condition: if src_medium is empty, utm_medium is empty, and utm_source isn't empty.

    • Action: set src_medium to the value of utm_source.

    • Optional: apply a mapping table that replaces src_medium with a standard value when it finds a match, for example to turn partner-specific values into your own medium categories.

Processing rules aren't retroactive. They only apply to events collected after you create or update the rule. Data already collected as Unclassified campaign isn't reprocessed.

Last updated: