# Quickstart Guide to Bonsai

Welcome to Bonsai. This overview is designed to help you quickly understand **what Bonsai does**, **what data you need**, and **how to get live in the platform** as fast as possible.

Whether you are onboarding for Business Reporting, Multi-Touch Attribution (MTA), Incrementality, or Algorithms—your first step is always the same: **connect your data sources** so Bonsai can build a trusted measurement foundation.

***

## What Bonsai Helps You Do

Bonsai is a measurement and optimization platform that unifies marketing and business data to help teams:

* Understand what is driving revenue and customer growth
* Measure marketing performance across digital and offline channels
* Attribute outcomes across touchpoints (not last-click)
* Quantify true causal lift with incrementality modeling and testing
* Optimize marketing spend and bidding using algorithms trained on attributed buyers

***

## What You Need Before You Start

To ensure a smooth onboarding, we recommend having the following ready:

* Admin access (or credentials) for your marketing and analytics platforms
* A primary business system source of truth (POS / ecommerce / CRM)
* A clear reporting definition for core KPIs (e.g., revenue, orders, new customers)
* A point of contact from your marketing and/or data team for validation

***

## Get Up and Running

#### 1. Connect your data sources

Bonsai uses secure integrations (“Connect Cards”) to ingest data from platforms such as:

* Digital marketing (Google Ads, Meta, TikTok, Amazon, etc.)
* Analytics (GA4, Adobe Analytics)
* Business systems (POS / ecommerce / CRM / order management)
* Offline media (TV/OOH spend and delivery)
* Google Search Console (for branded demand insights)

Once connected, data will flow automatically into your Bonsai cloud data warehouse.

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><strong>Connect to Bonsai</strong></td><td>Securely connect your sources and destinations. Start here if you’re new to Bonsai.</td><td><a href="/spaces/wBudqXqxQ4IAeXerm1Hd/pages/fNrakZOyICFwM3wLlXsr">/spaces/wBudqXqxQ4IAeXerm1Hd/pages/fNrakZOyICFwM3wLlXsr</a></td><td></td></tr><tr><td><strong>Review the Data Schema</strong></td><td>Understand required fields for business data onboarding.</td><td><a href="/spaces/wBudqXqxQ4IAeXerm1Hd/pages/05hFMMSmegwiqdpVcCS2">/spaces/wBudqXqxQ4IAeXerm1Hd/pages/05hFMMSmegwiqdpVcCS2</a></td><td></td></tr><tr><td><strong>Understanding Analytics</strong></td><td>Read how we use analytics data for marketing attribution.</td><td><a href="/spaces/wBudqXqxQ4IAeXerm1Hd/pages/YxwcdYWW1iWwNk3Xhc0c">/spaces/wBudqXqxQ4IAeXerm1Hd/pages/YxwcdYWW1iWwNk3Xhc0c</a></td><td></td></tr></tbody></table>

#### 2. Configure your business KPIs

Business Reporting is the foundation for everything in Bonsai.

During onboarding, Bonsai works with your team to define and configure:

* Revenue and order KPIs
* New vs returning customer logic
* Custom business metrics (LTV, repeat rate, frequency)
* Aggregation rules and date definitions

#### 3. Validate the data

Before launching measurement views, Bonsai runs a validation process to confirm:

* data completeness (missing days, gaps)
* schema and formatting consistency
* correct KPI definitions and mappings
* reconciliation against your source of truth (when available)

#### 4. Launch measurement products

Once onboarding is complete, you can begin using Bonsai measurement views:

* **Business Reporting**: Executive-ready reporting on business outcomes + marketing investment
* **Multi-Touch Attribution (MTA)**: Customer journeys + fractional credit across digital touchpoints
* **Incrementality (Modeling + Testing)**: Causal lift and ROI measurement across channels
* **Budget Planner**: Forecast outcomes and optimize spend allocation
* **Algorithms**: AI-driven bidding optimization trained on attributed buyer behavio

