> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/ja/what-would-you-like-to-learn-about/platform-features/blocking-and-redirect-rules/build-redirect-rule-conditions.md).

# リダイレクトルール条件を作成

すべてのリダイレクトルールは、1つ以上の条件から始まります。 *条件* は、ランディングページのURL、国、デバイスの種類など、受信トラフィックに関する情報を確認し、ルールを適用するかどうかを判断します。 [リダイレクトルールの作成方法](https://help.impact.com/brand/ja/what-would-you-like-to-learn-about/platform-features/blocking-and-redirect-rules/create-a-redirect-rule.md).

## 条件属性

以下の表に、ルールで使用できる条件属性を示します。

<details>

<summary>条件属性リファレンス</summary>

| 条件属性          | 説明                                                                                                                                                                                                                                                                                                                                                                           |
| ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ランディングページ     | 元の遷移先URL。                                                                                                                                                                                                                                                                                                                                                                    |
| IPアドレス        | デバイスに登録されているIPアドレス。                                                                                                                                                                                                                                                                                                                                                          |
| 共有 ID         | レポートで使用される、パートナーが管理するクエリ文字列パラメーター。                                                                                                                                                                                                                                                                                                                                           |
| 国             | トラフィックの発生元の国。                                                                                                                                                                                                                                                                                                                                                                |
| 状態            | トラフィックの発生元の州。                                                                                                                                                                                                                                                                                                                                                                |
| 広告のステータス      | 関連する広告の使用状況。                                                                                                                                                                                                                                                                                                                                                                 |
| SubID1        | レポートで使用される、パートナーが管理するクエリ文字列パラメーター。                                                                                                                                                                                                                                                                                                                                           |
| SubID2        | レポートで使用される、パートナーが管理するクエリ文字列パラメーター。                                                                                                                                                                                                                                                                                                                                           |
| SubID3        | レポートで使用される、パートナーが管理するクエリ文字列パラメーター。                                                                                                                                                                                                                                                                                                                                           |
| MP ID         | impact.comがパートナーに割り当てる一意の識別子                                                                                                                                                                                                                                                                                                                                                 |
| デバイスの種類       | リダイレクトルールが有効化されたときに顧客が使用していたデバイスの種類。                                                                                                                                                                                                                                                                                                                                         |
| 参照元URL        | 元の遷移先URLにトラフィックを誘導しているウェブサイトのURL。                                                                                                                                                                                                                                                                                                                                            |
| 商品SKU         | 広告の対象を示す識別子。通常は商品カタログで指定されます。                                                                                                                                                                                                                                                                                                                                                |
| 広告ID          | impact.comが広告に割り当てる一意の識別子。                                                                                                                                                                                                                                                                                                                                                   |
| 確率            | リダイレクトルールは、トラフィックのうち指定した割合をランダムに選び、別の経路に転送します。主にA/Bテストに使用されます。                                                                                                                                                                                                                                                                                                               |
| モバイルフォールバック   | <p>広告に <a href="https://help.impact.com/brand/ja/what-would-you-like-to-learn-about/platform-features/blocking-and-redirect-rules/create-app-install-interstitials.md">モバイルフォールバック</a> が設定されている場合、関連するルーティングルールで、アプリをダウンロードできるよう、トラフィックを該当するアプリストアに転送するよう指定できます。</p><p><em>モバイルフォールバック</em> リダイレクトルールは通常、オンボーディング中に設定します。技術仕様を確認し、モバイルフォールバックのリダイレクトルールが必要かどうかを確認してください。</p> |
| アプリ名          | リダイレクトルールが有効化されたときに顧客が使用していたアプリの名前。                                                                                                                                                                                                                                                                                                                                          |
| ブラウザー名        | リダイレクトルールが有効化されたときに顧客が使用していたブラウザーの名前。                                                                                                                                                                                                                                                                                                                                        |
| オペレーティングシステム名 | リダイレクトルールが有効化されたときに顧客が使用していたオペレーティングシステムの名前。                                                                                                                                                                                                                                                                                                                                 |
| アプリ内WebView   | リダイレクトルールが有効化されたときに、顧客がアプリ内WebViewを使用していたかどうか。                                                                                                                                                                                                                                                                                                                               |

</details>

## 条件演算子

特に便利な条件属性の1つは **ランディングページ**です。これを使うと、受信URLに基づく条件やリダイレクトを作成できます。以下に示す演算子は、 **ランディングページ** 属性に対するものです。使用できる演算子は選択した属性によって異なり、多くの属性では選択肢が限られます。たとえば、 **モバイルフォールバック** で使用できるのは **次の値と等しい** および **ではない**.

<details>

<summary>条件演算子のリファレンス</summary>

| 演算子           | 説明                                                                                        |
| ------------- | ----------------------------------------------------------------------------------------- |
| **を含む**       | 属性の値に、指定したテキストが含まれます。                                                                     |
| **で始まる**      | 属性の値が、指定したテキストで始まります。                                                                     |
| **で終わる**      | 属性の値が、指定したテキストで終わります。                                                                     |
| **に一致する**     | 属性の値がパターンに一致します。パターンには、値の一部を取得するプレースホルダー（`{NAME}`）や、残りの任意の文字に一致するワイルドカード（`*`）を含めることができます。 |
| **次のいずれか**    | 属性の値が、指定した値のリストのいずれかに一致します。                                                               |
| **を含まない**     | 属性の値に、指定したテキストが含まれません。                                                                    |
| **で始まらない**    | 属性の値が、指定したテキストで始まりません。                                                                    |
| **で終わらない**    | 属性の値が、指定したテキストで終わりません。                                                                    |
| **ではない**      | 属性の値が、指定した値と完全には一致しません。                                                                   |
| **次のいずれでもない** | 属性の値が、指定した値のリストのいずれにも一致しません。                                                              |
| **正規表現**      | 属性の値が、カスタム正規表現に一致します。                                                                     |

</details>

## 条件を組み合わせる

複数の条件を組み合わせるには、 **AND**:

* 次を使用します。 **AND** 複数の条件を同時に満たす必要がある場合に使います。たとえば、特定の国から、特定のデバイスタイプで発生したトラフィックを対象にする場合です。
* 「 **別の条件を追加** 」を選択すると、最初の条件または新しい条件のどちらかを満たす、独立した条件を追加できます。両方を満たす必要はありません。つまり、 **別の条件を追加** は **OR** 条件と同じです。

次の2つのセクションでは、 *Contains* 演算子と *Matches* 演算子を使ってリダイレクトルールを作成する方法を説明します。

## contains演算子を使用する

URLに基づいてトラフィックを振り分ける最も簡単な方法は、 **contains**を使って個別のルールを2つ作成することです。たとえば、英国のページにアクセスしたユーザーには1つ目のクエリパラメーターを、米国のページにアクセスしたユーザーには別のクエリパラメーターを設定するとします。

ルール1、英国のトラフィック:

1. 条件： `Landing Page` **に次の文字列が含まれる** `/uk`.
2. アクション：同じ URL にリダイレクトし、末尾に `?a=123` を追加します。

ルール 2、米国からのトラフィック：

1. 条件： `Landing Page` **に次の文字列が含まれる** `/us`.
2. アクション：同じ URL にリダイレクトし、末尾に `?a=456` を追加します。

各ルールは、受信した URL に特定の文字列（ `/uk` または `/us`）が含まれているかを確認します。文字列が見つかると、リダイレクトルールはパラメーターを追加して訪問者を別のページに移動させます。

この方法は、単純な二者択一の振り分けには適していますが、元の URL の一部を再利用することはできません。その場合は、 **matches**.

## matches 演算子を使う

matches **演算子を使うと、URL 全体に対するパターンを記述し、その一部に** のようなプレースホルダーを指定できます。 `{PLACEHOLDER}`これにより、その部分をリダイレクト先でそのまま再利用できます。

<details>

<summary>プレースホルダーを使って matches を適用する</summary>

靴を販売していて、英国向けの各商品ページの URL が次のようになっているとします。 `https://www.example.com/uk/<product-name>`。商品名を維持したまま、それぞれをパートナーサイトの同じページにリダイレクトしたいとします。

1. 条件を次のように設定します。 `Landing Page` **matches** `https://www.example.com/uk/{PRODUCT}`この設定は、 `https://www.example.com/uk/` で始まるすべての URL に一致し、その直後にある値を `PRODUCT`.
2. として扱います。 `https://www.example.com/uk/sneakers` をテスト用のランディングページに指定してテストします。結果として、照合に成功し、 `{PRODUCT}` には `sneakers`.
3. が設定されます。 `アクションで、リダイレクト先を次のように設定します。`これは次の URL になります。 `https://www.example.com/uk/sneakers?a=123` 一度 `{PRODUCT}` としてキャプチャされます `sneakers`.

つまり、プレースホルダーは変数のように機能します。受信 URL からキャプチャしたテキストは、送信 URL の同じ位置に挿入されます。

</details>

<details>

<summary>ワイルドカードを使って matches を使用する</summary>

上記とまったく同じルールを使って、少し異なる URL を試してみましょう。

1. テスト用ランディングページとして `https://www.example.com/uk/sneakers/mens` を入力してテストします。結果は「一致が見つかりません」になります。

これは、 **matches** 演算子が URL の先頭だけでなく、URL 全体に対してパターンを照合するためです。パターン `https://www.example.com/uk/{PRODUCT}` は、 `/uk/`の後の 1 つのセグメントしか考慮しておらず、余分な `/mens`を考慮するものがないため、一致しません。

プレースホルダーの後に任意の文字列を許可するには、パターンの末尾にワイルドカード（`*`）を追加します。

* 新しいパターン： `https://www.example.com/uk/{PRODUCT}*`
* これで、 `https://www.example.com/uk/sneakers` と `https://www.example.com/uk/sneakers/mens`. `{PRODUCT}` が引き続きキャプチャするのは `sneakers` だけです（次の `/`まで）。また、 `*` ワイルドカードは、その後に続くものをすべて単に吸収します。

パターンの末尾に `*`がない場合、受信 URL はパターンとまったく同じ位置で終わる必要があります。そうでないと一致しません。

</details>

<details>

<summary>複数のプレースホルダーで matches を使用する</summary>

同じパターン内で複数のプレースホルダーを使えます。たとえば、商品ページにカテゴリと SKU の両方が含まれ、形式が `https://www.example.com/uk/shop/product/sneakers/SKU123-blue-running-shoe`で、その後に追加のコンテンツ（たとえば `/reviews`).

