# Chameleon

Chameleon is a product adoption platform that lets you build in-app experiences — tours, tooltips, surveys, launchers, and help bars — to onboard and engage users. Connecting Chameleon to Coupler.io lets you pull all that experience and response data into your analytics stack without writing a single line of code.

## Why connect Chameleon to Coupler.io?

* **Centralize your product adoption data** — bring tours, tooltips, surveys, and survey responses into one place alongside your other product and marketing data.
* **Analyze survey responses at scale** — export raw response data to Google Sheets, BigQuery, or an AI destination like ChatGPT or Gemini for deeper analysis.
* **Combine with other sources** — use Join or Append transformations to merge Chameleon data with CRM or product analytics data.
* **Automate reporting** — schedule regular syncs so your dashboards always reflect the latest experience performance.

## Prerequisites

Before connecting, make sure you have:

* A Chameleon account with API access (available on paid plans)
* Your Chameleon **Account Secret** API key — find it in Chameleon under **Settings → Integrations → API**

## Quick start

{% hint style="success" %}
Start with the **Survey responses** entity if your main goal is analyzing user feedback. It's the richest source of actionable data in Chameleon.
{% endhint %}

## How to connect

{% stepper %}
{% step %}
**Create a new data flow in Coupler.io.** Log in to Coupler.io, go to **Data flows**, and click **Add data flow**. Search for **Chameleon** and select it as your source.
{% endstep %}

{% step %}
**Enter your API key.** In the source settings, paste your Chameleon Account Secret into the **API key** field. You can find this in Chameleon under **Settings → Integrations → API**.
{% endstep %}

{% step %}
**Choose an entity.** Select the data entity you want to import — for example, **Survey responses**, **Tours**, or **Segments**. You can add more entities to the same data flow later.
{% endstep %}

{% step %}
**Set a start date.** Use the date picker to set the start date for your data export. This controls how far back Coupler.io pulls historical records.
{% endstep %}

{% step %}
**Choose a destination.** Select where you want your data to land — Google Sheets, Excel, BigQuery, Looker Studio, or an AI destination like ChatGPT, Claude, or Gemini.
{% endstep %}

{% step %}
**Run the data flow.** Click **Run** to execute a manual sync and confirm your data lands correctly before setting up a schedule.
{% endstep %}
{% endstepper %}

## Available entities

| Entity           | Description                                 |
| ---------------- | ------------------------------------------- |
| Helpbars         | Help bar elements and their configurations  |
| Segments         | User segments and their definitions         |
| URLs             | URLs tracked within your Chameleon instance |
| URL groups       | Groups of related URLs                      |
| Changes          | Changes made to Chameleon experiences       |
| Launchers        | Launcher configurations for experiences     |
| Tooltips         | Tooltip experiences and their settings      |
| Tours            | Product tour experiences                    |
| Surveys          | Survey configurations and metadata          |
| Survey responses | Responses collected from surveys            |