Chameleon connector
Set up the Chameleon connector in Kaivo: authentication, configuration, the 10 BigQuery tables it syncs, and answers to common questions.
Written By Lauri Raivio
Last updated 16 days ago
Kaivo is a fully managed data platform that syncs your Chameleon data into a Google BigQuery warehouse and keeps it up to date automatically. There is no pipeline to build and no infrastructure to run, so you can spend your time analysing your marketing and sales data instead of moving it.
What is the Chameleon connector
Sync your Chameleon in-product experience data into BigQuery with Kaivo to see which tours, tooltips, and surveys reach your users.
Getting started with the Chameleon connector
- Sign up for Kaivo and create a workspace.
- Connect your Chameleon account.
- Choose which tables to sync.
- Wait for the initial sync to finish.
- Query your data in BigQuery or your favourite AI or BI tool.
Authenticating Chameleon
Authenticate with your API Key.
Configuring the Chameleon connector
When you set up the connector, you provide:
Tables and columns synced from Chameleon
Kaivo syncs 10 tables from Chameleon into a dedicated dataset in your BigQuery warehouse. Click any table to see its columns and types.
changes (23 columns)
changes (23 columns)
Subtable: changes__object__body
Subtable: changes__object__completed_unpublish_count
Subtable: changes__object__completed_unpublish_user_id
Subtable: changes__object__count_at
Subtable: changes__object__display_animation
Subtable: changes__object__first_published_at
Subtable: changes__object__name
Subtable: changes__object__published_at
Subtable: changes__object__published_at_count
Subtable: changes__object__published_completed_unpublish_count
Subtable: changes__object__published_run_at
Subtable: changes__object__published_run_at_count
Subtable: changes__object__published_segment_ids
Subtable: changes__object__published_segment_ids__list
Subtable: changes__object__published_updated_at
Subtable: changes__object__published_user_id
Subtable: changes__object__recurrence_frequency
Subtable: changes__object__recurrence_kind
Subtable: changes__object__secondary_trigger
Subtable: changes__object__secondary_trigger_position
Subtable: changes__object__segment_at
Subtable: changes__object__segment_ids
Subtable: changes__object__segment_ids__list
Subtable: changes__object__step_trigger
Subtable: changes__object__style_relative_offset_x
Subtable: changes__object__style_trigger_offset_x
Subtable: changes__object__style_trigger_offset_y
Subtable: changes__object__style_trigger_scale_width
Subtable: changes__object__trigger_element_attachment_id
Subtable: changes__object__trigger_secondary_type
Subtable: changes__object__use
Subtable: changes__object__width_with_units
Subtable: changes__options__capture_id
Subtable: changes__options__trigger_element_attachment_url
helpbars (31 columns)
helpbars (31 columns)
Subtable: helpbars__components
Subtable: helpbars__url_group_ids
Subtable: helpbars__widget_css_syntax_errors
launchers (17 columns)
launchers (17 columns)
Subtable: launchers__excluded_segment_ids
Subtable: launchers__items
Subtable: launchers__quantifier_urls
Subtable: launchers__segment_ids
Subtable: launchers__tag_ids
segments (6 columns)
segments (6 columns)
Subtable: segments__items
survey_responses (145 columns)
survey_responses (145 columns)
Subtable: survey_responses__comment_step_buttons_selected
Subtable: survey_responses__comment_step_buttons_selected2
Subtable: survey_responses__comment_step_dropdown_items
Subtable: survey_responses__comment_step_dropdown_items2
Subtable: survey_responses__dropdown_items
Subtable: survey_responses__profile__options__chameleon_launchers_started
Subtable: survey_responses__profile__options__clearbit_company_domain_aliases
Subtable: survey_responses__profile__options__clearbit_company_site_email_addresses
Subtable: survey_responses__profile__options__clearbit_company_site_phone_numbers
Subtable: survey_responses__profile__options__clearbit_company_tags
Subtable: survey_responses__profile__options__clearbit_company_tech
Subtable: survey_responses__profile__options__clearbit_reveal_company_domain_aliases
Subtable: survey_responses__profile__options__clearbit_reveal_company_site_email_addresses
Subtable: survey_responses__profile__options__clearbit_reveal_company_site_phone_numbers
Subtable: survey_responses__profile__options__clearbit_reveal_company_tags
Subtable: survey_responses__profile__options__clearbit_reveal_company_tech
Subtable: survey_responses__profile__options__providers
surveys (17 columns)
surveys (17 columns)
Subtable: surveys__excluded_segment_ids
Subtable: surveys__last_dropdown_items
Subtable: surveys__segment_ids
Subtable: surveys__tag_ids
tooltips (8 columns)
tooltips (8 columns)
Subtable: tooltips__tag_ids
tours (13 columns)
tours (13 columns)
Subtable: tours__excluded_segment_ids
Subtable: tours__segment_ids
Subtable: tours__tag_ids
url_groups (8 columns)
url_groups (8 columns)
urls (8 columns)
urls (8 columns)
How the Chameleon sync works
After the first load, Kaivo keeps your BigQuery warehouse up to date for you. Where Chameleon supports it, each sync pulls only new and changed records so it stays fast; otherwise it refreshes the whole table. Every record keeps its original ID, so you won't get duplicate rows.
Frequently asked questions
How long does the initial sync take for Chameleon?
It depends on how much history is in your Chameleon account. Most initial syncs finish within minutes, while large accounts can take a few hours. After that, syncs only fetch new and changed records, so they're much faster.
Can I sync only some tables or columns?
Yes. You pick which tables to sync when you set up the connection and can change the selection later. Tables you don't select are never copied to your warehouse.
What happens when Chameleon's schema changes?
New fields are never added automatically. You choose which fields to sync, so data you haven't selected (sensitive personal data, for example) never lands in your warehouse. When a new field appears, it becomes available for you to add. What happens to removed or renamed fields depends on a table's sync mode: full-refresh tables always match what's currently in Chameleon, so dropped fields disappear, while incremental tables keep their existing columns and history, so an old field stays and newly added fields fill in over time.
How do I handle GDPR or data deletion requests?
Your data lives in your own Kaivo-managed BigQuery warehouse, so the most direct option is to delete or anonymise specific records right in BigQuery. If you delete data in Chameleon instead, full-refresh tables drop it on the next sync, while incremental tables keep it, so you would remove the row in BigQuery or ask us to run a full refresh. To remove everything, delete the Chameleon connector in Kaivo and all of its synced data is deleted with it.
Common use cases for Chameleon data
Experience inventory
Use tours, tooltips, and launchers to document the in-app guidance you run.
Survey analysis
Join surveys with survey_responses to measure in-app feedback.
Targeting
Use segments to see which user groups each experience targets.
Use Chameleon data in your AI and BI tools
Once Chameleon data lands in your Kaivo-managed BigQuery warehouse, you can explore it with AI tools or any BI tool that connects to BigQuery. Here's how the most common destinations work with Chameleon data.
Claude
Use Kaivo's MCP server to give Claude secure, workspace-scoped access to your data. Setup guide →
Power BI
Microsoft's BI tool with a native BigQuery connector. Supports direct query and scheduled refresh. Setup guide →
Data Studio
Free Google BI tool with native BigQuery support. One-click connection to your Kaivo warehouse; great for SMB teams on Google Workspace. Setup guide →
Tableau
The premium analytics standard, with native BigQuery integration. Setup guide →
Google Sheets
Use Connected Sheets to query BigQuery directly from a spreadsheet, with no SQL. Setup guide →
Excel
Connect via Power Query's BigQuery connector. Setup guide →
Metabase
Open-source BI tool with strong BigQuery support. Setup guide →
See our pricing page for Chameleon connector pricing and plan details.
Related connectors
- Google Ads: Sync Google Ads to BigQuery.
- Custobar: Sync Custobar to BigQuery.
- Google Search Console: Sync Google Search Console to BigQuery.
- HubSpot: Sync HubSpot to BigQuery.
- Adform: Sync Adform to BigQuery.
- Amplitude: Sync Amplitude to BigQuery.
Was this helpful?
Still need help? Share an idea