> For the complete documentation index, see [llms.txt](https://developers-apps-in-toss.toss.im/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers-apps-in-toss.toss.im/guide/en/marketing/intro.md).

# Segment

Segments are a feature in the Apps in Toss console that lets you create and manage user groups that match specific conditions. You use it when you want to send messages only to specific users, such as for marketing or sending notifications.

***

### What are the benefits of using segments?

* You can target precisely. You can send messages only to users who match the conditions you want.
* You can do data-driven marketing. You can design campaigns based on users' behavior and characteristics.
* You can improve the user experience. By providing personalized messages, you can increase engagement and satisfaction.

**Condition categories provided**

You can combine conditions from four categories: transaction information, user information, user activity, and user profile.

* **Transaction information** — Information related to users' actual transactions, such as the brand in transaction history, ad category, and whether Toss Pay was used.
* **User information** — Basic user attributes such as age, gender, credit score, app version, and carrier.
* **User activity** — Based on activity history within the app. Not mini app login **access criteria**can only be set.
* **User profile** — Information that comprehensively analyzes a user, such as financial tendencies, lifecycle stage, and inferred interests.

<figure><img src="https://941686070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8pQgXiR5QAzduV54W8Om%2Fuploads%2FRW9lgK4SkQ0sFStOF1W4%2Fimage.png?alt=media&amp;token=34d7ecaa-e614-422e-aafc-fee5c49ca8f4" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Please note**

* You can combine multiple conditions **with AND or OR conditions**and use them together.
* If you use target sampling, you can adjust the number of users included in the segment.
* Even if you delete a segment you created, you cannot create another segment with the same name again.
  {% endhint %}

***

### Set up in the console

**1. Create a segment**

Go to the Segment menu and **+Create** press the button.

* How to access: Apps in Toss console → Select workspace → Select mini app → Left menu 'Segment'

<figure><img src="https://941686070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8pQgXiR5QAzduV54W8Om%2Fuploads%2FzQroDTVArcKwNawySJa5%2Fimage.png?alt=media&amp;token=767fd26f-ff36-45ec-9e16-920d512bad34" alt=""><figcaption></figcaption></figure>

<figure><img src="https://941686070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8pQgXiR5QAzduV54W8Om%2Fuploads%2FE4eS4mzvSVBc4wgO4KYc%2Fimage.png?alt=media&amp;token=09207478-7a65-4067-88bb-b54271e92a5d" alt=""><figcaption></figcaption></figure>

**2. Set category and conditions**

Select the desired category and subconditions **'Add'** and it will be added to the right **'Selected segments'** screen.

* If there is only one condition, you can save it right away by pressing **'Save'** .
* To use multiple conditions together, add all the desired segments and then **'AND'** or **'OR'** set the condition.
* Some segments that require prediction need accuracy settings.
  * Increasing accuracy may reduce the segment size (population).
  * If population size is important, you can lower the accuracy. However, targeting accuracy may decrease.
  * For general use, set it to 50% or higher.

{% hint style="info" %}
**Example — If you want to send a message to 'someone who lives in Seoul and seems to own their home'?**

1. User information → Region → Select Seoul and then 'Add'
2. Press 'Home' to return to the initial category list
3. User profile → Homeownership\_All → Set accuracy and then 'Add'
4. In the right-side 'Selected segments' **'AND'** Select
   * If you want to send to someone who lives in Seoul or seems to own their home **'OR'** Select condition
     {% endhint %}

<figure><img src="https://941686070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8pQgXiR5QAzduV54W8Om%2Fuploads%2Fz2pim1YANBYZsnSkPS3q%2Fimage.png?alt=media&amp;token=f0091b35-ec88-4b47-8342-7e06e88d5279" alt=""><figcaption></figcaption></figure>

<figure><img src="https://941686070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8pQgXiR5QAzduV54W8Om%2Fuploads%2FLd0htSyjrsO35m8uZFyH%2Fimage.png?alt=media&amp;token=be09fec3-58b7-4244-8ed5-42c0465b53bb" alt=""><figcaption></figcaption></figure>

<figure><img src="https://941686070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8pQgXiR5QAzduV54W8Om%2Fuploads%2F0hoxtkMch9INj0SXlCeF%2Fimage.png?alt=media&amp;token=799c8696-2612-4e77-ae67-e7d6cbda4b37" alt=""><figcaption></figcaption></figure>

If you select AND or OR conditions, the segments are merged into one and changed to the number of people matching those conditions.

* **Undo** — They are separated back into their individual segments.
* **Save** — Saved as a merged segment with conditions combined.

<figure><img src="https://941686070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8pQgXiR5QAzduV54W8Om%2Fuploads%2FK4jxnzbRXp13wBg0wvOM%2Fimage.png?alt=media&amp;token=889455f2-f971-45fa-913a-e67b305a0f3b" alt=""><figcaption></figcaption></figure>

**3. Save**

After pressing Save, you can set the segment name, description, favorites, and pinning status.

<figure><img src="https://941686070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8pQgXiR5QAzduV54W8Om%2Fuploads%2FvoJ1qGdlCmZAZpwXy2VY%2Fimage.png?alt=media&amp;token=44e8175a-8781-4b23-b487-962cc85ce01c" alt=""><figcaption></figcaption></figure>

* **Segment name** — The name of the added segment is entered automatically. You can freely change it to the name you want. However, after deletion, the same name cannot be used again.
* **Segment description** — Please write why you built this segment or any management notes.
* **Favorites** — When set, it can be used immediately in push, notifications, and smart sending.
* **Save as fixed population** — You can use the population as fixed at the time of saving. In this case, the population will not be updated, so please choose according to your purpose.

After saving is complete, you can immediately view and use it in the Segment menu, Push, Notifications, and Smart Send.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developers-apps-in-toss.toss.im/guide/en/marketing/intro.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
