# Coming Soon
Source: https://docs.hypd.ai/connectors/coming-soon

Integrations we're actively building

We're expanding HYPD's data sources. These integrations are in development:

## Google Analytics 4

Pull website and conversion data directly into your HYPD analysis.

## Meta Ads Library

Search competitors' live Facebook and Instagram ads to study their creative and messaging.

## Microsoft Ads (Bing)

Bring your Microsoft Advertising campaigns into HYPD alongside Google and Meta.

## LinkedIn Ads

Analyze your LinkedIn Ads campaigns and B2B performance without leaving HYPD.

***

## Get Notified

Want early access when these launch?

<Card title="Join the Waitlist" icon="bell" href="mailto:contact@hypd.ai?subject=Integration%20Waitlist">
  Email us and we'll notify you when new integrations go live.
</Card>


# Google Ads
Source: https://docs.hypd.ai/connectors/google-ads

Connect your Google Ads account to HYPD

## Before You Start

You'll need a Google account that has access to the Google Ads advertiser accounts you want to analyze.

<Warning>
  **Use an advertiser account, not an MCC.** When prompted, select the Google account with direct access to advertiser accounts—not your Manager (MCC) account.
</Warning>

## Connect Your Account

<Steps>
  <Step title="Go to Sources">
    From the HYPD sidebar, click **Sources**.
  </Step>

  <Step title="Click Connect">
    Find Google Ads and click **Connect**.
  </Step>

  <Step title="Choose Your Google Account">
    Select the Google account that has access to your advertiser accounts.
  </Step>

  <Step title="Authorize Access">
    Review HYPD's privacy policy and terms of service, then click **Continue** to grant access.
  </Step>
</Steps>

Once connected, your advertiser accounts will appear in the Chat dropdown.

## Permissions

HYPD requests read-only access to your Google Ads data. We can view your campaigns, keywords, ads, and performance metrics—but we cannot make any changes to your account.

| Permission | What HYPD Can Do |
| - | - |
| View campaigns | See campaign structure and settings |
| View performance | Access metrics like clicks, cost, conversions |
| View ads | Read ad copy, headlines, and descriptions |
| View keywords | See keywords and search terms |