***

## Explore the APIs

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><strong>Developer Docs</strong></td><td>One place for endpoints, parameters, and examples for every Bonsai API.</td><td><a href="/spaces/Sc7oU2m62deMCHXGIJKu/pages/p8zOUIttlCmwYA3prGmI">/spaces/Sc7oU2m62deMCHXGIJKu/pages/p8zOUIttlCmwYA3prGmI</a></td><td></td></tr><tr><td><strong>Multi-Touch Attribution API</strong></td><td>Journey and touchpoint endpoints plus fractional attribution metrics.</td><td><a href="/spaces/Sc7oU2m62deMCHXGIJKu/pages/stvnulWRkO3p2f1rpf5q">/spaces/Sc7oU2m62deMCHXGIJKu/pages/stvnulWRkO3p2f1rpf5q</a></td><td></td></tr><tr><td><strong>Business Reporting API</strong></td><td>Spend, impressions, DMA/time dimensions, and modeled business results.</td><td><a href="/spaces/Sc7oU2m62deMCHXGIJKu/pages/GshoR3fXHCmIEwsxwUpK">/spaces/Sc7oU2m62deMCHXGIJKu/pages/GshoR3fXHCmIEwsxwUpK</a></td><td></td></tr><tr><td><strong>Audience Analytics API</strong></td><td>Create, list, and retrieve audiences for activation.</td><td><a href="/spaces/Sc7oU2m62deMCHXGIJKu/pages/86M9TzCkXoWIIc893Qtw">/spaces/Sc7oU2m62deMCHXGIJKu/pages/86M9TzCkXoWIIc893Qtw</a></td><td></td></tr><tr><td><strong>Incrementality Modeling API</strong></td><td>Modeled ROI, lift, and forecast curve data for incrementality modeling.</td><td><a href="/spaces/Sc7oU2m62deMCHXGIJKu/pages/usp9RvcNrYYQ0ZU1dY6m">/spaces/Sc7oU2m62deMCHXGIJKu/pages/usp9RvcNrYYQ0ZU1dY6m</a></td><td></td></tr></tbody></table>

## Help & Resources

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><strong>Resources Overview</strong></td><td>A guided index of external resources for marketers and analysts.</td><td><a href="/spaces/wBudqXqxQ4IAeXerm1Hd/pages/kSr1AxMCbdU8tdBcnlox">/spaces/wBudqXqxQ4IAeXerm1Hd/pages/kSr1AxMCbdU8tdBcnlox</a></td><td></td></tr><tr><td><strong>FAQs</strong></td><td>Answers to common setup, authentication, platform logic, and data questions.</td><td><a href="/spaces/wBudqXqxQ4IAeXerm1Hd/pages/HOwfjP3HVYAPGtcjtumv">/spaces/wBudqXqxQ4IAeXerm1Hd/pages/HOwfjP3HVYAPGtcjtumv</a></td><td></td></tr><tr><td><strong>Troubleshooting</strong></td><td>Common errors and how to fix them quickly.</td><td><a href="/spaces/Sc7oU2m62deMCHXGIJKu/pages/uLlvtureI5giOFxW87qf">/spaces/Sc7oU2m62deMCHXGIJKu/pages/uLlvtureI5giOFxW87qf</a></td><td></td></tr><tr><td><strong>Release Notes</strong></td><td>What’s new in the APIs and documentation.</td><td><a href="/spaces/Sc7oU2m62deMCHXGIJKu/pages/vwzsFN7kGvfwkSq0Pbl8">/spaces/Sc7oU2m62deMCHXGIJKu/pages/vwzsFN7kGvfwkSq0Pbl8</a></td><td></td></tr></tbody></table>

{% hint style="success" %}
Pro tip: Bookmark the **Developer Docs** index for quick navigation across all API references.
{% endhint %}


---

# 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://documentation.bonsaidata.io/getting-started/readme.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.