=== EngageMuse Insights ===
Contributors: wpbww
Tags: marketing, ai, audience-analytics, demographics, psychographics
Requires at least: 6.8
Tested up to: 6.9
Requires PHP: 8.1
Stable tag: 0.9.5
License: GPL-3
License URI: https://www.gnu.org/licenses/gpl-3.0.html

EngageMuse Insights uses AI to analyze each post and builds a profile of its ideal reader, based on dimensions you choose.

== Description ==

**EngageMuse Insights** is a simple way to see who your post will truly speak to. Click **Analyze** and get an **Audience Profile** with up to eight **Audience Dimensions** (e.g., Emotional State, Core Values & Beliefs, Decision-Making Style). Each dimension yields plain-language **Descriptors**—with confidence rankings—or **indeterminate** when there isn’t a clear signal.

## What you can do
- Analyze a single post while editing, even while unsaved
- Analyze a small batch of posts, with any status, from a clean table view
- Use smart defaults or type your own Audience Dimensions  
- Optionally Add **schema.org** and **JSON** to the page head  
- Run on the **Free plan**, or connect your own model: **OpenAI** or **Google Gemini**

## How it works
1. Choose your Audience Dimensions (up to 8).  
2. Click **Analyze**.  
3. Review the Audience Profile and adjust headlines, tone, or CTAs.

## Why it matters
- Aim content at the right readers—before you publish  
- Replace hunches with quick, shareable evidence  
- Reduce wasted impressions by avoiding tone-deaf placements—e.g., exuberant CTAs on somber stories  

Ship smarter posts with a light touch. **Measure resonance, not just reach.**

This plugin is currently in a "public beta" phase. Please report feedback or bugs to [our development team](mailto:dev@engagemuse.com). [Development source](https://gitlab.com/bushnellwebworks/wp-projects/-/tree/main/plugins/engagemuse/engagemuse-insights)

== Frequently Asked Questions ==

= What does "Analyze" do? =

It generates an **Audience Profile** for each post: up to eight **Audience Dimensions** (e.g., Emotional State, Core Values & Beliefs, Decision-Making Style), each yielding plain-language **Descriptors.** If there isn’t a clear signal, the dimension is marked **indeterminate.**

= What’s the point of “indeterminate”? =

It’s a signal of absence, not a failure. **Indeterminate** means the reader dimension isn’t clearly expressed in the post. Use it as a prompt to revise—add details, cues, or examples—so that dimension becomes legible and can surface as a clear Descriptor next time.

= Do I need an account to use EngageMuse Insights? =

No. You can use the **free, anonymous version** with limited usage. For higher volume and model choice, connect your own OpenAI or Google Gemini API key and analyze content using your provider account.

= What data is sent to third-party models? =

Only the post’s **title and body text** you choose to analyze. We don’t send site settings, user data, comments, or analytics. Optional exports (schema.org/JSON) are generated locally and aren’t shared with model providers.

= Are hooks available? =

Yes. EngageMuse Insights includes developer actions and filters for customizing analysis, configs, exports, and CSV outputs. See the developer docs at [engagemuse.com](https://www.engagemuse.com) for the full reference.

== Screenshots ==

1. Choose or create **Dimensions** to capture segment information inferred from the text.
2. Analyze your post while editing, even if it's unsaved.
3. View and analyze batches of posts. AI also provides meaningful explanations for why Descriptors were chosen.

== External services ==

This plugin connects to an API to communicate with a Large Language Model. It sends only the title and content of selected posts. Depending on configuration, these are the services used:
1. Open AI: [Terms & policies](https://openai.com/policies/)
2. Google Gemini: [Terms](https://ai.google.dev/gemini-api/terms) [Policies](https://ai.google.dev/gemini-api/docs/usage-policies)
3. If using the Free Tier, requests are sent to a private endpoint at api.busww.com, where they are proxied to an Open AI endpoint. [Terms](https://api.busww.com/terms.html) [Privacy Policy](https://api.busww.com/privacy.html)

== Changelog ==

= 0.9.5 =
* Public beta

