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
- Open AI Visibility.
- Click the send icon in the header bar.
- 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.
- Under Projects to ingest AI Visibility events, select which Amplitude projects should receive events.
- 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 name | Scope | Default |
|---|---|---|
AI Visibility: Brand Report Completed | One event for each brand for each report. Includes your primary brand and any enabled competitors. | Enabled |
AI Visibility: Competitor Report Completed | One event for each competitor for each report. This is useful for comparison charts. | Disabled |
AI Visibility: Topic Report Completed | One 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
| Property | Type | Description |
|---|---|---|
Report ID | number | ID of the completed model report. |
Brand Name | string | Display name of the brand. |
Company Name | string | Company name associated with the brand. |
Is Competitor | boolean | false for your primary brand, true for competitors. |
Visibility Percentage | number | Percentage of AI responses that mention the brand (0–100). |
Average Rank | number | Average position the brand appears at across responses. Responses that don't mention the brand use a default rank of 10. |
Total Responses | number | Total number of AI model responses in the report. |
Mentioned Responses | number | Number 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
{
"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
| Property | Type | Description |
|---|---|---|
Report ID | number | ID of the completed model report. |
Topic Name | string | Display name of the topic. |
Visibility Percentage | number | Percentage of responses in this topic that mention your brand (0–100). |
Average Rank | number | Average position your brand appears at across prompts in this topic. Defaults to 10 if visibility is 0%. |
Relevancy | number | Percentage of responses that mention your brand or any competitor (0–100). Measures how relevant the topic is to the competitive landscape. |
Citations | number | Number of citation URLs in this topic whose domain matches your brand's domain. |
Example
{
"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
- Open any chart (for example, Event Segmentation).
- In the event picker, search for
AI Visibility: Brand Report CompletedorAI Visibility: Topic Report Completed. - Group by event properties like
Brand Name,Is Competitor, orTopic Nameto break down results.
Track competitor rankings
- Open Event Segmentation.
- Select the event AI Visibility: Brand Report Completed.
- Group by Company Name.
- Set the metric to Average Rank.
Track topic performance
- Open Event Segmentation.
- Select the event AI Visibility: Topic Report Completed.
- Group by Topic Name.
- 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?