From 9af932bdfa79c1397bad89c213e472781dae46ae Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 11 Sep 2025 17:00:31 +0000 Subject: [PATCH 1/3] Update ai/ads.mdx --- ai/ads.mdx | 58 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 58 insertions(+) create mode 100644 ai/ads.mdx diff --git a/ai/ads.mdx b/ai/ads.mdx new file mode 100644 index 000000000..508d7af96 --- /dev/null +++ b/ai/ads.mdx @@ -0,0 +1,58 @@ +--- +title: AI ads +description: Configure AI-powered advertising and promotional content +--- + +# AI ads + +Use AI ads to automatically generate and optimize promotional content for your documentation. This feature leverages artificial intelligence to create contextually relevant advertisements and promotional materials. + +## Overview + +AI ads analyze your documentation content and user behavior to generate targeted promotional content that enhances user engagement without disrupting the reading experience. + +## Configuration + +To enable AI ads in your documentation: + +1. Navigate to your dashboard settings +2. Enable the AI ads feature +3. Configure your advertising preferences +4. Set targeting parameters + +## Ad Types + +### Contextual ads +Automatically generated ads based on the current page content and user context. + +### Product recommendations +AI-powered suggestions for related products or services based on user behavior. + +### Content promotion +Intelligent promotion of relevant documentation sections or resources. + +## Customization + +You can customize the appearance and behavior of AI ads: + +- **Placement**: Choose where ads appear in your documentation +- **Frequency**: Control how often ads are displayed +- **Styling**: Match ads to your documentation theme +- **Targeting**: Define audience segments and targeting criteria + +## Analytics + +Track the performance of your AI ads with built-in analytics: + +- Click-through rates +- Engagement metrics +- Conversion tracking +- A/B testing results + +## Best Practices + +- Keep ads relevant to your documentation content +- Monitor performance metrics regularly +- Test different ad placements and formats +- Ensure ads don't interfere with user experience +- Comply with advertising regulations and privacy policies \ No newline at end of file From 06f42f996d87774d6a7903856a680be200530ea5 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 11 Sep 2025 17:00:48 +0000 Subject: [PATCH 2/3] Update docs.json --- docs.json | 1 + 1 file changed, 1 insertion(+) diff --git a/docs.json b/docs.json index b62a3820b..cac7cce93 100644 --- a/docs.json +++ b/docs.json @@ -57,6 +57,7 @@ "ai/contextual-menu", "ai/model-context-protocol", "ai/markdown-export", + "ai/ads", "guides/geo", "guides/claude-code", "guides/cursor", From ded7cc278791d4bf3d82ffb2792aa2faf5db32a4 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 11 Sep 2025 17:20:52 +0000 Subject: [PATCH 3/3] Update ai/ads.mdx --- ai/ads.mdx | 241 +++++++++++++++++++++++++++++++++++++++++++++-------- 1 file changed, 207 insertions(+), 34 deletions(-) diff --git a/ai/ads.mdx b/ai/ads.mdx index 508d7af96..afe9d0843 100644 --- a/ai/ads.mdx +++ b/ai/ads.mdx @@ -1,58 +1,231 @@ --- title: AI ads -description: Configure AI-powered advertising and promotional content +description: Automatically generate and optimize promotional content with AI-powered advertising --- # AI ads -Use AI ads to automatically generate and optimize promotional content for your documentation. This feature leverages artificial intelligence to create contextually relevant advertisements and promotional materials. +Use AI ads to automatically generate contextually relevant promotional content for your documentation. The AI analyzes your content and user behavior to create targeted advertisements that enhance engagement without disrupting the reading experience. -## Overview +## Getting started -AI ads analyze your documentation content and user behavior to generate targeted promotional content that enhances user engagement without disrupting the reading experience. +### Prerequisites + +- Active Mintlify account with AI features enabled +- Documentation site with at least 10 published pages +- Analytics tracking configured + +### Enable AI ads + +1. Open your Mintlify dashboard +2. Navigate to **Settings** → **AI Features** +3. Toggle **AI Ads** to enabled +4. Click **Save changes** + +```json +{ + "ai": { + "ads": { + "enabled": true, + "placement": ["sidebar", "footer"], + "frequency": "medium" + } + } +} +``` ## Configuration -To enable AI ads in your documentation: +### Basic setup -1. Navigate to your dashboard settings -2. Enable the AI ads feature -3. Configure your advertising preferences -4. Set targeting parameters +Configure AI ads in your `mint.json` file: -## Ad Types +```json +{ + "ai": { + "ads": { + "enabled": true, + "placement": ["sidebar", "inline", "footer"], + "frequency": "low", + "targeting": { + "contentBased": true, + "behaviorBased": true + } + } + } +} +``` -### Contextual ads -Automatically generated ads based on the current page content and user context. +### Placement options -### Product recommendations -AI-powered suggestions for related products or services based on user behavior. +| Placement | Description | Best for | +|-----------|-------------|----------| +| `sidebar` | Right sidebar of documentation pages | Non-intrusive promotion | +| `inline` | Between content sections | High engagement | +| `footer` | Bottom of each page | Subtle promotion | +| `banner` | Top of page header | Important announcements | -### Content promotion -Intelligent promotion of relevant documentation sections or resources. +### Frequency settings -## Customization +- `low` - Show ads on 20% of page views +- `medium` - Show ads on 50% of page views +- `high` - Show ads on 80% of page views -You can customize the appearance and behavior of AI ads: +## Ad types -- **Placement**: Choose where ads appear in your documentation -- **Frequency**: Control how often ads are displayed -- **Styling**: Match ads to your documentation theme -- **Targeting**: Define audience segments and targeting criteria +### Contextual ads -## Analytics +AI-generated ads based on the current page content and user reading patterns. + +```json +{ + "ai": { + "ads": { + "contextual": { + "enabled": true, + "relevanceThreshold": 0.8, + "maxAdsPerPage": 2 + } + } + } +} +``` -Track the performance of your AI ads with built-in analytics: +### Product recommendations -- Click-through rates -- Engagement metrics -- Conversion tracking -- A/B testing results +Smart suggestions for related products, features, or services. + +```json +{ + "ai": { + "ads": { + "recommendations": { + "enabled": true, + "categories": ["features", "integrations", "upgrades"], + "personalization": true + } + } + } +} +``` -## Best Practices +### Content promotion + +Promote relevant documentation sections or resources to improve discoverability. + +```json +{ + "ai": { + "ads": { + "contentPromotion": { + "enabled": true, + "promoteRelated": true, + "promotePopular": true + } + } + } +} +``` + +## Customization -- Keep ads relevant to your documentation content -- Monitor performance metrics regularly -- Test different ad placements and formats -- Ensure ads don't interfere with user experience -- Comply with advertising regulations and privacy policies \ No newline at end of file +### Styling + +Match ads to your documentation theme: + +```json +{ + "ai": { + "ads": { + "styling": { + "theme": "auto", + "borderRadius": "8px", + "shadow": "subtle", + "animation": "fade" + } + } + } +} +``` + +### Targeting + +Define audience segments and targeting criteria: + +```json +{ + "ai": { + "ads": { + "targeting": { + "userSegments": ["new_users", "power_users"], + "pageCategories": ["getting-started", "advanced"], + "excludePages": ["/internal/*"] + } + } + } +} +``` + +## Analytics and optimization + +### Performance metrics + +Track ad performance in your dashboard: + +- **Click-through rate (CTR)** - Percentage of users who click ads +- **Engagement rate** - Time spent viewing ad content +- **Conversion rate** - Users who complete desired actions +- **Revenue attribution** - Sales generated from ad clicks + +### A/B testing + +Test different ad configurations: + +```json +{ + "ai": { + "ads": { + "testing": { + "enabled": true, + "variants": [ + {"placement": "sidebar", "frequency": "low"}, + {"placement": "inline", "frequency": "medium"} + ], + "splitRatio": 0.5 + } + } + } +} +``` + +### Optimization tips + +- Monitor CTR weekly and adjust frequency if below 2% +- Test different placements for 2 weeks before deciding +- Use contextual ads for technical content, recommendations for feature pages +- Exclude ads from critical user flows like onboarding + +## Best practices + +### Content relevance +- Ensure ads match the page topic and user intent +- Use AI confidence scores to filter low-relevance ads +- Regularly review and update targeting criteria + +### User experience +- Limit to 2 ads per page maximum +- Use subtle animations and transitions +- Provide clear "dismiss" options for users +- Test on mobile devices regularly + +### Performance monitoring +- Set up alerts for CTR drops below 1.5% +- Review analytics monthly for optimization opportunities +- A/B test new placements quarterly +- Monitor page load times to ensure ads don't slow performance + +### Compliance +- Follow advertising disclosure requirements +- Respect user privacy preferences +- Comply with GDPR, CCPA, and other regulations +- Provide opt-out mechanisms for users \ No newline at end of file