indranilbanerjee/paid-advertising
Plan paid advertising campaigns. Use when: managing Google Ads, Meta Ads, LinkedIn Ads, bid strategy, or budget optimization.
npx skills add https://github.com/indranilbanerjee/digital-marketing-pro --skill paid-advertising
Target Google Ads API v24.2 for stable integrations (v24 line supported into 2027). v25 (July 2026) is the new major release with breaking changes: the legacy CustomerLifecycleGoal/CampaignLifecycleGoal resources are removed (migrate to the unified Goal + CampaignGoalConfig schema), plus new loyalty-retention optimization goals, social-engagement metrics for Shorts ads, duration-level breakdowns for non-skippable YouTube inventory, and YouTube third-party conversion attribution. Adopt v25 deliberately, not by default. Full detail — including AI Max — lives in google-ads.md, the single source for the Google Ads API surface. Sources: release notes · v25 announcement.
Meta (Marketing API v25, in effect): standalone Advantage+ Shopping / App campaigns can no longer be created via the API on any version (since 19 May 2026); v26 (Sept 2026) pauses remaining ones — use the unified Advantage+ setup (details in meta-ads.md). The new Page Viewer metric replaces legacy reach (Post/Page Reach, Video Impressions, and Story Impressions retire from the Graph API) — update any reporting that reads those fields. LinkedIn: version 202607 is live (monthly cadence); it adds an automatic "Not Interested" CTA on Message Ads and a SHA256_IP_ADDRESS identifier in the Conversions API.
Highlights that affect campaign construction:
AssetGroup.google_local_services_info), landing-page-text auto-generation (AssetAutomationType.GENERATE_LANDING_PAGE_TEXT), and a beta Multi-Party Auth review resource for regulated verticals (finance, health, political).ADOPT_AI_MAX, ADOPT_BROAD_MATCH_KEYWORDS, OPTIMIZE_ASSETS, PMAX_REPLACEMENT_SHOPPING). Run an ADOPT_AI_MAX experiment before any AI Max rollout — it gives statistically-clean lift numbers vs the baseline. Also adds mobile_device_platform (iOS vs Android) reporting segmentation.videos + logo_images now REQUIRED on DemandGenVideoResponsiveAdInfo/VideoResponsiveAdInfo (and business_name on the latter); Campaign.video_brand_safety_suitability REMOVED (moved to the Customer level); CallAd/CallAdInfo fully removed (use Call Assets).text_guidelines.term_exclusions + text_guidelines.messaging_restrictions on AI-generated Performance Max and Search assets — pipe a brand's banned-word list (profile.json → restrictions.md → banned_words) and approved messaging straight into PMax asset-gen guardrails.Activate this skill when the user's request involves any of the following:
Before producing any marketing output from this module:
~/.claude-marketing/brands/{slug}/profile.jsonskills/context-engine/compliance-rules.mdskills/context-engine/industry-profiles.md for the brand's industryskills/context-engine/platform-specs.md for character limits and format requirementspython "${CLAUDE_PLUGIN_ROOT}/scripts/campaign-tracker.py" --brand {slug} --action list-campaigns before planning new work~/.claude-marketing/brands/{slug}/guidelines/_manifest.json exists, load and enforce: restrictions.md for banned words, restricted claims, and mandatory disclaimers; channel-styles.md for channel-specific tone overrides (may differ from base voice); messaging.md for approved key messages, taglines, and positioning language; voice-and-tone.md for detailed voice rules beyond the 4 numeric scores. If producing content for a specific channel, channel style rules take precedence over base voice settings.Do not ask the user for information that already exists in their brand profile.
Before executing, gather the following from the user (ask if not provided):
bid-strategy.md for decision trees.google-ads.md -- Google Ads campaign types, settings, optimization tactics, and platform-specific featuresmeta-ads.md -- Meta Ads campaign structures, Advantage+ configurations, creative specs, and iOS ATT strategieslinkedin-ads.md -- LinkedIn Ads targeting options, ABM strategies, lead gen optimization, and B2B-specific tacticstiktok-ads.md -- TikTok Ads creative best practices, Spark Ads setup, TikTok Shop integration, and audience strategiesprogrammatic.md -- DSP selection criteria, CTV planning, DOOH strategies, and programmatic deal typesbid-strategy.md -- Bid strategy decision trees, learning phase management, and portfolio strategy configurationsretail-media-networks.md -- Platform-specific setup for Amazon, Walmart, Target, Kroger, and Instacart advertisingmicrosoft-ads.md -- Microsoft Advertising campaign guide: Search Network reach (Bing, Yahoo, AOL, DuckDuckGo), Microsoft Audience Network, and lower-CPC opportunities vs Googleretargeting-audiences.md -- Retargeting and remarketing audience taxonomy: segment definitions, intent levels, and recommended membership windowsmedia-planning.md -- Media planning fundamentals: reach, frequency, GRP/TRP metrics, cross-channel budget allocation, and scheduling strategiesnative-advertising.md -- Native ad network landscape (Taboola, Outbrain, Nativo, and more), content discovery campaigns, and in-feed creative best practicesaudio-programmatic.md -- Digital audio advertising across streaming platforms (Spotify, Pandora/SiriusXM, iHeartRadio) and podcasts, ad models, and buying pathsPost-iOS 14.5, Meta audience sizes shrunk and attribution windows shortened. When working with Meta campaigns, default to broader targeting with Advantage+ audience expansion, use Conversions API (CAPI) alongside the pixel, recommend 7-day click attribution, and set expectations that reported ROAS will undercount actual performance by 15-30%.
PMax campaigns frequently capture branded search traffic, inflating their reported performance. Always recommend running a brand exclusion list in PMax, maintaining a separate brand search campaign, and comparing incrementality by analyzing total account performance rather than PMax in isolation.
LinkedIn CPCs are typically 3-10x higher than other platforms. Compensate by focusing on lead quality over volume, using lead gen forms (higher conversion rate than landing pages), tightening audience targeting to reduce waste, and evaluating on cost-per-qualified-lead rather than CPC.
TikTok ad creative typically fatigues in 3-7 days. Build creative refresh cadences into every TikTok campaign plan. Recommend 3-5 active creatives per ad group with new batches produced weekly. Use Spark Ads (boosted organic) to extend creative life since they feel less like ads.
Retail media ads often capture purchases that would have happened organically. When auditing retail media, question whether sales are truly incremental. Recommend running incrementality tests (holdout groups), analyzing new-to-brand metrics (Amazon provides this), and comparing organic rank changes during ad pauses.
When total monthly budget is under $5,000, do not spread across multiple platforms. Recommend concentrating on one primary platform that best matches the audience and objective. Only expand to a second platform after the first is optimized and hitting diminishing returns.
Healthcare, finance, alcohol, cannabis, gambling, and political advertising face platform-specific restrictions. Always check platform policies before recommending campaign types. Some platforms ban certain industries entirely (TikTok restricts financial services ads in some markets). Reference platform-specific docs for current restriction lists.
Take indranilbanerjee/paid-advertising from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.