> For the complete documentation index, see [llms.txt](https://docs.dfinery.ai/user-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dfinery.ai/user-guide/en/customer/audience.md).

# Audience

## **What is an audience?**

Audience refers to a group of customer data grouped according to certain criteria. For example, you <kbd><mark style="color:blue;background-color:blue;">Users who signed up in February<mark style="color:blue;background-color:blue;"></kbd> can create a specific audience called and conduct CRM marketing targeting that audience. [<mark style="color:purple;">Data linking</mark>](https://dfinery.gitbook.io/user-guide/v/ko/readme/event) is essential for audience creation and utilization.

## **Examples of audience usage**

* <kbd><mark style="background-color:purple;">Customers who purchased product A at least once in the past n days<mark style="background-color:purple;"></kbd>&#x20;

  <figure><img src="/files/ad01V38oju9dVG7Zvyxs" alt=""><figcaption></figcaption></figure>
* <kbd><mark style="background-color:purple;">Customers with a Diamond membership level<mark style="background-color:purple;"></kbd>

  <figure><img src="/files/0WfkhiAWSoY0iSlTvUw3" alt=""><figcaption></figcaption></figure>

## **Create an audience**

Click the **'+ Create Audience' button.**

<figure><img src="/files/ruEclDjDCsD7XuvOq2HQ" alt=""><figcaption></figcaption></figure>

## **Group settings**

1. Click the '+ Add' button on the right.<br>

   <figure><img src="/files/1FVlHinaG3KehAkQ903U" alt=""><figcaption></figcaption></figure>
2. Select events or user profiles in the filter conditions.<br>

   <figure><img src="/files/RGRblxD68nWIeqcrf6Sr" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="129">Division</th><th width="159">Detailed filter conditions</th><th>Explanation</th></tr></thead><tbody><tr><td><strong>Event</strong></td><td>-</td><td>Filter by all or all active events and standard and custom events</td></tr><tr><td><strong>User Profile</strong></td><td>User properties</td><td>Filterable by standard user profile properties and custom user profile properties</td></tr><tr><td></td><td>Recent device properties</td><td>Filtering is possible through information collected from the user's most recently used device as of the previous day.</td></tr><tr><td></td><td>Behavioral properties</td><td>Filterable through information collected on specific behavioral attributes defined in the definer</td></tr></tbody></table>

<mark style="background-color:blue;">**Setting conditions with events**</mark>

You can set a condition for how many times a specific event is performed within a specific period.

yes) <kbd>*<mark style="background-color:purple;">Users who triggered the df\_purchase event 3 or more times in September 2024</mark>*</kbd>

{% hint style="danger" %}
**Filter only users who have triggered an event at least once**

※ When setting a condition as an event, you cannot set a condition of whether the user performed the event or not, so you can basically set a condition of a user who performed the event at least once within the period.
{% endhint %}

* <mark style="background-color:blue;">**When selecting 'Event/Event Attribute',**</mark>\
  You can enter filtering conditions by selecting events such as purchases and their attribute information (product category, purchase amount, etc.).<br>

  <figure><img src="/files/HettOWf5r35a8z19M1D4" alt=""><figcaption></figcaption></figure>

<mark style="background-color:orange;">**Setting conditions with user profiles**</mark>

Unlike event conditions, user profile conditions do not set a period because the most recent value is saved.\
For user profile conditions, you can select one of the categories: 'User Properties', 'Recent Device Properties', or 'Behavior Properties'.

yes) <kbd>*<mark style="background-color:purple;">VIP members in their 30s</mark>*</kbd>

* <mark style="background-color:orange;">**When you select 'User Properties',**</mark>\
  You can set filter conditions using standard user profile properties provided by DFINERY and custom user profile properties you added yourself.<br>

  <figure><img src="/files/Lx4bV8ebfyDBveqQgSfp" alt=""><figcaption></figcaption></figure>

* <mark style="background-color:orange;">**When you select 'Recent device properties',**</mark>\
  You can set filter conditions based on properties collected from the device most recently used by the user.<br>

  <figure><img src="/files/sRSChYhm2utuT1KmRmxS" alt=""><figcaption></figcaption></figure>

<details>

