
Pmax Optimization
- 73 installs
- 31 repo stars
- Updated April 12, 2026
- itallstartedwithaidea/agent-skills
pmax-optimization is a skill that performance Max Optimization is an agent skill from the Agent Skills and googleadsagent.ai lineage aimed at solo founders and marketers who run Google Ads but struggle to steer Performan
About
Performance Max Optimization is an agent skill from the Agent Skills and googleadsagent.ai lineage aimed at solo founders and marketers who run Google Ads but struggle to steer Performance Max’s opaque automation. PMax blends inventory across Search, Display, YouTube, Discover, Gmail, and Maps; Google handles much delivery, yet advertiser inputs—asset group architecture, creative quality, audience signals, URL expansion rules, and search themes—largely determine whether spend scales efficiently or bleeds budget. The skill frames PMax as a black box you influence structurally: map asset groups to offers or segments, seed signals that accelerate learning without choking reach, lock down URL expansion where brand safety matters, and use search themes to nudge Search appearances. It also emphasizes ongoing asset rating hygiene (Best, Good, Low) so underperforming creative gets replaced before ROAS decays. Install it when you already run or plan PMax and need expert playbooks in-agent instead of generic Google help articles.
- Covers full Google inventory: Search, Display, YouTube, Discover, Gmail, and Maps in one automated campaign type
- Structural guidance: asset groups mapped to product lines or audience segments
- Audience signals, URL expansion, brand-safety balance, and search themes for Search placement influence
- Asset performance ratings workflow: Best, Good, Low, and combination availability monitoring
Pmax Optimization by the numbers
- 73 all-time installs (skills.sh)
- +8 installs in the week ending Aug 2, 2026 (Skillselion tracking)
- Ranked #1,210 of 1,879 Marketing & SEO skills by installs in the Skillselion catalog
- Security screen: LOW risk (skills.sh audit)
- Data as of Aug 4, 2026 (Skillselion catalog sync)
npx skills add https://github.com/itallstartedwithaidea/agent-skills --skill pmax-optimizationAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 73 |
|---|---|
| repo stars | ★ 31 |
| Security audit | 3 / 3 scanners passed |
| Last updated | April 12, 2026 |
| Repository | itallstartedwithaidea/agent-skills ↗ |
How do I optimize Google Performance Max campaigns—structure, assets, audience signals, and URL settings—for efficient paid growth.?
Optimize Google Performance Max campaigns—structure, assets, audience signals, and URL settings—for efficient paid growth.
Who is it for?
Best when you're working on marketing & seo and need structured help with pmax optimization.
Skip if: Teams with no marketing & seo needs, or anyone wanting a generic chat assistant without this specific workflow.
When should I use this skill?
When you need to optimize Google Performance Max campaigns—structure, assets, audience signals, and URL settings—for efficient paid growth., or when performance max optimization is an agent skill from the agent skills an
What you get
Structured output aligned to pmax-optimization: Covers full Google inventory: Search, Display, YouTube, Discover, Gmail, and Maps in one automated campaign type, Structural guidance: asset groups mapped to product lines
Files
Performance Max Optimization
Part of Agent Skills™ by googleadsagent.ai™
Description
The Performance Max Optimization skill provides expert-level management of Google's most automated campaign type. Performance Max (PMax) campaigns serve across all Google inventory — Search, Display, YouTube, Discover, Gmail, and Maps — using AI-driven targeting. While Google automates much of the delivery, the advertiser's strategic inputs dramatically influence performance: asset quality, audience signals, URL strategies, search themes, and campaign structure determine whether PMax delivers efficient growth or wasteful spend.
This skill addresses the core challenge of PMax: optimizing a black-box system. It establishes structural best practices (asset group architecture mapped to product lines or audience segments), configures audience signals that accelerate machine learning without constraining reach, manages URL expansion settings to balance automation with brand safety, and leverages the search themes feature to influence where PMax appears on Search.
Critical to PMax success is asset performance management. The skill monitors asset performance ratings (Best, Good, Low, combinations available), identifies underperforming creative elements, and generates replacement assets. It also manages the often-overlooked negative controls: brand exclusions to prevent cannibalization of branded search campaigns, negative keywords (available via API or Google rep), and placement exclusions to maintain brand safety on Display and YouTube inventory.
Use When
- User asks about "Performance Max" or "PMax" campaigns
- User wants to "optimize PMax" or "improve PMax performance"
- User mentions "asset groups" or "asset performance"
- User asks about "audience signals" for PMax
- User mentions "URL expansion" or "final URL" settings
- User wants to "add search themes" to PMax
- User asks about "PMax cannibalization" of Search campaigns
- User mentions "PMax negative keywords" or "brand exclusions"
- User wants to "structure PMax campaigns" or "create asset groups"
Architecture
flowchart TD
A[PMax Campaign Analysis] --> B[Structural Assessment]
A --> C[Asset Performance Review]
A --> D[Signal Quality Evaluation]
B --> B1[Asset Group Architecture]
B --> B2[Campaign Segmentation]
B --> B3[URL Expansion Settings]
B --> B4[Bidding Configuration]
C --> C1[Headlines: Best/Good/Low]
C --> C2[Descriptions: Best/Good/Low]
C --> C3[Images: Best/Good/Low]
C --> C4[Videos: Best/Good/Low]
C --> C5[Ad Strength Rating]
D --> D1[Custom Segments]
D --> D2[Your Data Lists]
D --> D3[Google Audiences]
D --> D4[Demographics]
B1 --> E[Optimization Engine]
B2 --> E
B3 --> E
B4 --> E
C1 --> E
C2 --> E
C3 --> E
C4 --> E
D1 --> E
D2 --> E
D3 --> E
D4 --> E
E --> F[Structural Recommendations]
E --> G[Asset Replacement Queue]
E --> H[Signal Refinements]
E --> I[Negative Controls]
I --> I1[Brand Exclusions]
I --> I2[Negative Keywords via API]
I --> I3[Placement Exclusions]
I --> I4[Search Theme Adjustments]Implementation
PMax campaign assessment and optimization engine:
async function optimizePMax(customerId, campaignId) {
const campaign = await getPMaxCampaignData(customerId, campaignId);
const assetGroups = await getAssetGroups(customerId, campaignId);
const audienceSignals = await getAudienceSignals(customerId, campaignId);
const searchTermInsights = await getSearchTermInsights(customerId, campaignId);
return {
structuralAssessment: assessStructure(campaign, assetGroups),
assetPerformance: analyzeAssets(assetGroups),
signalQuality: evaluateSignals(audienceSignals),
searchAnalysis: analyzeSearchTerms(searchTermInsights),
recommendations: generateRecommendations(campaign, assetGroups, audienceSignals),
negativeControls: reviewNegativeControls(campaign)
};
}
function assessStructure(campaign, assetGroups) {
const issues = [];
if (assetGroups.length === 1 && campaign.productCount > 20) {
issues.push({
severity: 'high',
finding: 'Single asset group serving all products',
recommendation: 'Split into themed asset groups by product category for tailored messaging'
});
}
for (const group of assetGroups) {
if (group.headlines.length < 5) {
issues.push({
severity: 'medium',
assetGroup: group.name,
finding: `Only ${group.headlines.length} headlines (minimum 5, recommended 15)`,
recommendation: 'Add headlines to maximize ad combination options'
});
}
if (!group.videos || group.videos.length === 0) {
issues.push({
severity: 'high',
assetGroup: group.name,
finding: 'No videos provided — Google will auto-generate low-quality videos',
recommendation: 'Upload at least one custom video to prevent auto-generation'
});
}
if (group.adStrength !== 'EXCELLENT') {
issues.push({
severity: 'medium',
assetGroup: group.name,
finding: `Ad strength: ${group.adStrength} (target: Excellent)`,
recommendation: 'Add more unique, diverse assets to improve ad strength'
});
}
}
return {
urlExpansion: campaign.urlExpansionEnabled,
finalUrlStrategy: campaign.finalUrlStrategy,
biddingStrategy: campaign.biddingStrategy,
issues
};
}
function analyzeAssets(assetGroups) {
const analysis = [];
for (const group of assetGroups) {
const allAssets = [
...group.headlines.map(a => ({ ...a, type: 'headline' })),
...group.descriptions.map(a => ({ ...a, type: 'description' })),
...group.images.map(a => ({ ...a, type: 'image' })),
...(group.videos || []).map(a => ({ ...a, type: 'video' }))
];
const lowPerformers = allAssets.filter(a => a.performanceLabel === 'LOW');
const bestPerformers = allAssets.filter(a => a.performanceLabel === 'BEST');
analysis.push({
assetGroup: group.name,
totalAssets: allAssets.length,
performanceDistribution: {
best: bestPerformers.length,
good: allAssets.filter(a => a.performanceLabel === 'GOOD').length,
low: lowPerformers.length,
learning: allAssets.filter(a => a.performanceLabel === 'LEARNING').length
},
replacementCandidates: lowPerformers.map(a => ({
type: a.type,
content: a.text || a.url,
performanceLabel: a.performanceLabel,
action: 'replace_with_new_variant'
})),
topPerformers: bestPerformers.map(a => ({
type: a.type,
content: a.text || a.url,
insight: 'Use this as a template for new variants'
}))
});
}
return analysis;
}Search themes and negative keyword management:
function configureSearchThemes(campaign, searchTermInsights) {
const topConvertingTerms = searchTermInsights
.filter(t => t.conversions > 0)
.sort((a, b) => b.conversionValue - a.conversionValue);
const missingCoverage = searchTermInsights
.filter(t => t.impressionShare < 0.3 && t.conversions > 0);
return {
recommendedThemes: topConvertingTerms.slice(0, 25).map(t => ({
theme: t.searchTerm,
rationale: `${t.conversions} conversions, ${formatCurrency(t.conversionValue)} value`,
searchVolume: t.estimatedVolume
})),
expansionOpportunities: missingCoverage.map(t => ({
theme: t.searchTerm,
currentImpressionShare: t.impressionShare,
potentialGain: `Up to ${((1 - t.impressionShare) * t.conversions).toFixed(0)} additional conversions`
})),
maxThemes: 25
};
}
async function manageNegativeKeywords(customerId, campaignId) {
const searchTerms = await getSearchTermInsights(customerId, campaignId);
const negatives = searchTerms.filter(term =>
term.clicks > 5 && term.conversions === 0 && term.cost > 50
);
return {
recommendedNegatives: negatives.map(n => ({
term: n.searchTerm,
clicks: n.clicks,
cost: n.cost,
matchType: 'EXACT'
})),
implementation: {
method: 'google_ads_api',
note: 'PMax negative keywords require API access or Google rep assistance',
apiEndpoint: 'CampaignCriterionService',
criterionType: 'KEYWORD',
negativeType: 'campaign_level'
},
brandExclusions: {
enabled: true,
excludedBrands: [],
recommendation: 'Exclude own brand if running separate branded Search campaigns'
}
};
}Integration with Buddy™ Agent
Performance Max Optimization is a high-priority skill within Buddy™ Agent because PMax campaigns increasingly dominate Google Ads account spend. Buddy™ monitors PMax asset performance ratings daily, automatically flagging "Low" rated assets and generating replacement suggestions using the Ad Copy Generation skill.
Buddy™ addresses the PMax transparency challenge by correlating search term insights with conversion data, building a clearer picture of where PMax is finding conversions. It detects Search campaign cannibalization by monitoring branded query attribution and recommends brand exclusions when PMax is consuming branded traffic at higher CPCs than dedicated Search campaigns.
The platform manages audience signal lifecycle, refreshing Customer Match lists on schedule and recommending signal updates as conversion patterns shift. For e-commerce accounts, Buddy™ coordinates PMax with the Shopping Ads skill to optimize product feed data that directly impacts PMax Shopping placements.
Best Practices
1. Create separate asset groups for distinct product categories or audience segments 2. Provide at least 15 headlines, 4 descriptions, 15 images, and 1+ custom videos per asset group 3. Upload custom videos to prevent Google from auto-generating low-quality video assets 4. Add search themes to guide PMax's Search inventory placement toward high-intent queries 5. Enable brand exclusions if running separate branded Search campaigns to prevent cannibalization 6. Review asset performance weekly and replace "Low" rated assets within 2 weeks 7. Start with strong audience signals (Customer Match, remarketing lists) to accelerate learning 8. Disable URL expansion if you need strict control over which landing pages receive traffic 9. Allow 4-6 weeks for PMax to exit the learning phase before making structural changes 10. Monitor search term insights weekly and add negative keywords for irrelevant queries via API
Platform Compatibility
| Platform | Supported |
|---|---|
| Claude Code | ✅ |
| Cursor | ✅ |
| Codex | ✅ |
| Gemini | ✅ |
Related Skills
- Audience Targeting - Audience signals are critical inputs that accelerate PMax machine learning
- Shopping Ads - Product feed quality directly impacts PMax Shopping placements
- Ad Copy Generation - Asset generation and replacement for PMax headlines, descriptions, and creative
- Continuous Learning - Auto-discovers optimization patterns from PMax campaign performance data
Keywords
performance max, pmax optimization, asset groups, audience signals, search themes, pmax assets, url expansion, pmax negative keywords, brand exclusions, asset performance, pmax campaign structure, pmax best practices, google pmax, performance max campaigns, pmax cannibalization
---
© 2026 googleadsagent.ai™ | Agent Skills™ | MIT License
Related skills
FAQ
What does pmax-optimization do?
Performance Max Optimization is an agent skill from the Agent Skills and googleadsagent.ai lineage aimed at founders and marketers who run Google Ads but struggle to steer Performance Max’s opaque automation.
When should I use pmax-optimization?
When you need to optimize Google Performance Max campaigns—structure, assets, audience signals, and URL settings—for efficient paid growth., or when performance max optimization is an agent skill from the agent skills and googleadsagent.
What are the main capabilities?
Covers full Google inventory: Search, Display, YouTube, Discover, Gmail, and Maps in one automated campaign type; Structural guidance: asset groups mapped to product lines or audience segments; Audience signals, URL expansion, brand-safety balance, and search themes for Search pl
Is Pmax Optimization safe to install?
skills.sh reports 3 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.