# Segment

Connect Segment with Blitzllama to use push user attributes and cohorts from your existing tools to precisely target users through Blitzllama and generate powerful insights.

{% hint style="warning" %}
Segment integration is in beta. Please reach out to us over the support chat on Blitzllama's dashboard to whitelist your account.
{% endhint %}

### Supported Capabilities

* We support Segment's Identify and Group calls.
* Segment's Identify and Groups calls are the equivalent of attributes and cohorts in Blitzllama.

### Connecting Segment to Blitzllama

1. Navigate to the Destination page inside Segment's Catalog tab.
2. Search for Blitzllama, click on the card to land on the Blitzllama's Catalog page
3. Select the data sources to send to Blitzllama destination
4. Get the API key within Blitzllama's dashboard: navigate to the Connections tab, search for Segment, click on the card to find and copy the API key.

### Data Mapping 

#### Segment - Identify 

Every single `traits` in Segment maps to single `Attributes` in Blitzllama. Use `Attributes` to identify users in Blitzllama. An example Identify call will look like this: 

```
analytics.identify('97980cfea0067', {
  city: 'Bangalore',
  plan: 'premium',
  name: 'Peter Gibbons',
  logins: '5',
  email: 'peter@example.com',
});
```

For more information, refer to Segment Spec documentation - [Identify](https://segment.com/docs/connections/spec/identify/)

On Blitzllama's dashboard, the corresponding data can be found in the `Preview` section in the `Cohorts` tab.

![](https://713176431-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MagfF5JPg-8vm99iTd9%2Fuploads%2F3HeQR1q6F5fcU1Dt7mwZ%2Fimage.png?alt=media\&token=327304c3-2a9d-4fbb-9c1f-203d69096aed)

#### Segment - Group

`Group` in Segment map to `Cohorts` in Blitzllama. Use `Groups` to seamlessly sync cohorts to Blitzllama. An example `Group` call will look like this: 

```
analytics.group("0e8c78ea9d97a7b8185e8632", {
  name: "Initech",
  industry: "Technology",
  employees: 329,
  plan: "enterprise",
  "total billed": 830
});
```

For more information, refer to Segment Spec documentation - [Groups](https://segment.com/docs/connections/spec/group/)

The synced Segment's Groups will be available on the `Cohorts` tab on Blitzllama's dashboard.

![](https://713176431-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MagfF5JPg-8vm99iTd9%2Fuploads%2FqEsHVePiF0jjP6Ypya3m%2Fimage.png?alt=media\&token=3b298d07-1868-4e06-9e53-9f5da594bd16)

{% hint style="info" %}
Blitzllama accepts unlimited user attributes and will auto accept all user traits from Segment's Identify call.
{% endhint %}

{% hint style="info" %}
Blitzllama accepts unlimited user cohorts and will auto accept all user groups from Segment's Group call.
{% endhint %}

In case you are stuck at any of the above steps, please don't hesitate to email us at <tech@blitzllama.com> or hit us up on the support chat.