How to Set Up the AI Page Ready AEO Audit Widget

Before you start

You will need:

• An AI Page Ready agency account. If you do not have one, start a free trial.
• A page where you want the audit widget to appear, such as your homepage, an AEO service page, or a campaign landing page.
• Access to edit that page, or someone who can add the embed code for you.
• At least one email address for new-lead notifications.

The widget is installed with a short JavaScript embed code and works with website builders as well as custom-coded websites.

1. Create a campaign

Log in to AI Page Ready, open AI SEO Audit Widget, and select Create New Campaign.

Enter two details:

1. Campaign Name — Use an internal name you will recognize, such as Homepage AEO Audit. Visitors will not see it.
2. Leads Email Recipients — Enter each person who should receive new leads. After every address, type a comma or press Enter.

2. Match the widget to your brand

Use the Appearance section to control how the widget and reports look.

• Theme — Choose a dark or white background for the embedded form and web report.
• Language — Choose the language used for the form, web report, PDF, and report email.
• Button Color — Match your website's primary action color.
• Button Text Color — Choose a contrasting color that remains easy to read.

You can also remove AI Page Ready branding. When you finish setting up the campaign, use the Preview tab to check the form, web report, and PDF.

3. Choose the lead form fields

Use the Form Heading to make a clear promise about what visitors will receive. For example:

• Get your free AI search readiness report
• Is your business visible in ChatGPT and Gemini? Find out now.
• See what may be holding your website back in AI search.

The page URL is always shown and required because AI Page Ready needs it to run the audit. You can show or hide the following lead fields and make each one optional or required:

• Name — Identify the lead and personalize your follow-up.
• Email — Send the report and follow up by email.
• Phone — Call or message leads when that is part of your process.
• Company name — Identify the business associated with the audit.

For most lead-generation campaigns, ask for name and email. If leads should receive their report by email, make the email field required.

4. Configure the reports

The AI Search Readiness Audit is included in every campaign. It checks structured data, LLM-friendly formatting, accessibility, content quality, discoverability, and readability.

You can also enable AI Search Visibility for a campaign. This checks whether ChatGPT and Gemini recommend the lead's brand for relevant searches.

If you enable it:

1. Choose ChatGPT, Gemini, or both.
2. Choose the report tab visitors should see first.

Use AI Readiness Audit as the default when you want leads to first see what may be limiting their website's readiness. Use AI Search Visibility when you want them to first see whether their brand appears in relevant AI responses.

Add a branded PDF

AI Page Ready generates a PDF for every completed lead report. Visitors can open it from the web report, receive it in the report email when enabled, and you can download it from the campaign's Leads section.

Turn on Branded PDF Report to add your logo, agency name, website, contact details, cover title, and introductory message.

5. Choose how leads receive their report

Turn on Send an email to your leads with the report link if you want AI Page Ready to email completed reports automatically.

• Sender Name — The name leads see as the sender.
• Reply-To Email — The address that receives replies.
• Email Subject — Write your own subject or use the default in the campaign's language.
• Campaign Page URL — Enter the page where the widget is embedded so the email returns the lead to the report on your website. Leave it blank to use the standalone AI Page Ready report page.
• Send Report PDF — Attach a PDF copy to the email.

Customize the report email

Turn on Use a custom email body when you want the message to sound like your agency, explain the report, or guide the lead towards replying or booking a call.

In the custom email editor, you can:

• Write and format the message in Simple mode or edit the source in HTML mode.
• Use Add variable to insert the lead's name, report link, or your agency name.
• Use Add Report Link to insert a link to the completed report.
• Preview the email with sample information or reset the starting template.

Make sure a custom email includes the report link so the lead can open their results.

6. Track conversions with custom JavaScript

The Advanced Settings section lets you run JavaScript when the embedded form or completed report loads. This Scale plan feature helps agencies measure the widget as part of a marketing funnel.

• JavaScript (Form Page) — Runs after the audit form loads.
• JavaScript (Report Page) — Runs after the completed report loads inside the widget.

Your analytics or advertising tool should already be installed on your website. Paste JavaScript only, without opening or closing <script> tags.

If your website uses the Google tag (gtag.js), this example sends a form-view event:

if (typeof gtag === 'function') {
    gtag('event', 'apr_audit_form_view')
}

For the report page, use a different event name:

if (typeof gtag === 'function') {
    gtag('event', 'apr_audit_report_view')
}

This is a Google tag API example, not specifically a Google Tag Manager example. If you use Google Tag Manager, Meta Pixel, or another platform, add the event snippet recommended for that platform.

Some website builders isolate custom embeds inside another iframe. In that situation, tracking functions installed on the main website—such as gtag() or Meta Pixel's fbq()—may not be available inside the isolated embed.

7. Create the campaign and copy the code

Select Create. AI Page Ready opens the campaign page after saving it.

1. Open the Embedding Code tab.
2. Select the copy icon beside the code.
3. Paste the complete snippet into your website.

The code in your account already contains the correct campaign ID, so always copy it from your campaign rather than reusing the example shown here.

8. Add the widget to your website

Choose your platform below. In every case, paste the complete snippet on the page where the widget should appear.

9. Preview and test the widget

Open the campaign's Preview tab and check:

• Form Preview — Confirm the heading, fields, theme, language, and button colors.
• Report Preview — Confirm the web report and the tab shown first.
• PDF Preview — Confirm the logo, agency details, and cover content.

Then submit a test lead through the form on your published website:

1. Open the page in a private or incognito window.
2. Enter a page URL and complete the lead form using an email address you control.
3. Wait for the audit to finish and open the report.
4. Confirm that the lead reached every notification address.
5. Confirm that the lead received the report email, if enabled.
6. If you added tracking code, confirm that the events appeared in your analytics platform.
7. Repeat the test on a phone.

Your AEO audit widget is ready

Once the published test works, your widget is ready to receive traffic. Monitor new submissions in the campaign's Leads tab and adjust the campaign settings whenever you want to refine the experience.

Troubleshooting

The widget does not appear

• Confirm that you pasted the complete snippet and that its campaign ID is present.
• Make sure the editor did not remove the <script> tag.
• Test the published page; some builders do not run scripts inside the editor.
• Ask a developer to check the browser console for blocked-script or Content Security Policy errors.

The widget is cut off

The widget adjusts its own iframe height. If it is still cut off, the website builder is usually constraining the surrounding embed element or section.

• Set the embed element to fill the available width.
• Increase the surrounding element or section height, or remove a fixed height that clips its contents.
• Check desktop and mobile separately.
• In Wix, resize both the HTML embed element and its section.

Lead or report emails are missing

• Check Leads Email Recipients in the campaign Overview.
• Confirm that report emails are enabled and that the form collects an email address.
• Check spam or junk folders.
• Open the campaign's Leads tab to confirm that the submission was captured.

FAQs