Add PMax ad group type, dimensional breakdown fields, and impression share docs (#2128)#2129
Open
ejsuncy wants to merge 3 commits intoadobe:masterfrom
Open
Conversation
…share docs (adobe#2128) Support Performance Max campaigns by adding performance_max_asset_group to adGroupType enum. Add adNetworkType and adSlot to dimensional breakdowns for Google Ads network/slot-level reporting. Add field-level descriptions to impression share metrics noting Campaign/Ad Group level availability. Includes new examples for PMax ad groups, experiences, and summary metrics with network breakdowns. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
PMax asset-level quantitative metrics ARE available via asset_group_asset (impressions, clicks, CTR, conversions, cost). The flag was based on a mistaken assumption that only qualitative labels exist. Removed it from both experience examples to avoid misleading consumers of these schemas. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Qualitative performance labels (BEST/GOOD/LOW/LEARNING) are not confirmed to be available via asset_group_asset for PMax campaigns. The quantitative metrics (impressions, clicks, conversions, cost) from asset_group_asset are what matter for content performance analysis. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Addresses five open questions from the Paid Media XDM Schema review. Closes #2128.
Schema changes:
performance_max_asset_grouptoxdm:adGroupTypeenum incore-paid-media-adgroup-detailsto represent Google PMax Asset Groups (the Ad Group equivalent in PMax)xdm:adNetworkType(search, display, youtube, shopping, discover, gmail, maps, search_partners) andxdm:adSlot(top, absolute_top, other) tocore-paid-media-dimensional-breakdownsfor network/slot-level reportingxdm:impressionShareobject and top-level impression share fields incore-paid-media-cost-metricsnoting Campaign/Ad Group level availability onlyNew examples:
No schema changes needed for:
additionalDetails)PMax asset performance note:
PMax asset-level quantitative metrics are available via the
asset_group_assetAPI resource (impressions, clicks, CTR, conversions, conversion value, cost — segmentable byad_network_type). Thead_group_ad_asset_viewresource does not work for PMax, butasset_group_assetis purpose-built for it. The schema change here (mapping Asset Groups as Ad Groups withPERFORMANCE_MAX_ASSET_GROUPtype) provides the join key needed forasset_group_assetmetric rows to resolve to asset/campaign metadata. The ingest pipeline must pull and store Asset Group metadata for the joins to work.Internal documentation: Paid Media XDM Schema - Open Questions Recommendations