<Info>
  You can revoke access anytime from your [Google Account permissions](https://myaccount.google.com/permissions).
</Info>

## Troubleshooting

<AccordionGroup>
  <Accordion title="I don't see my advertiser accounts">
    Make sure you selected the correct Google account—the one with direct access to advertiser accounts, not your MCC.
  </Accordion>

  <Accordion title="Account shows as CLOSED">
    Closed accounts appear in the dropdown but cannot be analyzed. Contact Google Ads support if you believe this is an error.
  </Accordion>

  <Accordion title="I want to connect a different Google account">
    Go to **Sources**, disconnect Google Ads, then reconnect with the correct account.
  </Accordion>
</AccordionGroup>

## Next Steps

<Card title="Start Chatting" icon="message" href="/getting-started/quickstart#start-chatting">
  Select an account and run your first analysis.
</Card>


# Google Merchant Center
Source: https://docs.hypd.ai/connectors/google-merchant-center

Connect your product feed to diagnose disapprovals, pricing, and Shopping performance

Google Merchant Center is where your product feed lives. Connect it so HYPD can see your catalog, spot the disapprovals that quietly pull products out of your ads, and compare your prices against the benchmark.

<Note>
  **Premium source.** Google Merchant Center is available on Trial, Starter, and Pro plans. It is not included in the Free plan.
</Note>

## Before You Start

You'll need a Google account with access to the Merchant Center account you want to analyze.

<Tip>
  **Connect Google Ads too.** Merchant Center and Google Ads work as a pair: a product disapproved in Merchant Center stops showing in your Shopping and Performance Max campaigns. With both connected, HYPD can trace a Shopping problem in Ads back to its root cause in the feed.
</Tip>

## Connect Your Account

<Steps>
  <Step title="Go to Sources">
    From the HYPD sidebar, click **Sources**.
  </Step>

  <Step title="Open Google Merchant Center">
    Find the **Google Merchant Center** card and click the **+** button.

    <img alt="Sources page with the Google Merchant Center card" />
  </Step>

  <Step title="Add a connection">
    In the **Manage Google Merchant Center connections** dialog, click **Connect another Google Account**.

    <img alt="Manage Google Merchant Center connections dialog" />
  </Step>

  <Step title="Choose Your Google Account">
    Select the Google account that has access to your Merchant Center account.

    <img alt="Google account selector" />
  </Step>

  <Step title="Authorize Access">
    Review HYPD's privacy policy and terms of service, then click **Allow** to grant access to your Merchant Center data.

    <img alt="Google authorization screen showing the Merchant Center scope" />

    <Note>
      Google's consent screen reads "Manage your product listings and accounts for Google Shopping" because that is the only Merchant Center scope Google offers. HYPD uses it **read-only** and never changes your feed. See Permissions below.
    </Note>
  </Step>
</Steps>

Once connected, your Merchant Center account appears as a source you can query in Chat.

## Permissions

HYPD requests **read-only** access to your Merchant Center data. We can see your catalog, product issues, and performance—but we cannot add, edit, or remove products, and we cannot change your feed.

| Permission | What HYPD Can Do |
| - | - |
| View products | Read your catalog: titles, attributes, price, and availability |
| View product status | See approval status and the reasons behind disapprovals |
| View account issues | Read account-level policy and suspension issues |
| View performance | Access clicks, impressions, and conversions by product |
| View price competitiveness | Compare your prices against the market benchmark |
| View data sources | See which feeds are connected to your account |

<Info>
  You can revoke access anytime from your [Google Account permissions](https://myaccount.google.com/permissions).
</Info>

## Troubleshooting

<AccordionGroup>
  <Accordion title="I don't see my Merchant Center account">
    Make sure you signed in with the Google account that has access to Merchant Center. If you have several, reconnect and pick the right one.
  </Accordion>

  <Accordion title="A product isn't showing in my ads">
    Ask HYPD to list your disapproved products. A disapproval in Merchant Center removes a product from Shopping and Performance Max until it's fixed.
  </Accordion>

  <Accordion title="I want to connect a different Google account">
    Go to **Sources**, disconnect Google Merchant Center, then reconnect with the correct account.
  </Accordion>
</AccordionGroup>

## Prompts

```
Which of my products are disapproved, and why?
```

```
Summarize my Merchant Center issues by type across the whole catalog.
```

```
Which products get impressions but zero clicks?
```

```
How does my pricing compare to the benchmark? Show the products where I'm most overpriced.
```

## Next Steps

<Card title="Google Shopping" icon="https://mintcdn.com/hypdai/vnQWXcxc5Vg4vwIs/images/platforms/googleshopping.svg?fit=max&auto=format&n=vnQWXcxc5Vg4vwIs&q=85&s=e72675ddf0a12f38a2197eaf7305c35e" href="/connectors/google-shopping">
  Research who wins Shopping placement and how your prices stack up against other sellers.
</Card>


# Google Shopping
Source: https://docs.hypd.ai/connectors/google-shopping

Research Shopping placements, prices, and competing sellers

Google Shopping shows you who wins product placement for any search term, at what price, and how your pricing compares to every other seller. It answers the questions your own account data can't: what your competitors are doing.

<Note>
  **Premium source.** Google Shopping is available on Trial, Starter, and Pro plans. It is not included in the Free plan.
</Note>

## Before You Start

There is no account to connect. Google Shopping is available in the app and through the MCP on any eligible plan.

<Note>
  **Connect Google Ads first.** HYPD takes the country and language for Shopping searches from your connected Google Ads account. Without one, HYPD asks you which market to search before it runs the query.
</Note>

## What You Can Research

### Top products for a keyword

The products winning Shopping placement for a search term, with title, rank, price, rating, and review count. Filter by price range, sort by review score or price.

### Sellers for a product

Take any product from those results and list every seller offering it, with price, shipping, special offers, and seller rating. This is the price-competitiveness check.

## Permissions

Google Shopping is public marketplace data from Google. It is not tied to your account, so there is nothing to authorize and nothing to revoke.

| Data | What HYPD Can Do |
| - | - |
| Products | Read titles, rank, price, rating, and review counts for a keyword |
| Sellers | Read prices, shipping, offers, and ratings for a product |

Access is **read-only**. HYPD cannot change your listings, your product feed, or your Google Ads account.

## Prompts

```
Who wins Google Shopping placement for "electric kettle"? Show the top 20 products with prices and ratings.
```

```
Top 20 Shopping products for "robot vacuum" in Germany, sorted by review score.
```

```
Show me all sellers for our top SKU, sorted by price. Is our price competitive?
```

```
Find Shopping products for "running shoes" between 50 and 120 EUR.
```

<Tip>
  Ask for a specific number of results. Google Shopping returns a large set by default, and "top 20" keeps the answer readable.
</Tip>

## Troubleshooting

<AccordionGroup>
  <Accordion title="HYPD asks me which country to search">
    No Google Ads account is connected or selected, so HYPD has no market to default to. Connect Google Ads, or name the country in your prompt.
  </Accordion>

  <Accordion title="I get far more products than I asked for">
    Google Shopping ignores small result counts and returns its full set. Say "top 20" in your prompt and HYPD caps it.
  </Accordion>

  <Accordion title="The prices don't match my Merchant Center feed">
    Shopping shows what is live on the public marketplace across all sellers. It is not a view of your feed. Use Google Merchant Center for your own product data.
  </Accordion>
</AccordionGroup>

## Next Steps

<Card title="Google Merchant Center" icon="https://mintcdn.com/hypdai/vnQWXcxc5Vg4vwIs/images/platforms/googlemerchantcenter.svg?fit=max&auto=format&n=vnQWXcxc5Vg4vwIs&q=85&s=143f6d702ef3a7b58a3952e24e7bc366" href="/connectors/google-merchant-center">
  Connect your own product feed to diagnose disapprovals and pricing.
</Card>


# Meta Ads
Source: https://docs.hypd.ai/connectors/meta

Connect your Meta (Facebook & Instagram) Ads account to HYPD

## Before You Start

You'll need a Facebook account with access—through [Meta Business Manager](https://business.facebook.com/)—to the Meta ad accounts you want to analyze.

<Note>
  Meta connects with **Facebook Login for Business**. During sign-in, select **every** ad account and Page you want HYPD to read—assets you skip won't be available in Chat.
</Note>

## Connect Your Account

<Steps>
  <Step title="Go to Sources">
    From the HYPD sidebar, click **Sources**.
  </Step>

  <Step title="Click Connect">
    Find **Meta** and click **Connect**.
  </Step>

  <Step title="Log in with Facebook">
    Sign in with Facebook and choose the business, ad accounts, and Pages you want HYPD to access.
  </Step>

  <Step title="Authorize Access">
    Review HYPD's privacy policy and terms of service, then click **Continue** to grant read-only access.
  </Step>
</Steps>

## Permissions

HYPD requests **read-only** access to your Meta Ads data. We can view your campaigns, creative, and performance—but we cannot create, edit, or pause anything in your account.

| Permission | What HYPD Can Do |
| - | - |
| View campaigns | See campaign, ad set, and ad structure and settings |
| View performance | Access metrics like spend, ROAS, CTR, CPM, and conversions |
| View ads & creative | Read ad copy, headlines, images/video, and calls-to-action |
| View Pages | See the Facebook Pages linked to your ad account |
| View catalog | See your product catalog and product-level performance |
| View leads | Read submissions from your Facebook lead forms |

You can revoke access anytime from **Facebook → Settings → Business Integrations**.

## Troubleshooting

<AccordionGroup>
  <Accordion title="I don't see my ad accounts">
    Reconnect Meta and make sure you select the business and **all** the ad accounts you want during the Facebook login step.
  </Accordion>

  <Accordion title="I don't see my leads or lead forms">
    Lead retrieval also needs Page-level **Lead Access**. In Meta Business Settings, grant Lead Access for the Page to your user, then reconnect.
  </Accordion>

  <Accordion title="I want to connect a different Facebook account">
    Remove HYPD under **Facebook → Settings → Business Integrations**, then connect again from Sources.
  </Accordion>
</AccordionGroup>

## Next Steps

<Card title="Connect HYPD MCP to ChatGPT" icon="plug" href="/guides/chatgpt-connector">
  Use the HYPD connector in other AI tools.
</Card>


# How HYPD Works
Source: https://docs.hypd.ai/getting-started/how-hypd-works

Understand what HYPD can access, how it analyzes your data, and tips for getting the best results

## The Basics

HYPD connects to your ad accounts and lets you ask questions in plain English. Behind the scenes, it fetches your data, analyzes it, and returns insights as text, tables, or charts.

<Info>
  **HYPD is read-only.** It can see your campaigns and performance data but cannot make changes to your account.
</Info>

## One Chat = One Account

Each chat session is tied to a single advertiser account. You select it from the dropdown before chatting.

To analyze a different account, start a new chat and select the other account.

## What Data Can HYPD Access?

<Columns>
  <Card title="Campaign Structure" icon="sitemap">
    Campaigns, ad groups, keywords, ads, and search terms.
  </Card>

  <Card title="Performance Metrics" icon="chart-simple">
    Impressions, clicks, cost, conversions, revenue, and more.
  </Card>
</Columns>

### Available Metrics

When you ask about performance, HYPD can pull these metrics:

| Metric | What It Measures |
| - | - |
| Impressions | How often your ads were shown |
| Clicks | How often people clicked |
| CTR | Click-through rate (clicks ÷ impressions) |
| Cost / Spend | How much you spent |
| CPC | Cost per click |
| Conversions | Completed actions (purchases, leads, etc.) |
| Cost per Conversion | How much each conversion cost |
| Conversion Rate | Conversions ÷ clicks |
| Revenue | Conversion value |
| ROAS | Return on ad spend (revenue ÷ cost) |

## How Responses Work

HYPD can respond with:

* **Text summaries** — Quick answers and insights
* **Tables** — Side-by-side comparisons of campaigns, keywords, or time periods
* **Charts** — Line charts for trends, bar charts for comparisons

Just ask for what you need: *"Add a graph"* or *"Show me a table"*.

## Tips for Better Questions

<AccordionGroup>
  <Accordion title="Be specific about timeframes">
    Instead of *"How are my campaigns doing?"* try:

    ```
        How did my campaigns perform last week?
    ```

    ```
        Compare September vs August performance.
    ```
  </Accordion>

  <Accordion title="Mention what metrics matter to you">
    HYPD will show standard KPIs by default, but you can focus on what matters:

    ```
        What's my ROAS by campaign for the last 30 days?
    ```

    ```
        Which keywords have the highest cost per conversion?
    ```
  </Accordion>

  <Accordion title="Ask follow-up questions">
    Your data stays loaded during the conversation. Dig deeper:

    ```
        Why did conversions drop on the 15th?
    ```

    ```
        Break that down by ad group.
    ```
  </Accordion>

  <Accordion title="Request specific outputs">
    Ask for the format you want:

    ```
        Show me a table of top 10 keywords by spend.
    ```

    ```
        Add a line chart showing daily spend vs revenue.
    ```
  </Accordion>
</AccordionGroup>

## What HYPD Cannot Do (Yet)

* Make changes to your campaigns (bids, budgets, pausing ads)
* Access Google Analytics or Merchant Center data
* Pull competitor or auction insights

<Note>
  Direct campaign changes ("agent mode") and Google Analytics integration are on our roadmap.
</Note>


# Introduction
Source: https://docs.hypd.ai/getting-started/introduction

The AI Co-Pilot for Performance Marketers

## Getting Started

Connect your ad accounts and start analyzing performance in minutes.

<Card title="Quickstart Guide" icon="rocket" href="/getting-started/quickstart">
  Connect your Google or Meta Ads account and run your first analysis.
</Card>

## What Can HYPD Do?

Stop digging through dashboards—just ask questions and get instant insights.

<Columns>
  <Card title="Connect Your Accounts" icon="plug" href="/connectors/google-ads">
    Link your Google Ads and Meta Ads accounts securely.
  </Card>

  <Card title="Analyze Performance" icon="chart-line" href="/prompts/analysis-insights">
    Ask why metrics changed and get data-backed answers in seconds.
  </Card>

  <Card title="Find Wasted Spend" icon="magnifying-glass-dollar" href="/prompts/audits-optimization">
    Identify irrelevant search terms and budget leaks automatically.
  </Card>

  <Card title="Generate Reports" icon="file-chart-column" href="/prompts/reporting-visualization">
    Get instant summaries with tables, graphs, and insights.
  </Card>
</Columns>

## Explore Prompts

See what you can ask HYPD to do for your ad accounts.

<Columns>
  <Card title="Reporting & Visualization" icon="chart-pie" href="/prompts/reporting-visualization">
    Weekly summaries, performance graphs, KPI dashboards.
  </Card>

  <Card title="Strategic Planning" icon="route" href="/prompts/strategic-planning">
    ROAS roadmaps, optimization recommendations, growth strategies.
  </Card>

  <Card title="Content & Keywords" icon="pen-ruler" href="/prompts/content-generation-keywords">
    Generate ad copy, headlines, and keyword ideas from your data.
  </Card>

  <Card title="A/B Testing Analysis" icon="code-compare" href="/prompts/ab-testing-change-analysis">
    Measure the impact of recent changes on performance.
  </Card>
</Columns>

## Have Questions?

<Card title="FAQ" icon="circle-question" href="/faq">
  Common questions about data security, pricing, and features.
</Card>


# Quickstart
Source: https://docs.hypd.ai/getting-started/quickstart

Connect your ad account and run your first analysis in under 5 minutes

## Create Your Account

<Steps>
  <Step title="Sign Up">
    Go to [app.hypd.ai](https://app.hypd.ai) and click **Sign in with Google** or **Continue with email**

    You can use any Google/Email account—it doesn't need to be the same one with Google Ads access.

    <Frame>
      <img alt="Sign in screen" />
    </Frame>
  </Step>

  <Step title="Connect Google Ads">
    From the sidebar, click **Sources**, then click **Connect** next to Google Ads.

    <Frame>
      <img alt="Connect Ad Accounts" />
    </Frame>

    Review and approve HYPD's privacy policy and terms of service, then authorize Google Ads access.

    <img alt="Google Account Setup" />
  </Step>

  <Step title="Select and enable the Right Account">
    <Warning>
      **Important:** Select the account that has direct access to advertiser accounts—**not** your MCC (Manager) account.
    </Warning>

    <Frame>
      <img alt="Select Ad Accounts" />
    </Frame>
  </Step>
</Steps>

## Start Chatting

<Steps>
  <Step title="Open Chat">
    Click **New** **Chat** in the sidebar.

    <Frame>
      <img alt="Select Ad Accounts" />
    </Frame>
  </Step>

  <Step title="Select an Advertiser Account (in case you enabled multiple)">
    Choose the advertiser account you want to analyze from the dropdown.

    <Frame>
      <img alt="Select Ad Accounts" />
    </Frame>
  </Step>

  <Step title="Ask Your First Question">
    Try one of these to get started:

    ```
        How was last week's performance? Add a graph.
    ```

    ```
        Where is budget being wasted?
    ```

    ```
        What are your recommendations based on last month's performance?
    ```

    <Frame>
      <img alt="Chat with HYPD" />
    </Frame>
  </Step>
</Steps>

## Next Steps

<Columns>
  <Card title="Connect Google Ads" icon="google" href="/connectors/google-ads">
    Add your Google Ad accounts.
  </Card>

  <Card title="Explore Prompts" icon="lightbulb" href="/prompts/overview">
    See the full range of questions you can ask HYPD.
  </Card>
</Columns>


# Connect the HYPD App to ChatGPT
Source: https://docs.hypd.ai/guides/chatgpt-connector

Add the HYPD AI Ads app to ChatGPT and connect your Google Ads & Merchant Center accounts, no MCP URL required.

Add the **HYPD AI Ads** app to ChatGPT to analyze your Google Ads and Google Merchant Center accounts in plain language, right inside any chat. It's the fastest way to get started, no MCP URL or developer mode required.

<Note>
  Prefer to set HYPD up as a manual custom connector instead? See [Connect Custom HYPD MCP to ChatGPT](/guides/chatgpt-connector).
</Note>

## Setup

<Steps>
  <Step title="Open the HYPD AI Ads app in ChatGPT">
    Open the app directly: [**HYPD AI Ads on ChatGPT**](https://chatgpt.com/plugins/plugin_asdk_app_6a3170ea7fc88191be6c0b9ff250a4b4?q=HYPD+AI+Ads).

    Or find it yourself: in ChatGPT, open the **Plugins** (Apps) directory, search **HYPD AI**, and open **HYPD AI Ads**.

    Then click **Sign in with HYPD AI Ads**.

    <Frame>
      <img alt="4 Chatgpt Authorize" />
    </Frame>
  </Step>

  <Step title="Create your HYPD account">
    Sign up for HYPD with Google or your email. If you already have an account, switch to **Sign In**.

    <Frame>
      <img alt="Img V3 0214a 7636df68 D9d6 4498 81af 2071c428bbag" />
    </Frame>
  </Step>

  <Step title="Connect your data sources">
    On the **Connect your data sources** screen, click **+** on **Google Ads**, **Google Merchant Center**, or both, then sign in with Google to connect. You can add more accounts later in HYPD.

    <Frame>
      <img alt="Img V3 0214a 2cb9470f Cc31 414e B0fb 1bc51b468b0g" />
    </Frame>
  </Step>

  <Step title="Grant access on Google">
    On the **"HYPD\_AI wants access to your Google Account"** screen, **tick the checkbox** next to the Google Ads permission before clicking **Continue**. Google shows it unchecked by default, if you skip it the connection silently fails.

    <Frame>
      <img alt="Img V3 0214a Ec4468bb 4480 42a3 89d9 Aff1dbd933ag" />
    </Frame>

    <Note>
      Google's wording says "see, edit, create and delete" that's the only permission scope Google offers for Ads accounts. **HYPD only ever reads your data.** It never edits, creates, or deletes anything.
    </Note>
  </Step>

  <Step title="Confirm your account is connected">
    You'll see a **Google account connected** confirmation and your account listed as **Active**. Use **Manage accounts** any time to toggle which accounts HYPD can see.

    <Frame>
      <img alt="Img V3 0214a 6b8aeeab Bc12 46d3 A46a 86d9e649511g" />
    </Frame>
  </Step>

  <Step title="Authorize ChatGPT">
    Click **Authorize** to send access back to ChatGPT and finish linking your accounts.

    <Frame>
      <img alt="Img V3 0214a Ad46d0f9 8d37 4a3d B76d A077541c47cg" />
    </Frame>
  </Step>

  <Step title="Start using HYPD in ChatGPT">
    You're returned to ChatGPT automatically. In the message box, click the **+**, choose **HYPD AI Ads**, and start asking about your accounts.

    <Frame>
      <img alt="Img V3 0214a 73d2bcf9 E062 49a1 9de6 08a41cad10ag" />
    </Frame>
  </Step>
</Steps>

## What you can do next

With **HYPD AI Ads** selected, try prompts like:

```text theme={null}
How was last week's Google Ads performance?
```

```text theme={null}
Where is budget being wasted across my accounts?
```

```text theme={null}
Find new keyword opportunities for my top campaign.
```

<Note>
  HYPD's read-only tools (account overviews, GAQL queries, keyword research) run automatically. Write actions require your approval inside ChatGPT before they execute.
</Note>


# Connect Custom HYPD MCP to ChatGPT
Source: https://docs.hypd.ai/guides/chatgpt-custom-connector

Bring HYPD's tools — audits, reports, campaign analysis — into ChatGPT

Connect HYPD as a custom connector inside ChatGPT. Once authorized, you can pull your ad accounts into any chat by adding **@hypd** to your prompts.

<Note>
  Before you start, make sure you've signed up at [app.hypd.ai](https://app.hypd.ai) and connected at least one ad account on the **Sources** page. See the [Quickstart](/getting-started/quickstart) if you haven't yet.
</Note>

<Tip>
  Prefer to watch? Here's a [1-minute video walkthrough](https://screen.studio/share/HeBrh7pq) of the whole flow.
</Tip>

## Setup

<Steps>
  <Step title="Copy your HYPD MCP URL">
    In HYPD, open the [**MCP Connector** page](https://app.hypd.ai/mcp-connector) and copy your MCP URL.

    You can also reach it from inside the app: click your avatar in the bottom-left corner, then **MCP Connector**.

    <Frame>
      <img alt="HYPD MCP Connector page" />
    </Frame>

    Your MCP endpoint:

    ```text theme={null}
    https://mcp.hypd.ai/mcp
    ```
  </Step>

  <Step title="Open ChatGPT Plugins">
    Open [chatgpt.com](https://www.chatgpt.com) in your browser and go to **Plugins**

    <Frame>
      <img alt="2026 07 16 14 23 55" />
    </Frame>
  </Step>

  <Step title="Click on &#x22;+&#x22; and add a new plugin">
    On the Plugin\*\* \*\*page, click \*\*"+" \*\*at the top. Enter the name **HYPD** and paste the MCP Server URL from Step 1 and check the box to accept the warning:

    ```text theme={null}
    https://mcp.hypd.ai/mcp
    ```

    <Frame>
      <img alt="2026 07 16 14 25 39" />
    </Frame>
  </Step>

  <Step title="Create and connect with HYPD">
    Click **Create**, then sign in with your hypd.ai account to authorize the connection.

    <Frame>
      <img alt="Sign in with HYPD AI dialog in ChatGPT" />
    </Frame>
  </Step>

  <Step title="Start using HYPD">
    You're done. Add **@hypd** to any prompt to bring your connected ad accounts into the conversation.

    <Frame>
      <img alt="ChatGPT conversation using the HYPD connector" />
    </Frame>
  </Step>
</Steps>

## What you can do next

Add **@hypd** to your prompts, then try things like:

```text theme={null}
@hypd How was last week's Google Ads performance?
```

```text theme={null}
@hypd Where is budget being wasted across my accounts?
```

```text theme={null}
@hypd Find new keyword opportunities for my top campaign.
```

<Note>
  HYPD's read-only tools (account overviews, GAQL queries, keyword research) run automatically. Write actions require your approval inside ChatGPT before they execute.
</Note>


# Install the HYPD plugin for Claude Code & Cowork
Source: https://docs.hypd.ai/guides/claude-code-plugin

Bring HYPD's tools into Claude Code and Cowork — no URL to copy, no connector to configure by hand

The HYPD plugin bundles our MCP server into a single install. Unlike the [custom connector setup](/guides/mcp-connector), there is nothing to configure by hand.

<Note>
  Before you start, make sure you've signed up at [app.hypd.ai](https://app.hypd.ai) and connected at least one ad account on the **Sources** page. See the [Quickstart](/getting-started/quickstart) if you haven't yet.
</Note>

## Install

The steps differ by surface — pick yours.

<Tabs>
  <Tab title="Claude Code (terminal)">
    ```
    /plugin marketplace add HYPD-AI/ads-mcp-plugin
    /plugin install hypd-ai-ads@hypd-ai
    /reload-plugins
    ```

    Then authorize: run `/mcp`, select **hypd**, choose **Authenticate**, and approve in the browser. The token is stored in your OS keychain and refreshes on its own.

    <Tip>
      From a normal terminal you can skip the panel: `claude mcp login 'plugin:hypd-ai-ads:hypd'`. This needs a real interactive terminal.
    </Tip>

    A terminal install also covers the desktop app's **Code** tab — but not Cowork, which has its own path (next tab).
  </Tab>

  <Tab title="Desktop app & Cowork">
    In the desktop app, open Settings → **Customize** → **Plugins** (in Cowork, **Customize** is in the left sidebar; in the Code tab you can also use the **+** button next to the prompt box → **Plugins**).

    <Steps>
      <Step title="Add the HYPD marketplace">
        Click **Add** → **Add marketplace** → **Add from a repository**, enter `HYPD-AI/ads-mcp-plugin`, and click **Sync**.

        <Frame>
          <img alt="Plugins screen with the Add menu open" />
        </Frame>

        <Frame>
          <img alt="Add marketplace dialog with the HYPD repository entered" />
        </Frame>

        Leave **Sync automatically** on to receive updates. If a banner about GitHub repository access appears, it only affects auto-sync — you can dismiss it and install normally.
      </Step>

      <Step title="Install the plugin">
        Find **HYPD AI - Paid Ads & Analytics** under the **Personal** tab and click **+**.

        <Frame>
          <img alt="Confirmation that the plugin is installed" />
        </Frame>
      </Step>

      <Step title="Connect">
        Open the plugin's page (gear icon) and connect the **HYPD AI Ads** connector. If your HYPD connector is already authorized on claude.ai, it's reused automatically.

        <Frame>
          <img alt="Plugin detail page showing the HYPD AI Ads connector" />
        </Frame>
      </Step>
    </Steps>
  </Tab>

  <Tab title="Zip upload">
    No marketplace needed: download [`hypd-ai-ads.zip`](https://github.com/HYPD-AI/ads-mcp-plugin/releases/latest/download/hypd-ai-ads.zip), then in the desktop app choose **Add** → **Upload plugin**. Or load it for a single terminal session:

    ```
    claude --plugin-dir ./hypd-ai-ads.zip
    ```

    Uploaded copies don't update automatically — prefer the marketplace install.
  </Tab>
</Tabs>

## Try it

Ask Claude something that needs your account data:

```text theme={null}
List my Google Ads accounts.
```

```text theme={null}
Audit my account and tell me where budget is being wasted.
```

```text theme={null}
How are my Meta ads performing, and which creatives are fatiguing?
```

```text theme={null}
Compare attribution between Google Analytics and Google Ads.
```

<Note>
  HYPD is **read-only**. It reports on your accounts and never changes your campaigns, budgets or ads.
</Note>

## Plugin or custom connector?

Both reach the same HYPD MCP server. Pick whichever matches where you work.

| | Plugin | [Custom connector](/guides/mcp-connector) |
| - | - | - |
| Where | Claude Code, Cowork | Claude apps (web, desktop, mobile) |
| Setup | Two commands or a few clicks | Paste the MCP URL |
| Updates | Automatic (marketplace installs) | Automatic |

## Troubleshooting

<AccordionGroup>
  <Accordion title="The plugin doesn't appear after installing">
    In the terminal, run `/reload-plugins` or restart Claude Code, then check the `/plugin` **Errors** tab. In the desktop app, check Settings → Customize → Plugins.
  </Accordion>

  <Accordion title="Tools aren't available / HYPD says it isn't connected">
    Terminal: run `/mcp` and authenticate (or **Re-authenticate** if the token expired). Desktop/Cowork: open the plugin's page and connect the **HYPD AI Ads** connector.
  </Accordion>

  <Accordion title="Authentication fails with 'stdin isn't a terminal'">
    `claude mcp login` needs a real interactive terminal. Use `/mcp` inside a session instead, or run it from a standard terminal window.
  </Accordion>

  <Accordion title="No ad accounts show up">
    Connect a source first: open the [Sources page](https://app.hypd.ai/sources) and connect Google Ads, Meta, Google Analytics or Merchant Center.
  </Accordion>

  <Accordion title="`/plugin` isn't recognised">
    In the terminal, update Claude Code (`npm install -g @anthropic-ai/claude-code@latest`) and restart. In the desktop app and Cowork, `/plugin` doesn't exist — use Settings → Customize → Plugins.
  </Accordion>
</AccordionGroup>

## Privacy

The plugin registers no lifecycle hooks and ships no telemetry. The only network destination is HYPD's own API at `mcp.hypd.ai`, reached through the MCP connection you authorize. See our [Privacy Policy](https://www.hypd.ai/privacy) and [Security & Privacy](/resources/security-privacy) page.


# Connect the HYPD App to Claude
Source: https://docs.hypd.ai/guides/claude-connector

Add the HYPD AI Ads connector to Claude and connect your Google Ads, Merchant Center, GA4 & Meta accounts, no MCP URL required.

Add the **HYPD AI Ads** connector to Claude to analyze your Google Ads, Merchant Center, Google Analytics 4, and Meta accounts in plain language, right inside any chat. It's the fastest way to get started, no MCP URL required.

<Note>
  Prefer to set HYPD up as a manual custom connector instead? See [Connect Custom HYPD MCP to Claude](/guides/mcp-connector).
</Note>

## Setup

<Steps>
  <Step title="Add the HYPD AI Ads connector">
    Open the connector directly: [**HYPD AI Ads on Claude**](https://claude.ai/directory/connectors/hypd-ai-ads).

    Or find it yourself: in Claude, open the connector **Directory**, search **HYPD AI Ads**, and click the **+** to add it.

    Then follow the prompt to sign in with HYPD.

    <Frame>
      <img alt="1 Claude Add Connector" />
    </Frame>
  </Step>

  <Step title="Create your HYPD account">
    Sign up for HYPD with Google or your email. If you already have an account, switch to **Sign In**.

    <Frame>
      <img alt="Img V3 0214c 3af3e631 B3c9 4b0c A27c 649a089bbfbg" />
    </Frame>
  </Step>

  <Step title="Connect your data sources">
    On the **Connect your data sources** screen, click **+** on **Google Ads**, **Google Merchant Center**, **Google Analytics 4**, or **Meta Ads**, then sign in to connect. You can add more accounts later in HYPD.

    <Frame>
      <img alt="Img V3 0214c Efe5a4d3 631a 49c5 Ad22 A126f4cb58cg 1" />
    </Frame>
  </Step>

  <Step title="Grant access on Google">
    On the **"HYPD\_AI wants access to your Google Account"** screen, **tick the checkbox** next to the Google Ads permission before clicking **Continue**. Google shows it unchecked by default, if you skip it the connection silently fails.

    <Frame>
      <img alt="Img V3 0214c 5f79b83d 7b96 42ad B417 70eebb339fdg" />
    </Frame>

    <Note>
      Google's wording says "see, edit, create and delete" that's the only permission scope Google offers for Ads accounts. **HYPD only ever reads your data.** It never edits, creates, or deletes anything.
    </Note>
  </Step>

  <Step title="Confirm your account is connected">
    You'll see a **Google account connected** confirmation and your account listed as **Active**. Use **Manage accounts** any time to toggle which accounts HYPD can see.

    <Frame>
      <img alt="5 Account Connected" />
    </Frame>
  </Step>

  <Step title="Authorize Claude">
    Click **Authorize** to send access back to Claude and finish linking your accounts.

    <Frame>
      <img alt="Img V3 0214c Ca634803 03ae 4ef9 8261 3f564548ad8g" />
    </Frame>
  </Step>

  <Step title="Start using HYPD in Claude">
    You're returned to Claude automatically. In the message box, click the **+**, open **Connectors**, and toggle on **HYPD AI Ads**. Now you can ask about your accounts right in the chat.

    <Frame>
      <img alt="Img V3 0214c 360e3839 6d4f 4b38 9364 9e2439d9f2bg" />
    </Frame>
  </Step>
</Steps>

## What you can do next

With **HYPD AI Ads** enabled, try prompts like:

```text theme={null}
How was last week's Google Ads performance?
```

```text theme={null}
Where is budget being wasted across my accounts?
```

```text theme={null}
Find new keyword opportunities for my top campaign.
```

<Note>
  HYPD's read-only tools (account overviews, GAQL queries, keyword research) run automatically. Write actions require your approval inside Claude before they execute.
</Note>


# Connect Custom HYPD MCP to Claude
Source: https://docs.hypd.ai/guides/claude-custom-connector

Bring HYPD's tools — audits, reports, campaign analysis — into Claude in about a minute

Connect HYPD as a custom MCP connector inside Claude. Once authorized, Claude can use HYPD's tools directly — your connected ad accounts come along automatically.

<Tip>
  Using **Claude Code** or **Cowork**? Install the [HYPD plugin](/guides/claude-code-plugin) instead — two commands, and it bundles our prompt shortcuts and marketing skills alongside the tools.
</Tip>

<Note>
  Before you start, make sure you've signed up at [app.hypd.ai](https://app.hypd.ai) and connected at least one ad account on the **Sources** page. See the [Quickstart](/getting-started/quickstart) if you haven't yet.
</Note>

## Setup

<Steps>
  <Step title="Copy your HYPD MCP URL">
    In HYPD, open the [**MCP Connector** page](https://app.hypd.ai/mcp-connector) and copy your MCP URL.

    You can also reach it from inside the app: click your avatar in the bottom-left corner, then **MCP Connector**.

    <Frame>
      <img alt="HYPD MCP Connector page" />
    </Frame>

    Your MCP endpoint:

    ```text theme={null}
    https://mcp.hypd.ai/mcp
    ```
  </Step>

  <Step title="Add HYPD as a custom connector in Claude">
    Open [claude.ai/customize/connectors](https://claude.ai/customize/connectors) and click **Add custom connector**.

    Paste the URL from the previous step, give it a name (e.g. `HYPD AI`), then click **Add**.

    <Frame>
      <img alt="Add custom connector dialog in Claude" />
    </Frame>
  </Step>

  <Step title="Authorize HYPD">
    Claude will hand off to HYPD to confirm the connection. Click **Connect** to authorize.

    <Frame>
      <img alt="Pre-auth screen showing Connect button" />
    </Frame>
  </Step>

  <Step title="Confirm the tools are available">
    Once authorized, Claude will show HYPD's tools in the connector settings. You're done — Claude can now call HYPD on your behalf.

    <Frame>
      <img alt="Post-auth showing HYPD tools list" />
    </Frame>
  </Step>
</Steps>

## What you can do next

Try asking Claude things like:

```text theme={null}
How was last week's Google Ads performance?
```

```text theme={null}
Where is budget being wasted across my accounts?
```

```text theme={null}
Find new keyword opportunities for my top campaign.
```

<Note>
  HYPD's read-only tools (account overviews, GAQL queries, keyword research) run automatically. Write actions like `google_ads_setup_client` require your approval inside Claude before they execute.
</Note>


# Connection Troubleshooting
Source: https://docs.hypd.ai/guides/connect-via-mcp/troubleshooting



## HYPD won't connect after Google sign-in

**Cause:** the permission checkbox on Google's consent screen wasn't ticked. Google shows it unchecked by default, if you click **Continue** without ticking it, the connection silently fails.

**Fix:** sign in again, and on the "HYPD\_AI wants access to your Google Account" screen, **tick the checkbox** next to the Google Ads permission before clicking **Continue**.

<Frame>
  <img alt="Image" />
</Frame>

<Note>
  Google's wording says "see, edit, create and delete" that's the only permission scope Google offers for Ads accounts. **HYPD only ever reads your data.** It never edits, creates, or deletes anything.
</Note>

## A connected account isn't showing up

**Cause:** HYPD lets you control which accounts are visible to its tools. If an account is toggled off under **Manage Google Ads accounts**, it stays connected but is hidden from HYPD.

**Fix:** go to **Clients → Manage Google Ads accounts** and toggle the account **on**. The same place works in reverse, toggle off any account you don't want HYPD to see.

<Frame>
  <img alt="Image" />
</Frame>

<Note>
  Deselected accounts stay connected. Nothing is disconnected or lost. They're just hidden from HYPD's tools. Clients in HYPD are unaffected.
</Note>


# Changelog
Source: https://docs.hypd.ai/guides/resources/changelog

Product Updates and announcements

<Update label="June 2026">
  * **New: Landing Page Audit** — ask HYPD to audit any landing page: performance, tracking, Quality Score issues, scored against a pro PPC checklist
  * **New: Tutorials Hub** — video and article tutorials in the app, filterable by category
  * **Research Tools** (keyword discovery, search volume, traffic forecasts) now available to all users
  * **App Redesign** around MCP: new Home with guided setup, cleaner navigation, refreshed Connectors page for Claude, ChatGPT and Codex
</Update>

<Update label="April 2026">
  **New: Web Access is here!**

  HYPD can now browse the web, fetch landing pages, and pull live data into your workflow. This unlocks a few powerful use cases:

  * Keyword research from any URL or product page
  * Ad copy generation based on actual landing page content
  * Competitor analysis — find brand names, positioning, and gaps
  * Landing page comparison with your existing ad copy
  * Business context — let HYPD understand a product before you start
</Update>

<Update label="January 2026">
  * Added pre-prompts for various usecases (in Beta)
  * Enabled email and google authentication options
  * Improved connectors page with account activation controls
  * Added visual cues for exceeding context window limits
  * Various bugfixes and improvements (sharing feature, copy/export formatting options, new chat button)
</Update>

<Update label="December 2025">
  * Added assistant message copy capabilities
  * Improved markdown rendering (lists, headings, numbered lists)
  * Fixed large datasets breaking the conversation and added reasonable query limits
</Update>


# A/B Testing & Change Analysis
Source: https://docs.hypd.ai/prompts/ab-testing-change-analysis

Measure the impact of recent account changes on performance

Use HYPD to understand whether your optimizations actually worked.

## Example Prompts

```
Check the changes made in the last 20 days. Did ROAS or profitability increase?
```

```
Compare performance before and after I paused that campaign.
```

```
What was the impact of switching to tROAS bidding?
```

***

## Example: Change Impact Analysis

**Prompt:**

```
Check changes made in the last 20 days. What were the results? We're optimizing towards pROAS.
```

**HYPD Response:**

Analyzed 493 changes (Oct 18-27) vs. prior 10 days (Oct 8-17).

**Overall: NEGATIVE impact on profitability.**

| Metric | Before | After | Change |
| - | - | - | - |
| ROAS | 2.81 | 2.37 | **-15.7%** |
| Cost/Conversion | \$18.71 | \$22.45 | **+20%** |
| Revenue | — | — | **-26.1%** |

### Losers (Worse Profitability)

| Campaign | ROAS Change | Cost/Conv | What Happened |
| - | - | - | - |
| Search - DSA | 1.83→1.48 (-19%) | +\$54 (+183%) | 481 aggressive keyword changes destroyed performance. Conv rate collapsed 3.31%→1.14%. |
| PMax - Tidy Titles | 3.30→2.82 (-15%) | +\$3.95 | Conv rate dropped 6.07%→4.84% |

### Winners (Improved Profitability)

| Campaign | ROAS Change | Cost/Conv | What Happened |
| - | - | - | - |
| Shopping - Catchall | 1.72→3.51 (+104%) | -\$11.06 | Conversion rate doubled |

### Recommendation

1. **Stop aggressive daily changes** to Search - DSA
2. **Restore removed keywords** from before Oct 18
3. **Shift budget** from failing DSA to Shopping - Catchall

***

## What HYPD Can Compare

| Analysis Type | Example |
| - | - |
| Before/after changes | *"Impact of last week's optimizations"* |
| Time period comparison | *"November vs October performance"* |
| Bidding strategy changes | *"tROAS vs Maximize Conversions results"* |
| Campaign experiments | *"How did the new ad copy perform?"* |

<Tip>
  Specify the date range and what you changed: *"I switched to tROAS on Nov 1. Compare the week before and after."*
</Tip>


# Analysis & Insights
Source: https://docs.hypd.ai/prompts/analysis-insights

Understand why metrics changed and find root causes

Use HYPD to go beyond the numbers and understand what's actually driving performance changes.

## Example Prompts

```
Can you explain why our revenue increased over the last two days even though spend stayed the same?
```

```
Our total conversions are down 30%. Are all campaigns impacted, or is this isolated?
```

```
Why did CPC spike last week?
```

```
Which campaigns are dragging down overall ROAS?
```

***

## Example: Root Cause Analysis

**Prompt:**

```
Can you explain why our revenue increased over the last two days even though spend stayed the same?
```

**HYPD Response:**

| Date | Spend | Revenue | ROAS | Avg Order Value | Conv Rate |
| - | - | - | - | - | - |
| Nov 1 | \$911 | \$1,259 | 1.38 | \$54.74 | 2.62% |
| Nov 2 | \$1,375 | \$2,124 | 1.54 | \$68.54 | 2.41% |
| Nov 3 | \$1,350 | \$1,477 | 1.09 | \$47.67 | 2.51% |
| **Nov 4** | **\$1,350** | **\$2,803** | **2.08** | **\$62.36** | **3.89%** |
| **Nov 5** | **\$1,172** | **\$2,470** | **2.11** | **\$91.87** | **2.52%** |

**Key Drivers:**

1. **Higher Conversion Rate on Nov 4** — jumped to 3.89% (vs 2.5% baseline), converting 56% more clicks into sales
2. **Higher Average Order Value on Nov 5** — AOV hit $91.87 (vs ~$60 baseline), customers buying more expensive items

The "PMax - New Users" campaign drove over 50% of revenue on Nov 5 with a 4.89 ROAS.

***

## Example: Performance Segmentation

**Prompt:**

```
Our total 'Demo Scheduled' conversions are down 30%. Are all campaigns impacted, or is this isolated?
```

**HYPD Response:**

The 30% drop isn't evenly distributed. Here's what's actually happening:

| Campaign | Conv 2024 | Conv 2025 | Change | Cost/Conv |
| - | - | - | - | - |
| **Search - Generic** | 119 | **482** | **+305%** | \$103.66 |
| Brand Exact | 0 | 29 | New | \$2.98 |
| Search - Generic (Alt) | 334 | 251 | -25% | \$132.70 |
| Search - DSA | 142 | 25 | **-82%** | \$111.54 |
| Search - Brand Broad | 488 | 133 | **-73%** | \$24.93 |
| Search - Industry (A) | 52 | 0 | -100% | — |
| Search - Industry (B) | 48 | 0 | -100% | — |
| Search - Industry (C) | 45 | 0 | -100% | — |

**Key Findings:**

1. **"Search - Generic" is the star** — growing +305% with 363 new conversions
2. **6 campaigns paused** — eliminated 244 monthly conversions from Industry Terms campaigns
3. **"Search - Brand Broad" collapsed** — down 73% despite increased spend (efficiency problem)
4. **"Search - DSA" cut** — down 82% after budget reduction

***

## What HYPD Can Analyze

| Analysis Type | Example Question |
| - | - |
| Root cause | *"Why did revenue drop on Tuesday?"* |
| Segmentation | *"Is the CPA increase across all campaigns?"* |
| Trend detection | *"When did performance start declining?"* |
| Attribution | *"Which campaign drove the conversion spike?"* |

<Tip>
  Follow up with *"Break that down by campaign"* or *"Show me the daily trend"* to dig deeper.
</Tip>


# Audits & Optimization
Source: https://docs.hypd.ai/prompts/audits-optimization

Find wasted spend, irrelevant search terms, and optimization opportunities

Use HYPD to audit your account and identify quick wins.

## Example Prompts

```
Can you search through the search term report and look for search terms to exclude that are irrelevant? Report back starting with ones with the most spend.
```

```
Where is budget being wasted?
```

```
Which keywords have high spend but zero conversions?
```

```
Find campaigns with declining performance over the last 30 days.
```

***

## Example: Finding Wasted Spend

**Prompt:**

```
Search through the search term report for irrelevant search terms to exclude. Start with highest spend.
```

**HYPD Response:**

Found **\$82 in wasted spend** (16% of budget) over the last 2 days.

### Category 1: Term Deposits — \$45 wasted

*Users looking for bank savings, not alternative investments.*

| Search Term | Spend | Clicks | Why It's Wrong |
| - | - | - | - |
| best 1 year term deposits | \$9.04 | 5 | Want bank savings |
| term deposit rates | \$7.20 | 4 | Generic bank term |
| best 1 year term deposits seniors | \$5.11 | 3 | Retirement savings |
| 1 year deposits monthly interest | \$3.53 | 2 | Bank income account |

### Category 2: Government Securities — \$11 wasted

*Users wanting to buy treasury directly.*

| Search Term | Spend | Clicks | Why It's Wrong |
| - | - | - | - |
| best government securities canada | \$5.47 | 3 | DIY treasury buyers |
| invest in treasury bonds | \$3.55 | 2 | DIY treasury buyers |

### Negative Keyword List to Add

```
-"term deposits"
-"term deposit"
-"for seniors"
-"high yield savings"
-tfsa
-rrsp
-gic
-"guaranteed investment"
-"government securities"
-treasury
-index fund
-mutual fund
```

***

## Example: Diagnosing a Performance Drop

**Prompt:**

```
Since November 1st we've had trouble getting good lead volume. Call conversions increased but they were spam so I removed that action. Here's this month's lead data: [pasted data]
```

**HYPD Response:**

**Found the problem: "portfolio strategy" keyword is killing your account.**

| Keyword | Conversions | Spend | CPL | Quality |
| - | - | - | - | - |
| **portfolio strategy** | **12.5 (43%)** | \$2,765 | \$221 | ❌ Spam |
| tax advantaged accounts | 1 | \$43 | \$43 | ❌ Spam |
| best passive income sources | 0.5 | \$221 | \$442 | ❌ Wrong product |
| vintage wine investment | 3 | \$264 | \$88 | ✅ Quality |
| is wine a good investment | 2.5 | \$337 | \$135 | ✅ Quality |

### Immediate Fixes

**1. Pause spam keywords now:**

* \[portfolio strategy]
* \[tax advantaged accounts]
* \[best passive income sources]

**2. Add account-level negatives:**

```
-tax advantaged
-high yield
-passive income
-treasury bills
-dividend
-best return
-guaranteed return
```

**3. Restore call tracking with controls:**
Set Form Fill value to $100, Call value to $10 — Google will prioritize forms while still tracking qualified calls.

***

## What HYPD Can Audit

| Audit Type | What It Finds |
| - | - |
| Search terms | Irrelevant queries wasting budget |
| Keywords | High-spend, zero-conversion terms |
| Campaigns | Underperformers dragging down ROAS |
| Ad copy | Low-CTR variations to pause or refresh |

<Tip>
  Ask HYPD to output negative keywords in a copy-paste format for easy import.
</Tip>


# Content Generation & Keywords
Source: https://docs.hypd.ai/prompts/content-generation-keywords

Generate ad copy, headlines, and keyword ideas based on your data

Use HYPD to create new ad content based on what's already working in your account.

## Example Prompts

```
Analyze my top performing copy variations bringing in conversions and help me make new headlines highlighting our competitive pricing USP.
```

```
Which headlines have the best CTR? Give me 10 variations in that style.
```

```
Generate description lines based on my best-converting ads.
```

***

## Example: Ad Copy from USP

**Prompt:**

```
Analyze top performing copy bringing in conversions. Create new headlines highlighting our USP: most competitive pricing. Include headlines and descriptions.
```

**HYPD Response:**

I've analyzed your top 3 ads. Key themes driving conversions: **Trust & Safety** ("Full Asset Ownership", "Certified Storage") and **Data/Authority** ("Data-Backed", "\$6.5bn Market").

None of your current winners emphasize price — great opportunity.

### New Headlines: Competitive Pricing (under 30 chars)

**Direct Price Messaging:**

1. Best AU Investment Prices (26)
2. Lowest Entry Costs AU (21)
3. Most Competitive Prices (24)
4. Direct Prices, No Brokers (26)
5. Unbeatable Entry Pricing (25)

**Price + Trust Combo:**

1. Best Prices + Full Ownership (26)
2. Lowest Prices, Top Quality (28)
3. Great Prices, Full Control (27)
4. Best Value + Full Ownership (28)

### Descriptions (under 90 chars)

```
We offer Australia's most competitive vintage wine investment prices. Full ownership, insured.
```

```
Direct-from-vineyard pricing means better value. No brokers. Get your free quote today.
```

```
Compare our prices - we're confident you'll find the best value. Full legal ownership guaranteed.
```

### Recommendation

Create 2 new ads combining 3-4 price-focused headlines with 3-4 proven "Trust & Safety" headlines. This lets Google test your new USP with proven themes.

***

## What HYPD Can Generate

| Content Type | What You Get |
| - | - |
| Headlines | Variations based on top performers (with character counts) |
| Descriptions | Full lines for RSAs under 90 characters |
| Keyword ideas | Expansion based on converting terms |
| Negative keywords | Formatted lists ready to import |

<Tip>
  Specify character limits: *"Headlines under 30 characters"* or *"Descriptions under 90 characters."*
</Tip>


# Prompts Overview
Source: https://docs.hypd.ai/prompts/overview

See what you can ask HYPD to do with your ad data

HYPD understands natural language questions about your Google Ads performance. Here's what you can ask about:

<Columns>
  <Card title="Reporting & Visualization" icon="chart-pie" href="/prompts/reporting-visualization">
    Weekly summaries, performance dashboards, graphs and tables.
  </Card>

  <Card title="Analysis & Insights" icon="magnifying-glass-chart" href="/prompts/analysis-insights">
    Understand why metrics changed and find root causes.
  </Card>

  <Card title="Audits & Optimization" icon="broom" href="/prompts/audits-optimization">
    Find wasted spend, irrelevant search terms, and optimization opportunities.
  </Card>

  <Card title="Content & Keywords" icon="pen-ruler" href="/prompts/content-generation-keywords">
    Generate ad copy and headlines based on top performers.
  </Card>

  <Card title="Strategic Planning" icon="route" href="/prompts/strategic-planning">
    Get ROAS roadmaps and recommendations to hit your targets.
  </Card>

  <Card title="A/B Testing & Changes" icon="code-compare" href="/prompts/ab-testing-change-analysis">
    Measure the impact of recent account changes.
  </Card>
</Columns>

***

## Quick Examples

```
How was last week's performance? Add a graph.
```

```
Where is budget being wasted?
```

```
Currently the ROAS is 2.46 and we target 3.5. What are your recommendations?
```

```
Which keywords have the highest cost per conversion?
```

<Tip>
  For best results, be specific about timeframes and metrics. See [How HYPD Works](/getting-started/how-hypd-works#tips-for-better-questions) for more tips.
</Tip>


# Reporting & Visualization
Source: https://docs.hypd.ai/prompts/reporting-visualization

Generate performance summaries, tables, and charts

Use HYPD to create instant reports instead of digging through Google Ads dashboards.

## Example Prompts

```
How was last week's performance? Add a graph.
```

```
Can you prepare a performance report for the client for December 1-31?
```

```
Show me a table of my top 10 campaigns by conversions this month.
```

```
Give me a daily breakdown of spend and revenue for the last 14 days.
```

***

## Example: Weekly Performance with Chart

**Prompt:**

```
How was last week's performance? Add a graph.
```

**HYPD Response:**

| Date | Spend | Revenue | ROAS | Conversions |
| - | - | - | - | - |
| Oct 27 | \$395 | \$481 | **1.22** | 10 |
| Oct 28 | \$383 | \$380 | **0.99** | 5 |
| Oct 29 | \$303 | \$182 | **0.60** | 2 |
| Oct 30 | \$341 | \$722 | **2.12** | 8 |
| Oct 31 | \$715 | \$1,243 | **1.74** | 21 |
| Nov 1 | \$911 | \$1,259 | **1.38** | 26 |
| Nov 2 | \$1,375 | \$2,124 | **1.54** | 37 |

**Key Insights:**

* Strong upward trend through the week, peaking Sunday
* Best ROAS on Thursday (2.12x)
* Wednesday was weakest at 0.60 ROAS

***

## Example: Client-Ready Monthly Report

**Prompt:**

```
Can you prepare a performance report for the client for December 1-31?
```

**HYPD Response:**

### Executive Summary

| Metric | Value |
| - | - |
| Total Spend | \$44,735 |
| Total Revenue | \$117,871 |
| ROAS | **2.64x** |
| Total Conversions | 1,829 |
| Cost Per Conversion | \$24.46 |

### Weekly Breakdown

| Week | Spend | Revenue | ROAS | Conversions |
| - | - | - | - | - |
| Dec 1-7 | \$7,390 | \$16,890 | **2.29** | 264 |
| Dec 8-14 | \$30,873 | \$68,602 | **2.22** | 1,075 |
| Dec 15-21 | \$5,458 | \$25,237 | **4.62** | 420 |
| Dec 22-28 | \$1,012 | \$7,143 | **7.06** | 71 |

**Insights:** Peak volume in Week 2 during holiday shopping. Best efficiency in Week 3 at 4.62x ROAS.

***

## Output Types You Can Request

| Type | When to Use | How to Ask |
| - | - | - |
| Tables | Comparing periods or campaigns | *"Show me a table..."* |
| Line charts | Trends over time | *"Add a graph..."* |
| Bar charts | Category comparisons | *"Bar chart of conversions by campaign"* |
| Summaries | Client reports | *"Prepare a report for..."* |

<Tip>
  Ask for specific metrics if you want a focused report: *"Just show me spend, conversions, and ROAS."*
</Tip>


# Strategic Planning
Source: https://docs.hypd.ai/prompts/strategic-planning

Get ROAS roadmaps, what-if scenarios, and recommendations to hit your targets

Use HYPD for high-level strategic planning and actionable roadmaps.

## Example Prompts

```
Currently the ROAS is 2.46 and we target 3.5. What are your recommendations or a roadmap to get there?
```

```
Using last month's data, what could I have done to improve performance?
```

```
How should I reallocate budget across campaigns to maximize ROAS?
```

***

## Example: ROAS Improvement Roadmap

**Prompt:**

```
ROAS is 2.46 and we target 3.5. What's your roadmap to get there?
```

**HYPD Response:**

You need a 42% improvement. Here's a 3-phase roadmap.

### Current State

| Tier | Campaigns | Spend | Revenue | ROAS | % Budget |
| - | - | - | - | - | - |
| **A (3.5+)** | 1 | \$115 | \$781 | **6.79** | 0.4% |
| **B (2.5-3.49)** | 3 | \$19,758 | \$54,126 | **2.74** | 67.2% |
| **C (1.5-2.49)** | 3 | \$7,162 | \$15,263 | **2.13** | 24.4% |
| **D (`<`1.5)** | 1 | \$2,371 | \$2,114 | **0.89** | 8.1% |

**Problem:** 90% of budget on campaigns with 0.89–2.84 ROAS. Only 0.4% on your top performer.

### Phase 1: Quick Wins (Week 1-2) → Target 2.61

1. **Stop the bleeding** — Pause "PMax - New Products" (0.89 ROAS). Saves \$2,371.
2. **Cut wasted search terms** — Add negatives to brand campaign. Saves \~\$575/month.

### Phase 2: Optimize & Scale (Week 3-8) → Target 2.96

1. **Scale the winner** — Increase "Shopping - Remarketing" (6.79 ROAS) from $115 to $960/month.
2. **Optimize top spender** — Review "PMax - Core" product feed, exclude poor brands. Lift from 2.64 to 2.9.

### Phase 3: Restructure (Month 3+) → Target 3.5

1. **Migrate bidding** — Switch to tROAS with 3.5 target.
2. **Tiered PMax** — Split by product performance (High/Med/Low ROAS) for better budget control.

***

## Example: Historical "What If" Analysis

**Prompt:**

```
Using December 2024 data, what could I have done to make performance even better?
```

**HYPD Response:**

December was excellent ($118k revenue, 2.64 ROAS) but you left **$95k–\$120k profit\*\* on the table.

### Issue 1: Underinvestment in Winners

You spent **6.5x more** on zero-conversion keywords than your top performers.

| Keyword | Spend | Revenue | ROAS |
| - | - | - | - |
| "TechStore" (Phrase) | \$60 | \$3,301 | **55.02x** |
| "\[techstore.com]" (Phrase) | \$1.56 | \$365 | **233.97x** |

**Missed opportunity:** $1,800 on these keywords would have generated ~$99,000 in revenue.

### Issue 2: Wasted Spend on Broad Match

\$401 spent on 27 keywords with **zero conversions** (73% of keyword budget wasted).

| Keyword | Match Type | Spend | Conversions |
| - | - | - | - |
| gaming console | Broad | \$49 | 0 |
| controller set | Broad | \$46 | 0 |
| action figures | Broad | \$44 | 0 |

**Fix:** Pause broad match by Day 3. Reallocate to winners.

### What December Could Have Been

| | Actual | Optimized |
| - | - | - |
| Revenue | \$117,871 | **$215k–$240k** |
| ROAS | 2.64x | **\~4.8x** |

***

## What HYPD Can Plan

| Planning Type | Example |
| - | - |
| Target roadmaps | *"How do I get to 4x ROAS?"* |
| Budget allocation | *"Where should I shift spend?"* |
| Historical audits | *"What should I have done differently?"* |
| Scenario analysis | *"What if I paused this campaign?"* |

<Tip>
  Share your target KPIs upfront: *"We need 3.5 ROAS at \$50k/month spend."*
</Tip>


# FAQ
Source: https://docs.hypd.ai/resources/faq

Common questions about HYPD

<AccordionGroup>
  <Accordion title="How do you connect my ad accounts?">
    We use official Google and Meta API connections. Access is encrypted, secure, and authenticated directly through Google/Meta OAuth. You authorize read-only access and can revoke it anytime.
  </Accordion>

  <Accordion title="Do you store my campaign data?">
    No. Your data is fetched in real-time to answer questions, then discarded. We only store account identifiers, encrypted OAuth tokens, and your chat history. See our [Security & Privacy](/resources/security-privacy) page for details.
  </Accordion>

  <Accordion title="Is this just another ChatGPT wrapper?">
    No. Generic AI gives generic answers. HYPD connects directly to your ad accounts via API, pulls real data, and performs actual calculations. It's a specialized performance marketing tool built for accuracy on your data.
  </Accordion>

  <Accordion title="Can HYPD make changes to my account?">
    Not yet. HYPD is read-only—it provides recommendations (like negative keyword lists) for you to implement. Direct campaign changes ("agent mode") are in development.
  </Accordion>

  <Accordion title="Can you connect to Google Analytics or Merchant Center?">
    Google Analytics integration is in active development. Google Merchant Center and Keyword Planner are next on our roadmap. See [Coming Soon](/connectors/coming-soon).
  </Accordion>

  <Accordion title="How much does it cost?">
    HYPD has public pricing, including a free plan and a 14-day free trial with full Pro access (no credit card required). See the [pricing page](https://www.hypd.ai/pricing) for current plans, or email [help@hypd.ai](mailto:help@hypd.ai) with any questions.
  </Accordion>

  <Accordion title="What Google Ads data can HYPD access?">
    Campaigns, ad groups, keywords, search terms, ads, and performance metrics (impressions, clicks, cost, conversions, revenue, etc.). See [How HYPD Works](/getting-started/how-hypd-works) for the full list.
  </Accordion>

  <Accordion title="Why do I need to select an advertiser account, not my MCC?">
    HYPD analyzes individual advertiser accounts. Your MCC (Manager account) is just an access layer—select the account with direct access to the advertiser data you want to analyze.
  </Accordion>

  <Accordion title="Can I analyze multiple accounts?">
    Yes, but one account per chat. Start a new chat to switch accounts.
  </Accordion>

  <Accordion title="How do I revoke HYPD's access?">
    Go to your [Google Account permissions](https://myaccount.google.com/permissions) and remove HYPD. You can also disconnect from the Sources page in HYPD.
  </Accordion>
</AccordionGroup>

***

## Still Have Questions?

<Card title="Contact Support" icon="envelope" href="mailto:help@hypd.ai">
  Email us at [help@hypd.ai](mailto:help@hypd.ai)
</Card>


# Google Ads API Limitations
Source: https://docs.hypd.ai/resources/google-ads-api-limitations

Understanding what data is unavailable through the Google Ads API

HYPD connects to your Google Ads account through the official Google Ads API. While the API provides access to most campaign data, certain features are only available in the Google Ads UI.

This page outlines what HYPD **cannot** access due to Google's API constraints.

***

## Auction Insights

<Warning>
  **COMPLETELY UNAVAILABLE** - Must use Google Ads UI
</Warning>

The following competitive auction metrics are not supported by the Google Ads API:

* Impression share vs. competitors
* Overlap rate with competitors
* Position above rate
* Top of page rate vs. competitors
* Any competitive auction metrics

**Why?** Google does not expose Auction Insights data through the API. You must use the Google Ads UI to view this information.

***

## Quality Score Details

<Info>
  **PARTIAL AVAILABILITY** - Raw scores available, categorical labels not available
</Info>

HYPD can access numeric Quality Score components (1-10 scale), but not the simplified labels:

* **Available:** Numeric scores for Quality Score, Expected CTR, Ad Relevance, and Landing Page Experience
* **Not Available:** "Above average/Average/Below average" categorical labels

**Why?** The categorical labels are UI-only shorthand. The API provides the underlying numeric scores, which HYPD can analyze and report.

***

## Performance Max Channel Breakdown

<Warning>
  **COMPLETELY UNAVAILABLE** - Must use Google Ads UI
</Warning>

Performance Max campaign breakdowns by channel (Search, Display, YouTube, Gmail, Discover) are not available through the API.

**Why?** Google does not expose channel-level performance data for Performance Max campaigns in the API. You must use the Google Ads UI to view asset group performance by channel.

***

## Need This Data?

For features listed as unavailable, you'll need to access them directly in the [Google Ads UI](https://ads.google.com). HYPD can still analyze all other campaign data, metrics, and dimensions available through the API.

If you have questions about what data HYPD can access, see [How HYPD Works](/getting-started/how-hypd-works).


# Security & Privacy
Source: https://docs.hypd.ai/resources/security-privacy

How HYPD handles your data, permissions, and compliance

## Is My Data Stored?

**No.** Your ad performance data is not stored on HYPD servers. Data is fetched in real-time to answer your questions, then discarded.

We only retain:

* **Account identifiers** — to show your connected accounts
* **OAuth tokens** — encrypted, read-only access credentials
* **Chat history** — conversations you've had (deletable anytime)

<Info>
  Delete a chat and its fetched data is removed with it.
</Info>

***

## What Permissions Does HYPD Require?

HYPD operates in **read-only mode**. We cannot modify campaigns, budgets, bids, or ads.

| Platform | Access Level | What We Can See |
| - | - | - |
| Google Ads | Read-only | Campaigns, keywords, ads, search terms, performance metrics |
| Meta Ads | Read-only | Campaigns, ad sets, ads, performance metrics |

<Warning>
  **Google Ads note:** Due to Google API constraints, we request full scope access. However, HYPD only uses read-only operations to analyze your data.
</Warning>

You can revoke access anytime from your [Google Account permissions](https://myaccount.google.com/permissions).

***

## Do You Train AI on My Data?

**No.** Your data is never used to train AI models.

We use third-party LLMs strictly for inference (answering your questions). Our configuration:

* No training on your data
* No data retention for model improvement
* Inputs processed only to deliver your requested analysis

***

## How Do I Delete My Data?

* **Delete a chat** — removes the conversation and all fetched data within it
* **Disconnect an account** — removes OAuth tokens and account identifiers
* **Delete your account** — removes all associated data from HYPD

Contact [help@hypd.ai](mailto:help@hypd.ai) if you need confirmation of deletion.

***

## Security Measures

| Measure | Implementation |
| - | - |
| Data in transit | TLS 1.2+ encryption |
| OAuth tokens | Encrypted secret storage |
| Access model | Read-only, least-privilege |
| Data isolation | No cross-customer data sharing |

***

## Compliance

We follow core privacy principles including data minimization, purpose limitation, and user-controlled deletion.

For security questionnaires or DPA requests, contact [contact@hypd.ai](mailto:contact@hypd.ai).

***

## Policies

<CardGroup>
  <Card title="Privacy Policy" icon="shield" href="https://www.hypd.ai/privacy">
    Full privacy policy
  </Card>

  <Card title="Terms of Use" icon="file-contract" href="https://www.hypd.ai/terms-of-use">
    Terms and conditions
  </Card>
</CardGroup>