MessageMatch MatchAgent Documentation

Introduction

MessageMatch lets you easily add AI-powered content to your website. With just a few clicks, you can create widgets that update your site's text dynamically for campaigns, personalization, and more—no coding required.

Quick Start

That's it! Your MatchAgent will automatically start replacing content on your website with AI-generated text tailored to your visitors.

Installation

Installing MessageMatch is simple - just add our script tag to your website. No complex setup or dependencies required.

Step 1: Get Your MatchAgent Script

1. Log into your MessageMatch dashboard
2. Navigate to the MatchAgents section
3. Click "Create MatchAgent" or select an existing MatchAgent
4. Click the "Copy Script" button

Step 2: Add Script to Your Website

Paste the copied script into your website's HTML. We recommend placing it just before the closing </body> tag:

<!-- Place this script before closing </body> tag -->
<script>
  window._evolveConfig = {
    widgetId: "your-widget-id",
    apiKey: "your-api-key"
  };
</script>
<script src="https://evolvecopy.webadmin-503.workers.dev/widget.main.js"></script>
</body>

Configuration

Configure your MatchAgent behavior by modifying the _evolveConfig object or through your dashboard settings.

Required Configuration

Optional Configuration

What is a "Rematch"?

A rematch (also called a "prediction" or "impression") is when our AI processes and enhances content on your website. Here's what happens:

Important: Each unique combination of content, user prompt, and URL parameters counts as one rematch. If the same content is processed multiple times with the same parameters, it uses the cached result and doesn't count as additional rematches.

Caching Logic Explained

To optimize costs and performance, we use intelligent caching:

Plan Limits & Billing

Each plan includes a monthly limit on rewrites (AI predictions). Here's how they work:

Best Practices for Optimizing Rematches

Follow these guidelines to maximize the value of your rematch allocation:

Basic Configuration

Learn how to create and configure your MatchAgent for optimal performance.

Creating Your MatchAgent

In your dashboard, you'll configure these essential settings:

Element Selector Types

Choose how the widget identifies content and conversion elements on your page:

<h1 class="content1">Original Headline</h1>
<p class="content2">Original description text</p>
<button class="conversion1">Sign Up</button>
<a href="#" class="conversion2">Learn More</a>

<h1 class="my-headline-class">Original Headline</h1>
<p class="my-description-class">Original description</p>
<button class="my-cta-button">Sign Up</button>

<h1 id="main-headline">Original Headline</h1>
<p id="main-description">Original description</p>
<button id="signup-button">Sign Up</button>

MatchAgent Installation

After creating your MatchAgent, use the "Copy Script" button to get your installation code:

Advanced Features

Explore advanced MatchAgent capabilities for sophisticated content personalization and analytics.

URL Parameter Configuration

Control which URL parameters the AI analyzes for content personalization:

Custom AI Prompts

Guide the AI's content generation with custom prompts and context:

Example prompts:
• "Always mention our 30-day money-back guarantee"
• "Focus on benefits for small businesses"
• "Use a conversational, friendly tone"
• "Include urgency and scarcity in CTAs"

Custom Element Selectors

Configure custom selectors for different platforms and use cases:

Analytics & Performance Tracking

Monitor your MatchAgent's performance with comprehensive analytics:

Webhook Integration

Receive real-time notifications when users interact with your content:

MatchAgent Management

Efficiently manage your MatchAgents with these dashboard features:

Styling Options

Customize the appearance and behavior of your MatchAgent during content loading.

Loading Effects

Custom CSS

You can style the loading states and widget elements with CSS:

/* Style elements during loading */
.widget-loading {
  opacity: 0.5;
  transition: opacity 0.3s ease;
}

/* Style content blocks */
.content1, .content2, .content3 {
  transition: all 0.3s ease;
}

/* Style conversion elements */
.conversion1, .conversion2 {
  cursor: pointer;
  transition: background-color 0.2s ease;
}

Event Handling

Listen for MatchAgent events and implement custom behavior in your application.

MatchAgent Events

Event Listeners

Add event listeners to respond to MatchAgent events:

// Listen for widget events
window.addEventListener('widget:loaded', (event) => {
  console.log('Widget loaded:', event.detail);
});

window.addEventListener('widget:content-updated', (event) => {
  console.log('Content updated:', event.detail);
  // Run custom analytics or other code
});

window.addEventListener('widget:interaction', (event) => {
  console.log('User interaction:', event.detail);
  // Handle custom conversion tracking
});

Conversion Tracking

Track user interactions and conversions to measure your MatchAgent's effectiveness.

Trackable Elements

Add tracking classes to elements you want to monitor:

<!-- Content tracking -->
<div class="content1">This content block will be tracked when clicked</div>
<p class="content2">This paragraph tracks engagement</p>

<!-- Conversion tracking -->
<button class="conversion1">Sign Up Now</button>
<a href="/pricing" class="conversion2">View Pricing</a>
<div class="conversion3">Special Offer Banner</div>

Analytics Dashboard

View detailed analytics in your dashboard:

• Total impressions and clicks
• Click-through rates (CTR)
• Conversion rates by element
• Campaign performance metrics
• Time-series analytics

Webhook Events

Configure webhooks to receive real-time interaction events at your endpoint.

Content Marketing

Use MessageMatch MatchAgents to personalize landing pages, blog CTAs, or newsletter signups based on campaign or user data. Easily A/B test headlines and offers.

E-commerce

Show dynamic product descriptions, personalized offers, or cart reminders using MatchAgent content blocks and URL parameters for each shopper.

Documentation Sites

Use widgets to highlight new features, show targeted onboarding tips, or personalize docs for logged-in users or teams.

Landing Pages

Instantly update hero text, CTAs, or testimonials for different campaigns, referral sources, or user segments using widgets and URL parameters.

FAQ: Common Questions