<summary><strong>Recent Device Attributes Details (Table)</strong></summary>

* Reference<br>

  <table><thead><tr><th width="253">Provided properties</th><th>Explanation</th></tr></thead><tbody><tr><td>Recent device region</td><td>The region of the device the user recently used.</td></tr><tr><td>Recent device models</td><td>The model of the device the user recently used.</td></tr><tr><td>Recent news agency</td><td>This is the carrier the user recently used.</td></tr><tr><td>Latest browser version</td><td>The version of the web browser the user recently used.</td></tr><tr><td>Recent browsers</td><td>The web browser the user recently used.</td></tr><tr><td>Recent countries</td><td>The country where the user is currently located (IP based)</td></tr><tr><td>Recent city</td><td>The city where the user is currently located (IP based)</td></tr><tr><td>Recent Device ID</td><td>A unique identifier (ID) for the device the user recently used.</td></tr><tr><td>Recent IDFV</td><td>This is the IDFV of the device that the user recently used on iOS.</td></tr><tr><td>Recent IDFA</td><td>This is the IDFA of the device the user recently used on iOS.</td></tr><tr><td>Recent GAID</td><td>The GAID of the device the user recently used on Android.</td></tr><tr><td>Recent Google App Set ID</td><td>The App Set ID of the device the user recently used on Android.</td></tr><tr><td>Recent Cookie ID</td><td>The Cookie ID that the user recently used in his web browser.</td></tr><tr><td>Most recently used library version</td><td>The version of the SDK that the user recently used.</td></tr><tr><td>Recently used library platforms</td><td>The platform the user recently used.</td></tr><tr><td>Recent OS</td><td>The operating system (OS) that the user recently used.</td></tr><tr><td>Recent Languages</td><td>The language of the device the user recently used.</td></tr><tr><td>Recent time zone</td><td>The time zone of the device the user recently used.</td></tr><tr><td>Recent area</td><td>The region (city/province) where the user is currently located. (IP based)</td></tr></tbody></table>

</details>

* <mark style="background-color:orange;">**When selecting 'Behavior Attribute',**</mark>\
  You can enter filtering conditions by selecting user-specific behavior attribute information automatically calculated by cycle, such as the number of purchases or purchase amount during a specific period.<br>

  <figure><img src="/files/6o4UfLsKqlQPkIdNFkiv" alt=""><figcaption></figcaption></figure>

<details>

<summary><strong>Behavior Attribute Details (Table)</strong></summary>

