# キャンペーンパラメータの設定

パラメーターは手動キャンペーンを送信するユーザー、Nexthink API を介したサードパーティシステム、またはワークフロー内で利用可能なデータによって入力が必要なキャンペーン質問のプレースホルダーです。 システムはキャンペーンの回答に沿ってパラメーター値を保存し、回答をこれらのパラメーターにリンクします。

{% hint style="info" %}
パラメーターは手動、API、およびワークフローキャンペーンで利用可能です。
{% endhint %}

<figure><img src="https://3549141153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLm8O7QKZDn6z806e7Sv%2Fuploads%2Fgit-blob-510dd449731e7eba3185792c0095fa4c2aec716a%2FParameters.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
各キャンペーンでは最大 30 のパラメーターを使用してください。
{% endhint %}

### パラメーター使用例 <a href="#typesofcampaigns-parametersusecases" id="typesofcampaigns-parametersusecases"></a>

以下は、パラメーターに関連する使用例です。

<details>

<summary>サービスデスクチケットのクローズ後の満足度を測定する</summary>

ITSM ツールから API 経由でキャンペーンをトリガし、チケット番号と説明のパラメーターを使用します。

</details>

<details>

<summary>カスタマイズ可能な停止通知テンプレートの作成</summary>

影響を受けたユーザーを調査して手動キャンペーンをトリガするか、APIを使用して停止の影響と影響を受けたサービスのパラメーターを使用します。

</details>

<details>

<summary>更新や社員の退職時に個別通知を送信する</summary>

資産管理ソリューションから API キャンペーンをトリガし、資産番号、資産名、予想返却日をパラメーターとして使用します。

</details>

### パラメーターの作成 <a href="#typesofcampaigns-creatingparameters" id="typesofcampaigns-creatingparameters"></a>

**新しいキャンペーンドラフト**ページの**一般**タブで：

1. **トリガー**で**手動**、**ワークフロー**、または**API**を選択します。
2. **パラメーター**切り替えボタンをクリックします。
3. 新しいパラメーターを追加し、フィールドに入力します：
   * **名前**: パラメーターの一意の名前を入力します。
   * **ID**: NQL クエリや APIキャンペーン送信時に使用するための一意の ID を入力します。
   * **説明**: 調査からキャンペーンを送信する際にパラメーターを識別するための説明を入力します。

ドラフト状態のキャンペーンに対して、パラメーターや関連するIDの数を変更します。 公開済みまたは引退したキャンペーンについては、パラメーターの名前や説明のみを編集できます。

{% hint style="info" %}
API キャンペーンでは、パラメーター ID はサードパーティシステムのものと一致する必要があります。
{% endhint %}

<figure><img src="https://3549141153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLm8O7QKZDn6z806e7Sv%2Fuploads%2Fgit-blob-3fb5cf5c929b2a9e188ee832316a807c01ee2066%2FParameter_settings.png?alt=media" alt=""><figcaption></figcaption></figure>

### キャンペーン質問でパラメーターを使用 <a href="#typesofcampaigns-usingparametersincampaignquestions" id="typesofcampaigns-usingparametersincampaignquestions"></a>

パラメーターを設定した後、**新しいキャンペーンドラフト**ページまたは**キャンペーン編集**ページから：

1. **コンテンツ**タブに移動します。
2. **テキスト**ツールバーの\*\*{x}\*\*アイコンを使用して、**テキスト**質問内にパラメーターとその翻訳バージョンを挿入します。
3. パラメーター `{{parameter_id}}` 形式に従います。

#### 使用例: URL をパラメーターとして渡す

URL をパラメーターとして渡す場合:

* **URL を書き出し、キャンペーン内で表示することを意図している場合:** パラメーターに `https://` を含めます。
* **ハイパーリンクとして使用し、目的地の URL を省略しパラメーター化することを意図している場合:** テキストエディタの **リンクを追加** ボタンを使用し、パラメーターから `https://` を省略します。システムがデフォルトでそれを付け加えます。
* **表示される宛先 URL にパラメーターを使用することを意図している場合:**
  1. パラメーターから `https://` を省略します。システムがデフォルトで付け加えます。
  2. キャンペーンテキストで、`https://` をパラメーターの前に追加します。 例: `https://{{parameter_without_https}}`
  3. `https://` を含むテキストを選択します。
  4. リッチテキストエディタで **リンクを挿入** オプションを使用します。
  5. 続行して、リンクとして使用し、目的地の URL を省略してパラメータ化したい場合のように進みます。

<figure><img src="https://3549141153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLm8O7QKZDn6z806e7Sv%2Fuploads%2Fgit-blob-9007d2639eff75ab2c9aa2cee713a9c5cd1eae8f%2Fimage%20(837).png?alt=media" alt=""><figcaption></figcaption></figure>

以下は、[手動](#example-of-using-parameters-in-manual-campaigns)および [API トリガ](#example-of-using-parameters-in-api-campaigns)キャンペーンでパラメーターを使用する例です。

### **手動キャンペーンでのパラメーター使用例**

次の例は、手動でトリガするキャンペーンにおけるパラメーター `{{service_name}}`、`{{impact}}`、`{{timeframe}}`、`({{incident_id}})` の使用を示しています。

<figure><img src="https://3549141153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLm8O7QKZDn6z806e7Sv%2Fuploads%2Fgit-blob-c5f80ad87796d3ead4ffa9e32ef6c4f8cb0660cb%2Ftypesofcampaings-1700490160.png?alt=media" alt="" width="760"><figcaption></figcaption></figure>

[調査](https://docs.nexthink.com/platform/ja/user-guide/investigations)ページから**ユーザー**へ手動キャンペーンを起動し送信する際、**キャンペーンを送信**ポップアップウィンドウでキャンペーンパラメーターの値を入力する必要があります。

<figure><img src="https://3549141153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLm8O7QKZDn6z806e7Sv%2Fuploads%2Fgit-blob-1238da1bee3092ce23e7187f8d28c37b59c68078%2Ftypesofcampaings-1700495884.png?alt=media" alt="" width="760"><figcaption></figcaption></figure>

### **API キャンペーンでのパラメーター使用例**

次の例は、API トリガーキャンペーンにおけるパラメーター `{{ticket_description}}` と `{{ticket_number}}` の使用を示しています。

{% hint style="info" %}
パラメーター ID は Nexthink API を呼び出すサードパーティシステムのものと一致する必要があることを忘れないでください。
{% endhint %}

<figure><img src="https://3549141153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLm8O7QKZDn6z806e7Sv%2Fuploads%2Fgit-blob-75807bfa67aee5c73e2a184205fb5b30f0216fab%2Ftypesofcampaings-1700489924.png?alt=media" alt="" width="760"><figcaption></figcaption></figure>

***

関連トピック

* [Investigations](https://docs.nexthink.com/platform/ja/user-guide/investigations)
* [開発者ポータル](https://developer.nexthink.com/)