plugin-marketing

Beta

@fayz-ai/plugin-marketing

Marketing analytics are always the same shape — channels, campaigns, a funnel, landing-page CVR — but what counts as a "conversion" changes per business. A salon converts a booking, a store converts an order, an agency converts a lead. plugin-marketing is one plugin that adapts to all of them: pick a domain preset (or pass an explicit conversion model + channels) and the funnel, channel…

Preview of plugin-marketing as the customer sees it

Full documentation is coming. For now, this page summarizes what the SDK catalog knows about the plugin.

Specs

Package	`@fayz-ai/plugin-marketing`
Version	0.2.1
Status	beta
Capability	Partial capability
Stable channel	`^0.2.1`
Migrations	4 migration(s)
Factory	`createMarketingPlugin()`

Data model

Table	Key columns
`plg_marketing_social_accounts`	name, handle, platform, is_active
`plg_marketing_content_plans`	account_id, name, status, weeks_count, start_date, objective
`plg_marketing_content_posts`	plan_id, week_number, position, title, format, status
`plg_marketing_ranklayer_integrations`	api_key, site_domain, active, last_sync_at
`plg_marketing_ranklayer_sync_log`	integration_id, status, message, fetched, written
`plg_marketing_channels`	channel_key, label, icon, kind, is_active, monthly_spend
`plg_marketing_campaigns`	name, channel_key, status, starts_at, ends_at, spend

Convention: plg_ + tenant_id + RLS. Data model.

AI tools

id	mode	description
`marketing.channel-performance`	read	Returns acquisition performance per channel (reach, conversions, CVR, spend, CPA).
`marketing.top-channels`	read	Returns the top acquisition channels ranked by conversions.
`marketing.campaign-cvr`	read	Lists campaigns with their conversion rate for a date range.
`marketing.create-campaign`	persist	Creates an acquisition campaign on a channel. Resolve the channel first via queryData/searchRecords on marketing channels (use its channel key). The user confirms before creating.

Tools an agent can call against your app. Your app as a data layer.

Integrations

No hosted connector — external providers come in via the connector spine. integrations catalog.

Use this page as a skill. .md of this page is the agent-consumable contract — data model, tools and integrations in a single file an AI reads directly. Preview fayz skill add plugin-marketing is coming soon to install this as a skill. See Skills.

Integrate

Add the plugin to surfaces.admin.plugins in your app's app.manifest.json and run the doctor to validate:

{
  "surfaces": {
    "admin": {
      "plugins": [
        { "id": "marketing", "enabled": true }
      ]
    }
  }
}

npx fayz doctor

fayz doctor checks the manifest against the SDK catalog. See Configuration.