* Reference<br>

  <table><thead><tr><th width="263">Provided Properties</th><th>Explanation</th></tr></thead><tbody><tr><td>Last purchase date in 3 months</td><td>The last time a user purchased an item from the service in the past 3 months.</td></tr><tr><td>Last purchase date in the last 6 months</td><td>The last time a user purchased an item from the service in the past 6 months.</td></tr><tr><td>Last purchase date in the past year</td><td>The last time a user purchased an item from the service within the past year.</td></tr><tr><td>First purchase date in 3 months</td><td>The date and time when the user first purchased an item from the service in the past 3 months.</td></tr><tr><td>First purchase date in 6 months</td><td>The date and time when the user first purchased an item from the service in the past 6 months.</td></tr><tr><td>Date of first purchase in 1 year</td><td>The date and time when the user first purchased an item from the service in the past year.</td></tr><tr><td>Number of purchases in 3 months</td><td>The number of purchases made on a user's account or device in the last 3 months.</td></tr><tr><td>Number of purchases in 6 months</td><td>The number of purchases made on a user's account or device in the last 6 months.</td></tr><tr><td>Number of purchases per year</td><td>The number of purchases made on a user's account or device in the past year.</td></tr><tr><td>Purchase amount for 3 months</td><td>The amount of purchases made on your account or device in the last 3 months.</td></tr><tr><td>Purchase amount for 6 months</td><td>The amount of purchases made on your account or device in the last 6 months.</td></tr><tr><td>Purchase amount for 1 year</td><td>The amount of purchases made on your account or device in the past year.</td></tr><tr><td>Average purchase amount over 3 months</td><td>The average purchase amount for the user's account or device over the past 3 months.</td></tr><tr><td>Average purchase amount over 6 months</td><td>The average purchase amount for the user's account or device over the last 6 months.</td></tr><tr><td>Average purchase amount per year</td><td>The average purchase amount for a user's account or device over the past year.</td></tr><tr><td>Most purchased day of the week in 3 months</td><td>This is the day of the week on which users made the most purchases in the past 3 months. This can be used to understand users' purchasing patterns.</td></tr><tr><td>Most purchased day of the week in 6 months</td><td>This is the day of the week on which users made the most purchases in the last 6 months. This can be used to understand users' purchasing patterns.</td></tr><tr><td>Most purchased day of the year</td><td>This is the day of the week on which users made the most purchases in the past year. This can be used to understand users' purchasing patterns.</td></tr><tr><td>Most Purchased Time in 3 Months</td><td>This is the time period in which users made the most purchases in the past 3 months. This can be used to determine the time period in which users make purchases.</td></tr><tr><td>Most Purchased Time in 6 Months</td><td>This is the time period in which users made the most purchases in the past 6 months. This can be used to determine the time period in which users make purchases.</td></tr><tr><td>Most Purchased Time in 1 Year</td><td>This is the time period in which users made the most purchases in the past year. This can be used to determine the time period in which users make purchases.</td></tr><tr><td>#1 in purchase category for 3 months</td><td>This is the first most purchased item in the major categories that users have purchased the most in the last 3 months.</td></tr><tr><td>#1 in purchase category for 6 months</td><td>This is the first most purchased item in the major categories that users have purchased the most in the last 6 months.</td></tr><tr><td>#1 in purchase category for 1 year</td><td>This is the first most purchased item in the major categories that users have purchased the most in the past year.</td></tr><tr><td>Ranked 2nd in major purchase categories for 3 months</td><td>This is the second most purchased category among users over the past three months.</td></tr><tr><td>Ranked 2nd in major purchase categories for 6 months</td><td>This is the second most purchased category by users over the last six months.</td></tr><tr><td>Ranked 2nd in major purchase categories for the past year</td><td>This is the second most purchased category by users over the past year.</td></tr><tr><td>3rd most purchased category in 3 months</td><td>This is the third most purchased category among the items purchased by users in the last three months.</td></tr><tr><td>3rd most purchased category for 6 months</td><td>This is the third most purchased category by users over the last six months.</td></tr><tr><td>3rd most purchased category in 1 year</td><td>This is the third most purchased category by users over the past year.</td></tr><tr><td>#1 most purchased item for 3 months</td><td>This is the first most purchased item among products purchased by users in the last 3 months.</td></tr><tr><td>#1 most purchased item for 6 months</td><td>This is the first most purchased item among products purchased by users in the last 6 months.</td></tr><tr><td>#1 most purchased product in 1 year</td><td>This is the first most purchased item among products that users purchased the most in the past year.</td></tr><tr><td>2nd most purchased item in 3 months</td><td>This is the second most purchased item by users in the last 3 months.</td></tr><tr><td>2nd most purchased item in 6 months</td><td>This is the second most purchased item by users in the last 6 months.</td></tr><tr><td>2nd most purchased product in 1 year</td><td>This is the second most purchased item by users over the past year.</td></tr><tr><td>3rd most purchased item in 3 months</td><td>The third most purchased item by users in the last 3 months</td></tr><tr><td>3rd most purchased item in 6 months</td><td>The third most purchased item by users in the last 6 months</td></tr><tr><td>3rd most purchased product in 1 year</td><td>The third most purchased item by users over the past year</td></tr><tr><td>Last updated date</td><td>The last time the user information was updated.</td></tr><tr><td>Number of sessions per year (total active events)</td><td>The total number of user sessions. A session is a unit in which a user accesses an app or web service and engages in an activity for a certain period of time before it ends.</td></tr><tr><td>Number of events per year</td><td>The total number of user events. Events are various interactions that occur within an app or web, such as page views and searches.</td></tr><tr><td>Last activity date</td><td>The last time the user was active on the service.</td></tr><tr><td>First access date and time</td><td>The time when the user first accessed the service.</td></tr></tbody></table>

</details>

