Labs

Labs

Review AI recommendations for campaign performance, findability, fine-tuning, and email outreach metrics.

What is Labs?

Labs is your SWAI campaign command center. It analyzes brand and campaign data and surfaces expert recommendations so you can improve SEO, rankings, visibility, reputation, AI instructions, and email outreach results.

You use it to:

• Check your Optimization Score and open related campaign recommendations
• Review SEO suggestions (hashtags, keywords, backlinks, SERP)
• Track keyword rankings across domains
• See how AI models represent your brand (Visibility)
• Connect review sources and generate friction insights
• Run website, brand book, social, and content ideas audits
• Fine-tune AI Agent and Apps content instructions
• Review engagement chats and like or dislike agent replies
• Inspect Email Outreach delivery stats in Back Office

Main screens

Note: Open Labs from the sidebar under Resources → Labs (/labs). It uses your brand session — there is no separate sign-up inside Labs.

Note: Labs is not the same as Settings → Beta Apps (open). Beta Apps are experimental app toggles; Labs is always available under Resources.

Before you start

Most Labs data is scoped to your active brand. Recommendations and pickers improve when campaigns, apps, brand website, and review URLs are already set up.

Checklist

1. Sign in for the correct brand
   Open the SWAI Dashboard and confirm the brand is selected.

2. Brand profile
   Keep brand website and details up to date — Rankings can suggest a domain from your brand website, and Findability uses brand context.

3. Campaigns and apps (for Performance)
   Have campaigns and apps with analyzable data. Empty lists show No Campaigns / No Apps.

4. Review profile URLs (for Reputation)
   Have Google, Trustpilot, Yelp, Facebook, G2, or Capterra review page URLs ready if you want friction insights.

5. Email Outreach campaigns (for Back Office)
   Have outreach campaigns and sequences if you want delivery stats.

Important warnings

Warning: If Labs looks empty or actions stay disabled, confirm you are signed in and a brand is selected. Many Labs APIs wait for brand_id before loading.

Warning: On Rankings, you must Save selection before Check rankings. The UI warns: Save your selection before checking rankings.

Warning: Editing Fine-tuning instructions changes how AI and apps generate content. The page warns that modifications directly affect output.

Tip: Auto Apply (Performance) and Auto tuning (Fine-tuning) are visible but disabled — they are not available yet and are not broken toggles.

Quick start

1. Open Resources → Labs.
2. On Performance, choose a campaign (All Campaigns or a named campaign) and an app (All Apps or a type).
3. Review Your Optimization Score and any AI Recommendation cards. Click View when a card links to an asset.
4. Open Findability → SEO and copy or edit suggested hashtags, keywords, gap keywords, backlinks, and SERP results.
5. Optionally open Rankings: add domains and keywords → Save selection → Check rankings.
6. Optionally open Reputation: Add source → Refresh reviews → Generate report.
7. Optionally open Audits, pick a type, run the report, then Open full report.
8. Open Fine-tuning to review AI Agent or Apps instructions, or use Engagement training to rate replies.
9. Open Back Office to select an Email Outreach campaign and sequence and review delivery stats.

Tip: Deep links work with query params, for example /labs?tab=Findability&sub=Rankings or /labs?tab=Fine-tuning. Legacy /reputation redirects to Findability → Reputation.

Performance

Path: Labs → Performance (default tab).

Page alert: Let's Get You Better Results! — Consider this your campaign command center. Our AI analyzes your data and surfaces expert recommendations so you can outperform the competition.

Filters

Optimization Score

Your Optimization Score is a real-time metric of campaign efficiency and performance. A higher score indicates better ROI — 100% means roughly 300%+ ROI (see the in-app tooltip).

Recommendations

• Cards are labeled AI Recommendation :
• Click View when a recommendation links to a related asset
• Empty peak state: Excellent work! / Your campaigns are performing at their peak.

Findability

Path: Labs → Findability (/labs?tab=Findability).

Findability is the discoverability toolkit. Sub-tabs:

Findability → SEO

Default Findability sub-tab.

Sections

Empty-ish labels include No hashtag found, No keyword found, No backlinks found.

Common actions

1. Click a chip to copy it — toast Success / Text copied!
2. On long SERP text, use Show More.
3. Open a competitor site with View.
4. Use the edit (fullscreen) control to open a modal → change text → Save / Cancel.

Edit modals include Edit suggested hashtags, Edit suggested keywords (comma-separated), Edit gap keywords (comma-separated), Edit suggested backlinks (one URL per line), Edit SERP results, and Edit all SERP cards (Add card / Remove card).

Findability → Rankings

Path: Findability → Rankings.

Target Domains

• Add up to 5 domains or URLs (Add domain).
• Optional brand Suggested domain when your brand website is set.
• Search selected domains; empty states: No domains added yet. / No domains match your search.
• Counter: Selected domains (n/5).

Select Keywords

• Choose up to 20 keywords from Suggested keywords or Add custom keyword → Add.
• Counter: Selected (n/20); empty: No keywords selected yet.

Check rankings

