# GWEN (Actions) Destination

## Destination Info

* Accepts [Page](/docs/segment/connections/spec/page), [Alias](/docs/segment/connections/spec/alias), [Group](/docs/segment/connections/spec/group), [Identify](/docs/segment/connections/spec/identify), [Track](/docs/segment/connections/spec/track) calls.
* Refer to it as **GWEN (Actions)** in the [Integrations object.](/docs/segment/guides/filtering-data/#filtering-with-the-integrations-object)
* This integration is **partner owned.** Please reach out to the partner's support for any issues.
* This destination is **Beta.**

[GWEN](https://gwenplatform.com/?utm_source=segmentio\&utm_medium=docs\&utm_campaign=partners) offers powerful gamification tools and insights to convert, engage, and retain users. With GWEN it has never been easier to understand your users behavior patterns and build better performing products with both speed and accuracy.

This destination is maintained by Insert Coin AB. For any issues with the destination, [contact their Support team](mailto:support@gwenplatform.com).

## Getting started

1. From the Segment web app, click **Catalog**, then click **Destinations**.
2. Search for "GWEN" and select **GWEN (Actions)**
3. Find the Destinations item in the left navigation, and click it.
4. Click **Configure GWEN (Actions)** and select an existing Source to connect to GWEN (Actions).
5. Enter the following Basic Settings:

* **Name**: A name to help you identify this destination in Segment.
* **API Key**: Created under ["IAM & Billing" > "API Tokens"](https://app.gwenplatform.com/iam/api-token) in the GWEN Admin App

## Send events to GWEN

A GWEN event consists of two properties, a `type` and a `data` attribute.

By Default, this destination maps the Segment event type (for example, track or identify) to the `type` of the GWEN event being sent, and the Segment `properties` object to the GWEN `data` attribute. You can modify this configuration to futher customize the events you send to GWEN.

You can read more about [Event Reporting here](https://app.gwenplatform.com/docs/event-reporting).

## Destination Settings

| Field   | Description                                                                                   | Required | Type     |
| ------- | --------------------------------------------------------------------------------------------- | -------- | -------- |
| API Key | GWEN API key. Can be found \[here]\(http://gwen.insertcoin.se/iam/api-token) (login required) | Yes      | password |

## Available Presets

GWEN (Actions) has the following presets

| Preset Name           | Trigger                 | Default Action |
| --------------------- | ----------------------- | -------------- |
| Identify a user       | Event type = "identify" | Identify User  |
| Send an event to GWEN | Event type = "track"    | Send Event     |

## Available Actions

Build your own Mappings. Combine supported [triggers](/docs/segment/connections/destinations/actions/#components-of-a-destination-action) with the following GWEN-supported actions:

> \[!NOTE]
>
> Individual destination instances have support a maximum of 50 mappings.

* [Send Event](#send-event-2)
* [Identify User](#identify-user-17)

### Send Event

Send a user event to GWEN

Send Event is a **Cloud** action. The default Trigger is `type = "track"`

| Field      | Description                                                   | Required | Type   |
| ---------- | ------------------------------------------------------------- | -------- | ------ |
| User ID    | The user's id. (Format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx) | Yes      | STRING |
| Event Type | The type of the event                                         | Yes      | STRING |
| Data       | The data to be sent to GWEN                                   | No       | OBJECT |

### Identify User

Starts a new GWEN user session. Provide the users IP and userAgent to improve the GWEN experience

Identify User is a **Cloud** action. The default Trigger is `type = "identify"`

| Field           | Description                                                   | Required | Type   |
| --------------- | ------------------------------------------------------------- | -------- | ------ |
| User ID         | The user's id. (Format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx) | Yes      | STRING |
| User IP Address | The IP address of the user                                    | No       | STRING |
| User Agent      | The userAgent string of the user                              | No       | STRING |