3. When you click '+ Add Condition', you can only add the same filter conditions. For example, if you selected an event as a filter condition, you can only select an event in the additional conditions, and if you started with a user profile condition, you can only set the additional conditions as a user profile\
   \
   Only AND conditions can be added, and OR conditions can be applied through a Venn diagram using the group palette.\
   ![](/files/7ODhTBVJOEoK6m9o6EWc)![](/files/lWieVnrGa0YPfwgTLm05)

## **Group Palette Settings**

<figure><img src="/files/S9JidN3L2YveT4OStL2O" alt=""><figcaption><p>Example screen</p></figcaption></figure>

1. Drag and drop the created groups to create intersections, unions, differences, complements, and symmetric differences according to your purpose and needs. Audience calculations are not possible if there are any uncombined groups left.<br>
   * Detailed instructions on how to combine groups `?`can be found through the guide button ' ' at the top of the palette.
   * Intergroup bonding can be done up to 3 depth.
   * The number of groups that can be created is a minimum of 1 and a maximum of 4.

2. Click the 'Calculate Audience' button to calculate the parameters.\
   Be sure to check the parameters through the audience calculation.<br>

   <figure><img src="/files/n5yP2U9Fo7rLbFOjFFyj" alt=""><figcaption></figcaption></figure>

3. After that, click the Save Draft or Publish button to add an audience name and description.<br>

   <figure><img src="/files/qo9aMa9U05HQfFgEkrFz" alt=""><figcaption></figcaption></figure>

4. You can check the saved audiences in the list.<br>

   <figure><img src="/files/D4VQP75N6yEmIkkq05jW" alt=""><figcaption></figcaption></figure>

5. When you enter the generated audience details screen, you can check the offsite campaign parameters or set whether to schedule it.

   <div data-gb-custom-block data-tag="hint" data-style="danger" class="hint hint-danger"><p>Once an audience has been published, the conditions and Venn diagram cannot be modified as this may affect the campaign (use) results.</p></div>

   <figure><img src="/files/VBGHO0mMx6XZH0NJKfBd" alt=""><figcaption></figcaption></figure>

   <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p>Offsite campaign parameters are a feature that allows you to check the parameters for which messages can be sent based on the last calculated parameters.</p></div>

## **Audience activation and retention**

In CRM and reports, <kbd><mark style="background-color:purple;">Active<mark style="background-color:purple;"></kbd> you can only select audiences by status.

<kbd><mark style="background-color:purple;">Custody<mark style="background-color:purple;"></kbd> However, since there is a limit to the number of audiences you can create, you can manage them separately if complex conditions are applied even if you no longer use the audience .

<table><thead><tr><th width="97"></th><th width="365">Number</th><th>Note</th></tr></thead><tbody><tr><td>Generation</td><td>Up to 100</td><td>Including temporary storage audience</td></tr><tr><td>Active</td><td>Up to 50</td><td></td></tr><tr><td>Custody</td><td>The number of creations minus the number of activations. Example) If 70 are created and 50 are activated, 30 can be stored.</td><td>Temporary saved audiences cannot be stored</td></tr></tbody></table>

{% hint style="danger" %}

* **Audiences that are being used in CRM campaigns or report filters cannot be archived.**\
  When archiving or deleting an audience, if the audience is being used in analysis or campaigns, you must directly deactivate and delete the audience or change it to archive status in the campaign area.<br>
* **Audiences that have no intended use can be archived if campaign scheduling is enabled.**
  {% endhint %}

<figure><img src="/files/GtAZTqjjczHA2CmAexLV" alt="" width="563"><figcaption></figcaption></figure>

## **Viewable period**

* You can set up to 100 days per group.
* When the period is set to 'Relative', the selectable reference date can also be set to up to 100 days in advance.
* When combining two groups, you can search for up to 200 days. ( [<mark style="color:purple;">Related Guide</mark>](https://docs.dfinery.ai/user-guide/customer/audience/samples#id-200) )

## **Limit rule**

* The Not condition (exclude operator) is only supported when setting events and user profile properties that are always kept up to date.
* The Not condition is not supported when setting event properties.
* However, when setting up event triggering, the Not condition is also supported for event properties.
* When creating an audience, data can be retrieved for up to 200 days.


---

# 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:

```
GET https://docs.dfinery.ai/user-guide/en/customer/audience.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