1. Click Save selection (shows Saving... while working).
2. Click Check rankings (Checking...).
3. Review the Domain Rankings table: Domain, Keyword, Rank, Ranking URL, Checked.
4. Unranked rows show Not ranked. Last checked may note (cached).

Warning: If the selection is dirty, save first — Save your selection before checking rankings.

Findability → Visibility

Path: Findability → Visibility.

• Per-model cards show a score such as rate/100 with AI Recommendation : copy.
• Duplicated Suggestions consolidates overlapping recommendations.
• Use Show More for long text.
• Refresh with the refresh control (Refresh Visibility).

Findability → Reputation

Path: Findability → Reputation (also reachable from legacy /reputation).

Intro: connect Google, Trustpilot, Yelp, Facebook, G2, and Capterra review pages so Labs can pull reviews and generate friction insights.

Review sources

1. Click Add source → choose platform and profile URL → Save source (Saving…).
2. Empty: No sources yet. Add a Google Maps, Trustpilot, Yelp, Facebook, G2, or Capterra reviews URL.
3. Toast on success: Review source added. Removing a source toasts Source removed.

Reviews and report

1. Click Refresh reviews (needs at least one source) → toast Reviews refreshed.
2. Filter Reviews by platform (All platforms or a specific platform).
3. Empty: No reviews yet. Add sources and click Refresh reviews.
4. Click Generate report → Friction insights (themes, frictions, suggested Fix: items).
5. Empty report: No report yet. Refresh reviews, then click Generate report. Peak: No major frictions identified.

Warning: Errors include Add at least one review source first and Fetch some reviews before generating a report.

Findability → Audits

Path: Findability → Audits.

Run an audit

1. Pick a type and fill the form.
2. Optionally enable Force a fresh scrape.
3. Click Run website audit, Run brand book, Run social audit, or Generate ideas report.
4. Status may show Starting…, Queued…, Running…, Completed, or Failed.
5. On success: toast Audit completed; use Open full report and optional Show result preview / Hide preview.
6. On failure: toast Audit failed.

Fine-tuning

Path: Labs → Fine-tuning (/labs?tab=Fine-tuning).

Sub-tabs (local UI; not in the URL):

AI Agents and Apps

1. Select an agent (Select Ai Agent / No Ai Agent) or app (Select App / No App).
2. Older app types may show Deprecated.
3. Expand the editor — titles such as You can edit the content here, You can edit the image generation here, or You can edit the video generation here.
4. Edit Content creation, Image generation, or Video generation text as offered → Save.
5. Auto tuning is shown but disabled.

Sections may be labeled AI Agent Instructions or Apps content instructions.

Warning: These are expert-backed, data-driven instructions from leading AI whisperers. Any modifications here will directly affect your content's output.

Engagement training

1. Pick an agent/conversation in the sidebar (Agent Name).
2. Review the chat.
3. Use Like response or Dislike response on replies.

Back Office

Path: Labs → Back Office (/labs?tab=Back-Office).

Currently focused on Email Outreach metrics.

1. Select a campaign.
2. Select an sequence (UI label).
3. Review stats: Total, Delivered, Opened, Clicked, Replied, Bounced, Complained.
4. Click a non-Total card to open Email Details → Done.
5. Loading / empty: Loading emails... / No emails available for this selection yet.

Related Help: Email Outreach.

Common warnings and troubleshooting

Labs won’t load or stays blank

Confirm you are signed in and a brand is selected. Wait for user info to finish loading (Labs shows a skeleton while fetching).

No campaigns or apps on Performance

Create or open campaigns and apps that Labs can analyze. Empty filters show No Campaigns / No Apps.

Auto Apply or Auto tuning does nothing

Those switches are disabled in the UI. They are not available yet.

Rankings won’t check

1. Add at least one domain and one keyword.
2. Click Save selection.
3. Then click Check rankings.

Reputation actions disabled

Brand context is required. Add at least one review source before Refresh reviews, and fetch reviews before Generate report.

Audit failed

Check the URL or username, try again, or enable Force a fresh scrape. Toast Audit failed means the run did not complete — retry or contact support with the audit type and input.

Fine-tuning changes don’t seem to apply

Confirm you clicked Save. Reopen the agent or app and verify the instruction text. Changes affect future generations, not past published assets automatically.

Back Office shows no emails

Select both a campaign and a sequence that have Email Outreach activity. Empty state: No emails available for this selection yet.

Missing brand context

If pickers, rankings suggestions, or reputation actions fail, close Labs and reopen from Resources → Labs after selecting the correct brand. Keep brand website set under Settings → Brand (or go to app.swai.ai/setting/brand) for better domain suggestions.

Glossary

Need more help?

If something still fails after the checklist above:

1. Confirm you opened Resources → Labs for the correct brand.
2. Note the tab (Performance / Findability / Fine-tuning / Back Office) and any exact toast message.
3. For Rankings, confirm you saved the selection before checking.
4. For Reputation or Audits, note the source URL or audit type you used.
5. Contact your SWAI admin or support with the brand name, Labs tab, and what you expected to happen.

Related Help: Getting Started (Brand), Campaign Builder, Email Outreach, File Library.