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

# ターゲティングオプションルール詳細ガイド

> ターゲティングオプションを作成する際、プロパティまたはコンテキストに条件を設定します。このガイドでは、データタイプ別に使用可能な演算子とフィルターの組み合わせ方法を説明します。

***

## データタイプ別の値の形式

SDKからプロパティ値を渡す際に使用される形式。

| タイプ         | 形式           | 例                                        |
| ----------- | ------------ | ---------------------------------------- |
| **String**  | テキスト         | `"seoul"`、`"premium"`、`"user@email.com"` |
| **Number**  | 整数または小数      | `0`、`123`、`-456`、`1234.56`               |
| **Boolean** | true / false | `true`、`false`                           |
| **Date**    | ISO 8601（推奨） | `2024-01-18`、`2024-01-20T08:20:00`       |

<Note>
  日付はISO 8601形式（`YYYY-MM-DD`）を推奨します。`YYYYMMDD`およびタイムスタンプ（ms）もサポートされています。
</Note>

***

## String演算子

文字列型プロパティで使用可能な演算子。

| 演算子                  | 説明            | 例                             |
| -------------------- | ------------- | ----------------------------- |
| **is**               | 完全一致するユーザーを含む | region is "Seoul"             |
| **is not**           | 完全一致するユーザーを除外 | region is not "Seoul"         |
| **contains**         | 値を含むユーザーを含む   | email contains "gmail"        |
| **does not contain** | 値を含むユーザーを除外   | email does not contain "test" |
| **starts with**      | 値で始まるユーザーを含む  | username starts with "admin"  |
| **ends with**        | 値で終わるユーザーを含む  | email ends with ".com"        |

<Warning>
  文字列演算子は大文字小文字を区別します。"Seoul"と"seoul"は異なる値として扱われます。
</Warning>

<Note>
  **is**演算子は複数の値を選択できます。例：region is "Seoul", "Busan", "Jeju"
</Note>

***

## Number演算子

数値型プロパティで使用可能な演算子。

| 演算子                        | 説明                | 例                                     |
| -------------------------- | ----------------- | ------------------------------------- |
| **is**                     | 完全一致するユーザーを含む     | age is 25, 30, 35                     |
| **is not**                 | 完全一致するユーザーを除外     | age is not 0                          |
| **equals**                 | 値と等しいユーザーを含む      | trade\_count equals 10                |
| **not equals**             | 値と等しくないユーザーを含む    | trade\_count not equals 0             |
| **greater than**           | 値より大きいユーザーを含む（>）  | trade\_count greater than 5           |
| **greater than or equals** | 値以上のユーザーを含む（>=）   | trade\_count greater than or equals 5 |
| **less than**              | 値より小さいユーザーを含む（\<） | trade\_count less than 20             |
| **less than or equals**    | 値以下のユーザーを含む（\<=）  | trade\_count less than or equals 20   |
| **between**                | 2つの値の間のユーザーを含む    | age between 20, 29                    |
| **not between**            | 2つの値の間のユーザーを除外    | age not between 20, 29                |

<Note>
  **is**演算子は複数の値を選択できます。**between / not between**は2つの値が必要です。
</Note>

***

## Boolean演算子

ブール型（true/false）プロパティで使用可能な演算子。

| 演算子          | 説明               | 例                    |
| ------------ | ---------------- | -------------------- |
| **is True**  | true値を持つユーザーを含む  | is\_premium is True  |
| **is False** | false値を持つユーザーを含む | is\_premium is False |

***

## Date演算子

日付型プロパティで使用可能な演算子。

| 演算子                 | 説明               | 例                                        |
| ------------------- | ---------------- | ---------------------------------------- |
| **last**            | 過去の期間内のユーザーを含む   | last\_login last 7 days                  |
| **before the last** | 過去の期間より前のユーザーを含む | last\_login before the last 30 days      |
| **next**            | 次の期間内のユーザーを含む    | subscription\_end next 7 days            |
| **after the next**  | 次の期間より後のユーザーを含む  | subscription\_end after the next 30 days |
| **before**          | 特定の日付より前のユーザーを含む | created\_at before 2024-01-01            |
| **after**           | 特定の日付より後のユーザーを含む | created\_at after 2024-01-01             |

***

## ターゲティングオプションルールの組み合わせ

1つのターゲティングオプションに複数の条件を設定できます。

### 条件を追加（AND）

**条件を追加**をクリックするとANDロジックで接続されます。すべての条件を満たすユーザーのみが含まれます。

**例：ソウルパワーセラー**

* region is "seoul" **AND**
* trade\_count greater than or equals 20

→ ソウル地域で取引回数が20回以上のユーザー

### 条件グループを追加（OR）

**条件グループを追加**をクリックするとORロジックで接続されます。いずれかのグループを満たすユーザーが含まれます。

**例：首都圏ユーザー**

* (region is "seoul") **OR**
* (region is "gyeonggi")

→ ソウルまたは京畿道のユーザー

### 複雑な条件

ANDとORを組み合わせて複雑な条件を作成できます。

**例：首都圏パワーセラー**

* (region is "seoul" AND trade\_count greater than or equals 20) **OR**
* (region is "gyeonggi" AND trade\_count greater than or equals 20)

→ ソウルのパワーセラーまたは京畿道のパワーセラー

***

## コンテキストターゲティング演算子

コンテキストターゲティングでは、コンテキストIDに対して次の演算子を使用できます。

| 演算子          | 説明              | 例                                      |
| ------------ | --------------- | -------------------------------------- |
| **is**       | コンテキストIDと完全一致   | context is "phone", "laptop", "tablet" |
| **is not**   | コンテキストIDと一致しない  | context is not "adult"                 |
| **contains** | コンテキストIDに文字列を含む | context contains "sports"              |

<Note>
  **is**演算子で複数のコンテキストIDを選択すると、それらのIDのいずれかに一致すれば広告が表示されます。
</Note>

***

## 次のステップ

<Card title="キャンペーンの予約" icon="calendar-check" href="/ja/campaign">
  広告主がターゲティングを選択してキャンペーンを予約する方法を確認
</Card>

***

## FAQ

<AccordionGroup>
  <Accordion title="ターゲティングオプションの条件を設定する際に最も重要なことは何ですか？">
    SDKから渡される通りに正確に入力することが重要です。特に文字列は大文字小文字を区別するため、「Seoul」と「seoul」は異なる値として扱われます。開発チームと実際に渡される値を確認してください。
  </Accordion>

  <Accordion title="日付条件はいつ役立ちますか？">
    時間とともに変化するユーザー状態をターゲティングする場合に便利です。例えば、「過去7日以内にログインしたアクティブユーザー」、「30日以内にサブスクリプションが期限切れになるユーザー」、「1年以上前に加入した長期会員」などです。
  </Accordion>

  <Accordion title="ANDとOR条件をどう使い分けますか？">
    すべての条件を同時に満たす必要がある場合はAND（条件を追加）を使用します。複数の条件のいずれか1つを満たせばよい場合はOR（条件グループを追加）を使用します。例えば、「ソウルのパワーセラー」はregion=Seoul AND trade\_count≥20で、「首都圏ユーザー」はregion=Seoul OR region=Gyeonggiです。
  </Accordion>
</AccordionGroup>