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

# Audience - Lobyco Segmentation

> Lobyco segmentation and customer audiences.

Understanding Audience Service and the Lobyco centralised segmentation

Audiences is the defined subset of your customers that you want to target your communication, loyalty or promotional campaign to. Lobyco allows to import your own audiences or create your own from the Lobyco Segmentation area.

These customer audiences can be then used in the different Lobyco activities: promotional or communications. For example you can target a subset of your customers with a Wheel of fortune game in their mobile apps.

Lobyco products offer personalisation, enabling marketers to easily manage audiences in the Lobyco Admin portal. Audiences can be managed in the Lobyco Admin Portal in a centralised Audience admin - configured audiences can be named, described and hereafter reused in the list of products enabled in the Lobyco Admin Portal.

<img src="https://mintcdn.com/lobyco-4c9fb3ad/wpdZgjvGMgh4Gbhy/images/3b28b4bbe00f96d4010c7b368a38dd0b36a42e34.png?fit=max&auto=format&n=wpdZgjvGMgh4Gbhy&q=85&s=357c5a8fcec22d002c056e42372dfae5" alt="" width="1893" height="898" data-path="images/3b28b4bbe00f96d4010c7b368a38dd0b36a42e34.png" />

The Lobyco Admin Portal feeds the created and updated audiences to all Lobyco products that you have as part of your program with Lobyco.

Retailers manage their audiences in two ways in the Lobyco Admin Portal - these options are presented in the visualisation below.

## By Integration

A retailer integrate to Lobyco Audience service creating and updating a list of audiences dynamically. The retailer prefer to have their audiences in an existing platform and rather want to feed this data to the Lobyco Admin Portal for their marketers to choose from. Every operation is documented in the [Audience API reference](/api-reference/audience/audiences).

### Audience creation from CSV files via `Audience DataImport API`

<Steps>
  <Step>
    ## Upload each CSV file

    [`POST /v1/upload`](/api-reference/audience/csv-import/post-v1-upload) — send one CSV file of customer IDs as `multipart/form-data`. The response gives you the URI to reference in the next step, so call it once per file.
  </Step>

  <Step>
    ## Schedule an import job

    [`POST /v1/import`](/api-reference/audience/csv-import/post-v1-import) — pass the uploaded files in the `dataURIs` field to create a new audience from them, or [`PUT /v1/import`](/api-reference/audience/csv-import/put-v1-import) to add them to an audience that already exists. Both return an `executionId`.
  </Step>

  <Step>
    ## Check import status

    [`GET /v1/import/{executionId}/status`](/api-reference/audience/csv-import/get-v1-import-executionid-status) — track the execution using the `executionId` from the previous step.
  </Step>
</Steps>

### Audience import from the customer's system via `Audience API`

<Steps>
  <Step>
    ## Generate the header for a new audience

    [`POST /v1/audiences`](/api-reference/audience/audiences/post-v1-audiences) — generate the header for a new audience (name, description, etc.)
  </Step>

  <Step>
    ## Add or remove customers in an audience

    [`PATCH /v1/audiences/{audienceId}/customers`](/api-reference/audience/audiences/patch-v1-audiences-audienceid-customers) — add or remove customers in an audience
  </Step>
</Steps>

## Manage in Lobyco Admin Portal

Create, update and keep your audiences in the Lobyco Admin Portal. Marketers can use the Lobyco Admin Portal to define the audiences they want to use across Lobyco products. The marketeers can create audiences with a *Name*, *Destination* (product of use i.e. Games), *Description* of the audience, Upload CSV file with *customerIDs*.

<img src="https://mintcdn.com/lobyco-4c9fb3ad/wpdZgjvGMgh4Gbhy/images/3e4cff231f556fd7230c4ccbd4267861c609b042.png?fit=max&auto=format&n=wpdZgjvGMgh4Gbhy&q=85&s=77b945946f3ab67f0d7470c774c7d8dc" alt="" width="907" height="670" data-path="images/3e4cff231f556fd7230c4ccbd4267861c609b042.png" />