On this page

Send AI Visibility data to Amplitude

AI Visibility can send weekly report results directly into your Amplitude projects as events. This lets you analyze your brand's AI visibility metrics alongside your product, behavioral, and user data across the entire Amplitude platform. Use these events in charts, cohorts, dashboards, and any other analysis.

Each unique brand or competitor that receives events counts toward your project's monthly tracked users (MTU) quota. Enabling competitor events or topic events increases event volume. Review your plan's MTU limits before enabling additional event types.

Prerequisites

Before enabling event ingestion:

  • Set up AI Visibility for your organization. Review AI Visibility.
  • Confirm you have access to the Amplitude project(s) where you want to receive events.

Enable event ingestion

  1. Open AI Visibility.
  2. Click the send icon in the header bar.
  3. In the Event Setup modal, toggle the event types you want to send:
    • Brand update events: One event for each brand for each report, with brand score, mention rate, and citation data. Enabled by default.
    • Competitor events: One event for each competitor for each report. Disabled by default.
    • Topic events: One event for each topic for each report, for your primary brand only. Disabled by default.
  4. Under Projects to ingest AI Visibility events, select which Amplitude projects should receive events.
  5. Click Save.

Events begin streaming after the next weekly report completes. A status banner confirms that ingestion starts with the next report run.

If you select specific projects, only those projects receive events. If you don't select any projects, Amplitude sends events to all projects in your organization.

Event types

AI Visibility generates three event types. You control each independently from the Event Setup modal.

Event nameScopeDefault
AI Visibility: Brand Report CompletedOne event for each brand for each report. Includes your primary brand and any enabled competitors.Enabled
AI Visibility: Competitor Report CompletedOne event for each competitor for each report. This is useful for comparison charts.Disabled
AI Visibility: Topic Report CompletedOne event for each topic for each report. Your primary brand only.Disabled

Amplitude sends events one time each week, after each report completes. If you update your event settings, the new configuration takes effect on the next report run.

AI Visibility: Brand Report Completed

This event tracks how visible each brand is across AI model responses in a given report. Amplitude sends one event for each brand for each report. If you have one primary brand and three competitors enabled, each report generates four events.

Use this event to analyze share of voice across competitors, ranking trends over time, and competitive positioning in AI responses.

Properties

PropertyTypeDescription
Report IDnumberID of the completed model report.
Brand NamestringDisplay name of the brand.
Company NamestringCompany name associated with the brand.
Is Competitorbooleanfalse for your primary brand, true for competitors.
Visibility PercentagenumberPercentage of AI responses that mention the brand (0–100).
Average RanknumberAverage position the brand appears at across responses. Responses that don't mention the brand use a default rank of 10.
Total ResponsesnumberTotal number of AI model responses in the report.
Mentioned ResponsesnumberNumber of responses that mention this brand.

Amplitude factors in brand aliases. If your brand has aliases configured (for example, "Google" and "Alphabet"), a mention of any alias counts as a mention of the brand.

Example

json
{
  "event_type": "AI Visibility: Brand Report Completed",
  "event_properties": {
    "Report ID": 9876,
    "Brand Name": "Amplitude",
    "Company Name": "Amplitude",
    "Is Competitor": false,
    "Visibility Percentage": 57.6,
    "Average Rank": 5.5,
    "Total Responses": 1750,
    "Mentioned Responses": 1008
  }
}

AI Visibility: Topic Report Completed

This event tracks how your primary brand performs within each topic (a category of prompts). Amplitude sends this event for your primary brand only, not competitors. Amplitude sends one event for each topic for each report.

Use this event to analyze visibility by topic, topic-level ranking trends, and content opportunities where your brand underperforms.

Properties

PropertyTypeDescription
Report IDnumberID of the completed model report.
Topic NamestringDisplay name of the topic.
Visibility PercentagenumberPercentage of responses in this topic that mention your brand (0–100).
Average RanknumberAverage position your brand appears at across prompts in this topic. Defaults to 10 if visibility is 0%.
RelevancynumberPercentage of responses that mention your brand or any competitor (0–100). Measures how relevant the topic is to the competitive landscape.
CitationsnumberNumber of citation URLs in this topic whose domain matches your brand's domain.

Example

json
{
  "event_type": "AI Visibility: Topic Report Completed",
  "event_properties": {
    "Report ID": 9876,
    "Brand Name": "Amplitude",
    "Topic Name": "Cohort and retention analysis",
    "Visibility Percentage": 89,
    "Average Rank": 2.5,
    "Relevancy": 90,
    "Citations": 51
  }
}

Analyze AI Visibility in Amplitude

After events flow into your project, you can use them anywhere in Amplitude Analytics, including Event Segmentation, dashboards, and cohorts.

Find AI Visibility events

  1. Open any chart (for example, Event Segmentation).
  2. In the event picker, search for AI Visibility: Brand Report Completed or AI Visibility: Topic Report Completed.
  3. Group by event properties like Brand Name, Is Competitor, or Topic Name to break down results.

Track competitor rankings

  1. Open Event Segmentation.
  2. Select the event AI Visibility: Brand Report Completed.
  3. Group by Company Name.
  4. Set the metric to Average Rank.

Track topic performance

  1. Open Event Segmentation.
  2. Select the event AI Visibility: Topic Report Completed.
  3. Group by Topic Name.
  4. Set the metric to Visibility Percentage.

Other use cases

  • Build dashboards that combine product usage metrics with AI visibility trends.
  • Create alerts when visibility percentage drops below a threshold.
  • Compare AI visibility with conversion or retention metrics.

Limitations

  • You configure event ingestion at the organization level, and it applies to all brands in AI Visibility. You can't configure it for each brand.
  • Events aren't retroactive. There's no historical backfill. Ingestion starts from the next report that completes after you enable it.
  • Enabling competitor events or topic events increases MTU consumption. Each unique brand or competitor counts toward your project's MTU quota.

Was this helpful?