> For the complete documentation index, see [llms.txt](https://docs.optibase.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.optibase.io/integrations/amplitude.md).

# Amplitude

### Setup

Unlike some integrations, Amplitude requires a one-time connection in your Optibase dashboard.

1. Go to your Optibase dashboard → **Settings** → **Integrations**
2. Find the Amplitude section and click **Connect**
3. Select your region — **United States (US)** or **Europe (EU)**. This must match the region of your Amplitude project.
4. Paste your **Amplitude API key**. You can find it in Amplitude → Settings → Projects → your project → General
5. Click **Connect**. Optibase will verify the key before saving.

{% hint style="info" %}
**Note:** This integration is available on paid plans only.
{% endhint %}

### Testing the Connection

Once connected, you can verify the integration is working by clicking Test Connection in the Amplitude integration settings. This sends a test event to your Amplitude project. You should see an event named `optibase_connection_test` appear in Amplitude under your project's event stream shortly after.

### Adding Amplitude to Your Page

Include the Amplitude browser SDK on your page **before** the Optibase script:

```html
<script src="https://cdn.amplitude.com/libs/analytics-browser-2.0.0-min.js.gz"></script>
<script>
  window.amplitude.init('YOUR_AMPLITUDE_API_KEY', {
    defaultTracking: true,
    serverUrl: 'https://api.eu.amplitude.com/2/httpapi' // use https://api2.amplitude.com/2/httpapi for US
  });
</script>

<!-- Optibase script must come after -->
```

Replace `YOUR_AMPLITUDE_API_KEY` with your Amplitude project API key and set the `serverUrl` to match your region.

### Event Details

#### optibase\_variant\_shown

When a variant is assigned to a visitor, Optibase sends an event named `optibase_variant_shown` to Amplitude with the following properties:

| Property    | Description        |
| ----------- | ------------------ |
| `testId`    | ID of the A/B test |
| `variantId` | Assigned variant   |

#### optibase\_conversion\_triggered

Sent when a visitor triggers a conversion event.

| Property       | Description                                     |
| -------------- | ----------------------------------------------- |
| `conversionId` | The ID of the conversion as defined in Optibase |

***

### Analytics Setup

Once events are flowing into Amplitude, they can be used across Event Segmentation, Funnel Analysis, and User Lookup. A typical starting point is using `optibase_variant_shown` as a segmentation filter to isolate visitors by experiment and variant, then layering in `optibase_conversion_triggered` or any of your own events to measure downstream behaviour.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.optibase.io/integrations/amplitude.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.