Skip to content

paid-media: add optional denormalized-names fieldgroup for summary metrics#2186

Closed
ejsuncy wants to merge 2 commits into
adobe:masterfrom
ejsuncy:add-paid-media-denormalized-names-fieldgroup
Closed

paid-media: add optional denormalized-names fieldgroup for summary metrics#2186
ejsuncy wants to merge 2 commits into
adobe:masterfrom
ejsuncy:add-paid-media-denormalized-names-fieldgroup

Conversation

@ejsuncy
Copy link
Copy Markdown
Contributor

@ejsuncy ejsuncy commented May 28, 2026

Summary

Adds a new optional fieldgroup core-paid-media-denormalized-names and references it from the paid-media-summary-metrics schema.

The fieldgroup carries inline entity display names (accountName, campaignName, adGroupName, adName, experienceName, assetName, portfolioName) on each summary row.

Motivation

The current Paid Media model expects entity names to be resolved via the per-entity lookup datasets (paid-media-campaign-lookup, paid-media-ad-group-lookup, etc.) to avoid duplicating name strings on every summary row.

For the MCA (Marketing Campaign Analytics) single-dataset use case — where a customer brings their own paid media data in a single flat feed without separate lookup datasets — there is no way today to surface entity names in reporting.

This change introduces an optional fieldgroup so:

  • Lookup-driven ingestions leave xdm:paidMedia.xdm:denormalizedNames.* null and resolve names via lookups (no regression, no bloat).
  • MCA / single-dataset ingestions populate the fields inline.

Files

  • New: components/fieldgroups/paid-media/core-paid-media-denormalized-names.schema.json
  • New: components/fieldgroups/paid-media/core-paid-media-denormalized-names.example.1.json
  • Modified: schemas/paid-media/paid-media-summary-metrics.schema.json — added $ref to the new fieldgroup in allOf.

Notes

  • Fieldgroup is marked meta:status: experimental consistent with the rest of the paid-media schemas.
  • Open question: whether MCA needs additional cross-channel fields here (e.g., Big-C Marketing Campaign, Marketing Channel) — likely belongs in a separate shared MCA fieldgroup rather than this one. Tracking that conversation with Amanda Diamante.

Dan Bunker and others added 2 commits May 28, 2026 17:13
…trics

Adds core-paid-media-denormalized-names fieldgroup carrying inline entity
display names (account, campaign, ad group, ad, experience, asset, portfolio)
on the paid media summary metrics dataset. Intended for ingestion shapes
where lookup datasets are not available (e.g., MCA single-dataset feeds);
lookup-driven ingestions leave the block null and continue resolving names
via the corresponding lookup datasets.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Adds example.8 illustrating the MCA single-dataset use case: a summary
row with denormalizedNames.* populated inline (no lookup datasets
required).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@ejsuncy
Copy link
Copy Markdown
Contributor Author

ejsuncy commented May 28, 2026

Replacing with a properly-tagged PR linked to #2187. Reopening from a renamed branch following CONTRIBUTING.md guidance.

@ejsuncy ejsuncy closed this May 28, 2026
@ejsuncy ejsuncy deleted the add-paid-media-denormalized-names-fieldgroup branch May 28, 2026 23:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant