Skip to content

v1.8.0

Choose a tag to compare

View all tags
@amurph491 amurph491 released this 13 Aug 19:16
· 74 commits to main since this release
v1.8.0
2ed6058
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Spotify Ads API Plugin v1.8.0

This release expands the plugin beyond campaign management with new audience, measurement, account-administration, and change-audit workflows. It also makes draft staging the default for campaign hierarchy changes, updates the bundled API reference to the August 2026 Ads API surface, and strengthens OAuth token handling.

Highlights

Safer campaign changes with drafts by default

Campaign, ad-set, and ad creation and modification now use the draft workflow by default. Changes are staged, the complete hierarchy is validated, and nothing is published without explicit confirmation.

  • Stage changes to published entities without immediately affecting delivery
  • Preserve and disclose existing draft work before combining changes
  • Validate complete campaign hierarchies before publishing
  • Group and validate bulk changes by campaign
  • Use direct live writes only when explicitly requested

Audience management

New audience workflows support:

  • Customer-list uploads and replacements
  • Web-event and ad-engagement audiences
  • Lookalike audiences
  • Audience discovery, editing, status checks, and deletion

Conversion measurement

New measurement skills help teams plan, configure, and troubleshoot:

  • Spotify Pixel
  • Conversions API (CAPI)
  • Datasets and ad-account sharing
  • Advanced matching and event mapping
  • Mobile app measurement
  • Missing, stale, duplicated, misrouted, or unattributed events

Measurement debugging is read-only-first and avoids creating test conversions without explicit confirmation.

Account administration and change history

New administration and audit workflows support:

  • Business and ad-account discovery
  • Member and role audits
  • Invitations and access assignments
  • Supported account updates
  • Change-history queries showing who changed campaigns, ad sets, creatives, budgets, targeting, statuses, and other settings

Change-history results cover the API's rolling 180-day retention window.

API and documentation updates

  • Updated the bundled OpenAPI specification and reference documentation to the August 2026 Ads API surface
  • Replaced deprecated objective usage on draft campaigns with delivery_goal_group
  • Removed unsupported dma_ids targeting guidance
  • Updated budget and bid documentation for ad accounts using any billing currency
  • Clarified that AUTOBID enables automatic bidding without bid_micro_amount; UNSET should not be selected for new ad sets
  • Documented draft-only field optionality
  • Added handling for FAILED ad and asynchronous-report statuses
  • Added experiment-availability and attribution-window reference coverage
  • Refreshed natural-language routing, plugin prompts, onboarding instructions, marketplace descriptions, and examples

Security and reliability

  • Hardened OAuth token refresh for tokens containing pipes, ampersands, backslashes, wildcard characters, and other shell metacharacters
  • Added 36 regression checks covering settings updates, token substitution, settings discovery, and hook response formats
  • Improved retry safety and guidance for ambiguous non-idempotent API failures
  • Prevented direct-write permission errors from being misreported as proof that credentials are entirely read-only

Upgrade notes

  • Draft publishing always requires explicit confirmation, even when automatic execution is enabled.
  • Existing direct/live workflows remain available when explicitly requested.
  • The plugin version is synchronized as 1.8.0 across Claude Code, Codex, and Antigravity manifests.

Full changelog: v1.7.0...v1.8.0

Assets 2
Loading