1. ）が続く場合があるとします。 `Landing Page` **を** `https://www.example.com/uk/shop/product/{CATEGORY}/{SKU}*`に一致する条件として設定します。各プレースホルダーの役割は次のとおりです。
   * `{CATEGORY}` は、 `/product/`.
   * `の直後のセグメントをキャプチャし、{SKU}` は、その次のセグメントをキャプチャします。
   * 末尾の `*` その後に続く任意の内容（たとえば `/reviews`）を許可します。前のセクションで学んだ内容を使います。
2. 次を入力してテストします。 `https://www.example.com/uk/shop/product/sneakers/SKU123-blue-running-shoe/reviews`。次の結果が得られるはずです。一致に成功し、 `{CATEGORY}` には `sneakers` が設定され、 `{SKU}` には `にはSKU123-blue-running-shoe`.
3. アクションを次の URL へのリダイレクトに設定します。 `https://www.example.com/redirect/{CATEGORY}/{SKU}`これは次のようになります。 `https://www.example.com/redirect/sneakers/SKU123-blue-running-shoe` 。両方のキャプチャした値が再利用されます。 `/reviews` リダイレクト URL で参照されていないため、この部分は削除されます。

</details>

<details>

<summary>ワイルドカードとプレースホルダーの参照先</summary>

次の表に、 **一致** ルールの記述に使用できる構文を示します。

| 構文          | 説明                                                                       |
| ----------- | ------------------------------------------------------------------------ |
| `{NAME}`    | URL の 1 つのセグメント（次の `/` または URL の末尾まで）をキャプチャし、リダイレクトアクションで再利用できるプレースホルダー。 |
| `*`         | プレースホルダーの後に続く任意の文字列に一致します。パターンの後に URL の追加部分がある可能性がある場合に使用します。            |
| いいえ `*` 末尾に | パターンは URL の末尾まで完全に一致する必要があります。余分な部分は許可されません。                             |

</details>


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.impact.com/brand/ja/what-would-you-like-to-learn-about/platform-features/blocking-and-redirect-rules/build-redirect-rule-conditions.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
