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

# Segment

<Info>
  **Note**

  This feature is currently available in beta. Some specifications may change as we stabilize the service.
</Info>

## Integration with Segment

Airbridge supports integration with Segment. Before setting up the integration, complete the app event setup in Segment following [this guide from Segment](https://segment.com/docs/connections/sources/). The integration setup consists of the following steps.

1. [Map Segment events to Airbridge events](/en/guides/segment#map-segment-events-to-airbridge-events)
2. [Copy the information for webhook setup from Airbridge](/en/guides/segment#copy-the-information-for-webhook-setup-from-airbridge)
3. [Configure webhooks in Segment](/en/guides/segment#configure-webhooks-in-segment)

### Map Segment events to Airbridge events

1. Navigate to \[Integrations]>\[Third-party Integrations] from the sidebar menu and select “Segment”.

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/-repzD1gAeBlf4wV/asset/image/segment-integration-card-highlighted.png?fit=max&auto=format&n=-repzD1gAeBlf4wV&q=85&s=ee3b1d3b5f3078291e32830de3da034a" alt="01-en-segment" width="1400" height="800" data-path="asset/image/segment-integration-card-highlighted.png" />
</Frame>

2. Click the “Add Event” button in section 1.

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/TSHroCAqTCSq5FpG/asset/image/webhook-mapping-object-batching.png?fit=max&auto=format&n=TSHroCAqTCSq5FpG&q=85&s=b59f2ea424a7ea7d423553eb1a56067a" alt="02-en-segment" width="1400" height="800" data-path="asset/image/webhook-mapping-object-batching.png" />
</Frame>

3. Enter the Segment event name. The event name is sensitive to casing and blank spaces.

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/jbQGnhL6LTf4bTuy/asset/image/event-mapping-segment-validation.png?fit=max&auto=format&n=jbQGnhL6LTf4bTuy&q=85&s=8144661a14c6b5a78d3457ff3ebca359" alt="03-en-segment" width="1400" height="800" data-path="asset/image/event-mapping-segment-validation.png" />
</Frame>

<Danger>
  **Caution**

  Double-check whether the Segment event names are entered correctly. If you enter a Segment event name wrong, that particular event won’t be displayed in your Airbridge reports.
</Danger>

4. Select the Airbridge event you want to map with the Segment event from the drop-down menu. You can select from the Airbridge standard events or create a custom event by entering a freeform value.

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/jbQGnhL6LTf4bTuy/asset/image/event-mapping-standard-events.png?fit=max&auto=format&n=jbQGnhL6LTf4bTuy&q=85&s=38ffbe2764b576141a503052af666293" alt="04-en-segment" width="1400" height="800" data-path="asset/image/event-mapping-standard-events.png" />
</Frame>

### Copy the information for webhook setup from Airbridge

The following information from Airbridge must be provided to Segment to set up webhooks.

* Webhook URL
* Shared Secret Key

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/TSHroCAqTCSq5FpG/asset/image/webhook-url-shared-secret.png?fit=max&auto=format&n=TSHroCAqTCSq5FpG&q=85&s=1b89f89c305e3b781a89bf594b436064" alt="05-en-segment" width="1400" height="800" data-path="asset/image/webhook-url-shared-secret.png" />
</Frame>

### Configure webhooks in Segment

#### Enter Shared Secret Key

1. Navigate to \[Connections]>\[Destinations] in Segment and click the "Add Destination" button.

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/-repzD1gAeBlf4wV/asset/image/segment-webhooks-destinations-list.png?fit=max&auto=format&n=-repzD1gAeBlf4wV&q=85&s=a24150b4fbae246f17b2495684230573" alt="06-en-segment" width="1400" height="800" data-path="asset/image/segment-webhooks-destinations-list.png" />
</Frame>

2. Search for "webhooks" in the top left search bar. Select "Webhooks (Actions)" from the search results.

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/-repzD1gAeBlf4wV/asset/image/segment-webhook-destination-search.png?fit=max&auto=format&n=-repzD1gAeBlf4wV&q=85&s=09f89f5909c1f42d2293d960c09551ad" alt="07-en-segment" width="1400" height="800" data-path="asset/image/segment-webhook-destination-search.png" />
</Frame>

3. Click the "Configure Webhooks (Actions)" button.

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/-repzD1gAeBlf4wV/asset/image/segment-webhooks-actions-catalog.png?fit=max&auto=format&n=-repzD1gAeBlf4wV&q=85&s=58f195cc98002c5751e906c542099183" alt="08-en-segment" width="1400" height="800" data-path="asset/image/segment-webhooks-actions-catalog.png" />
</Frame>

4. Select the data source you want to integrate with Airbridge and click the "Next" button.

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/-repzD1gAeBlf4wV/asset/image/segment-webhooks-data-source.png?fit=max&auto=format&n=-repzD1gAeBlf4wV&q=85&s=2616abccb75675397f7be584dd760530" alt="09-en-segment" width="1400" height="800" data-path="asset/image/segment-webhooks-data-source.png" />
</Frame>

5. Enter the destination name and select "Fill in settings manually" from the destination setup drop-down list. Then, set up the destination.

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/-repzD1gAeBlf4wV/asset/image/segment-destination-manual-settings.png?fit=max&auto=format&n=-repzD1gAeBlf4wV&q=85&s=e94810b69d1e6eff4ea9cf2a8137dd9e" alt="10-en-segment" width="1400" height="800" data-path="asset/image/segment-destination-manual-settings.png" />
</Frame>

6. Navigate to \[Settings]>\[Basic Settings] and paste the Shared Secret Key you copied from [the Airbridge dashboard into the Shared Secret field](/en/guides/segment#copy-the-information-for-webhook-setup-from-airbridge).

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/-repzD1gAeBlf4wV/asset/image/segment-webhooks-shared-secret.png?fit=max&auto=format&n=-repzD1gAeBlf4wV&q=85&s=68019142ccab10d1b73bfceea671f8c4" alt="11-en-segment" width="1400" height="800" data-path="asset/image/segment-webhooks-shared-secret.png" />
</Frame>

#### Configure Segment event sending settings

1. From the \[Mappings] page, click the "+ New Mapping" button.

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/-repzD1gAeBlf4wV/asset/image/segment-webhooks-mappings-empty.png?fit=max&auto=format&n=-repzD1gAeBlf4wV&q=85&s=2ee66d6a75e98e145b63f01ab0a5f8f0" alt="12-en-segment" width="1400" height="800" data-path="asset/image/segment-webhooks-mappings-empty.png" />
</Frame>

2. Select "Send".

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/-repzD1gAeBlf4wV/asset/image/segment-webhooks-http-request.png?fit=max&auto=format&n=-repzD1gAeBlf4wV&q=85&s=f23aaa322c3c73f32ef1d9ac35bcd295" alt="13-en-segment" width="1400" height="800" data-path="asset/image/segment-webhooks-http-request.png" />
</Frame>

3. Select events to map and send. Click “Add Condition” to add more events. To send all events, click “all” to change it to “any”. For more details, follow [this guide from Segment](https://segment.com/docs/connections/destinations/catalog/actions-webhook/).

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/-repzD1gAeBlf4wV/asset/image/segment-webhooks-condition-builder.png?fit=max&auto=format&n=-repzD1gAeBlf4wV&q=85&s=5537f42a1a0365e51d6a6bba3c1d84b2" alt="14-en-segment" width="1400" height="800" data-path="asset/image/segment-webhooks-condition-builder.png" />
</Frame>

4. In the “Add test event” section, click “Load Test Event from Source” and get a preview of the test event.

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/-repzD1gAeBlf4wV/asset/image/segment-webhooks-test-event.png?fit=max&auto=format&n=-repzD1gAeBlf4wV&q=85&s=0d3a95b473b415bfd78864b7535ded55" alt="15-en-segment" width="1400" height="800" data-path="asset/image/segment-webhooks-test-event.png" />
</Frame>

5. In the “Select mappings” section, paste the webhook URL into the URL field. You can copy the [webhook URL from the Airbridge dashboard](/en/guides/segment#copy-the-information-for-webhook-setup-from-airbridge). No other changes are needed here.

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/-repzD1gAeBlf4wV/asset/image/segment-webhook-select-mappings.png?fit=max&auto=format&n=-repzD1gAeBlf4wV&q=85&s=b3806a111f038b5604c52cccef453593" alt="16-en-segment" width="1400" height="800" data-path="asset/image/segment-webhook-select-mappings.png" />
</Frame>

6. From the “Select Object” drop-down list, select “The entire event”. Select “No” for “Enable Batching?”.

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/-repzD1gAeBlf4wV/asset/image/segment-webhook-mapping-fields.png?fit=max&auto=format&n=-repzD1gAeBlf4wV&q=85&s=c7ee0501e42371cc214a6e69e3571560" alt="17-en-segment" width="1400" height="800" data-path="asset/image/segment-webhook-mapping-fields.png" />
</Frame>

7. In the “Send test event” section, click the “Test Mapping” button to check whether the Segment events are successfully sent to Airbridge. Once the above steps are completed, you can view the history of data sent from Segment to Airbridge in [the “Real-time Log” menu in Airbridge](/en/guides/tracking-events-with-real-time-logs).

## How to view data

Once the integration is complete, the Segment events can be viewed in the Airbridge reports when selecting standard events or custom events that are mapped to the Segment events as your report metric.

## Caution

**Double-check Segment event names**

If you enter a Segment event name wrong when mapping it to an Airbridge event, that particular event won’t be tracked in your Airbridge reports. The names are sensitive to casing and blank spaces.

**Segment webhook setup**

Some Segment events may not be properly mapped to Airbridge events under certain settings. Contact your CSM before starting with the integration.

<link rel="alternate" hrefLang="en" href="https://help.airbridge.io/en/guides/segment" />

<link rel="alternate" hrefLang="ko" href="https://help.airbridge.io/ko/guides/segment" />
