# 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            |


---

# Agent Instructions: 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.coupler.io/sources/category/marketing/chameleon.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.