> ## Documentation Index
> Fetch the complete documentation index at: https://docs.guidewhale.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Customer.io

> Send GuideWhale events and user property changes to Customer.io for shared insights into user behavior and content engagement.

This integration allows you to send one-way events from GuideWhale content interactions (such as guide views, completions, and checklist usage) to Customer.io for advanced tracking and reporting. Alongside events, GuideWhale can also send any user property changes to be used for email automation.

<Note>All user events pushed to 3rd party platforms are prefixed with `gw_` to easily differentiate GuideWhale from other event sources.</Note>

## Use Cases

* Leverage user events and user properties to target and personalize email campaigns.
* Nudge users to try out new features if they have not used them yet.
* Track how users are interacting with your in-app guides, checklists, and banners and compare that to how they are interacting with your website.

## Requirements

* Installed GuideWhale Javascript SDK
* Installed Customer.io Javascript SDK
* Enabled integration in GuideWhale dashboard settings

## How It Works

* GuideWhale SDK will fetch the integration settings from our dashboard when a user is identified.
* When a new GuideWhale event is tracked, we first check if event pushing is enabled and if the event belongs to an enabled group of events.
* After that we try pushing the event to Customer.io using your installed Javascript SDK if it is available.
* If we detect that user has an installed ad blocker, events will be pushed through the Customer.io API instead to make sure events are always delivered.

## Configuration

1. Navigate to <a href="https://app.guidewhale.com?to=/settings/integrations" target="_blank">Settings > Integrations </a>.
2. Before enabling any outbound events or user property syncing, make sure to first configure your Customer.io `Site ID` and `API Key`.
3. Your `Site ID` and `API Key` can be found in Customer.io under <a href="https://fly.customer.io/settings/api_credentials?keyType=tracking" target="_blank"> Account Settings > API Credentials > Tracking API Keys</a>.
   <Note>Make sure to use the Tracking API key and not the App API key.</Note>

<Frame>
  <img src="https://mintcdn.com/guidewhale/LI-FkgRC3KwqZtjk/integrations/native/images/customerio-integration-api.png?fit=max&auto=format&n=LI-FkgRC3KwqZtjk&q=85&s=0544817b9566f1b204ef9b2e2f7d2a57" alt="Customer.io API key configuration" width="1262" height="438" data-path="integrations/native/images/customerio-integration-api.png" />
</Frame>

## Event Configuration

1. Here you can toggle which event types you want GuideWhale to send to Customer.io.
2. Once enabled, users will start pushing GuideWhale events to Customer.io.

<Frame>
  <img src="https://mintcdn.com/guidewhale/VFcK6H7hHJMFKtll/integrations/native/images/customerio-integration.png?fit=max&auto=format&n=VFcK6H7hHJMFKtll&q=85&s=76ccc8dbdd2939a3ae179abe2250ffa2" alt="Customer.io integration configuration" width="667" height="725" data-path="integrations/native/images/customerio-integration.png" />
</Frame>

## User Property Mapping

1. In the `Outbound` tab you can enable user property pushing.
2. In the `User Properties` tab you can map GuideWhale user properties to Customer.io user attributes.
3. Once enabled, users will start pushing mapped GuideWhale user property changes to Customer.io.

<Frame>
  <img src="https://mintcdn.com/guidewhale/q7WxluvQ3ik7Ob6e/integrations/native/images/customerio-integration-map.png?fit=max&auto=format&n=q7WxluvQ3ik7Ob6e&q=85&s=a662da746f2e253aad164cb56283d4da" alt="Customer.io integration user property map" width="665" height="542" data-path="integrations/native/images/customerio-integration-map.png" />
</Frame>