

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# イベントトリガーを使用してアウトバウンドキャンペーンを作成する
<a name="how-to-create-campaigns-using-event-triggers"></a>

**Connect Customer 管理ウェブサイトでイベントトリガーを設定する**

1. **キャンペーンのセットアップ**ページで、**受信者**の下にある**顧客イベント**を選択します。  
![イベントトリガーキャンペーンの受信者セクションで選択した顧客イベントを含むキャンペーン設定ページ。](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/how-to-create-campaigns-using-event-triggers-1.png)

1. **イベントソース**を選択してデータの送信元を指定し、イベントトリガーをアクティブ化する属性条件を設定します。

   イベントソースは Customer Profiles ドメインの統合に基づいています。外部アプリケーションの設定の詳細については、[「外部アプリケーションとの統合](integrate-external-apps-customer-profiles.md#setup-integrations-title-menu)」を参照してください。[Kinesis](customer-profiles-kinesis-integration.md) または [S3](customer-profiles-object-type-mappings.md) と統合することもできます。  
![統合オプションと属性条件設定を示すイベントソース選択パネル。](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/how-to-create-campaigns-using-event-triggers-2.png)

1. **配信モード**と追加の通信設定を選択します。  
![イベントトリガーキャンペーンの配信モードの選択と追加の通信設定。](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/how-to-create-campaigns-using-event-triggers-3.png)

1. (オプション) Predictive Insights をイベントトリガーキャンペーンと統合するように**推奨事項**セクションを設定します。これにより、E メールと SMS チャネルを通じてパーソナライズされたテンプレートコンテンツを配信できます。  
![Amazon Connect コンソールのレコメンデーションセクション。re frequently_paired_items が選択されたレコメンダードロップダウン、_last_interacted_item_id が選択されたレコメンダーの計算属性、3 に設定されたレコメンデーションの数、および名前、価格、説明、ImageLink、カテゴリが選択されたレコメンデーション属性が表示されます。](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/how-to-create-campaigns-recommendations.png)

   次の設定を行います。
   + **レコメンダー名** – キャンペーンに関連付けられたプロファイルのレコメンデーションを生成するために使用するレコメンダーの名前を選択します。レコメンデーションの生成には、アクティブなレコメンダーのみを使用できます。

     Predictive Insights には、いくつかのタイプのレコメンデーションが用意されています。詳細については、「[ステップ 3: 予測インサイトを作成する](predictive-insights-get-started.md#create-predictive-insights)」を参照してください。
   + **レコメンダーの計算属性** – この設定は、*類似アイテム*または*頻繁にペアリングされるアイテム*のレコメンダータイプを使用する場合にのみ必要です。このコンテキストは、レコメンデーションエンジンが提案のベースとなる製品を理解し、より関連性の高いターゲットを絞ったレコメンデーションを顧客に提供できるようにします。

     たとえば、購入した項目 ID をキャプチャ`_last_interacted_item_id`する のような計算属性を使用できます。
   + **レコメンデーションの数** – プロファイルに対して生成するレコメンデーションの最大数。これは 1～3 のレコメンデーションです。
   + **レコメンデーション属性** – メッセージテンプレートで使用されるレコメンデーションレスポンスの属性を定義します。

   Predictive Insights の詳細については、「」を参照してください[Predictive Insights の使用を開始する](predictive-insights-get-started.md)。

1. 設定を確認し、**[発行]** を選択します。  
![[発行] ボタンを使用したイベントトリガーキャンペーン設定の最終レビュー画面。](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/how-to-create-campaigns-using-event-triggers-4.png)

## API を使用してイベントトリガーによるアウトバウンドキャンペーンを作成する
<a name="how-to-create-campaigns-using-event-triggers-api"></a>

**Amazon Connect Customer Profiles イベントトリガー API**
+ 機能するイベントトリガーを作成するために、次の 2 つの API コールが行われます。
  +  [CreateEventTrigger](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-customer-profiles_CreateEventTrigger.html): 指定された条件に基づいて実行するアクションを定義します。
  +  [PutIntegration](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-customer-profiles_PutIntegration.html): 使用するアクションを定義します。

**イベントトリガーリクエストの例:**

```
{
"Description": "string",
"EventTriggerConditions": [
{
"EventTriggerDimensions": [
{
"ObjectAttributes": [
{
"ComparisonOperator": "string",
"FieldName": "string",
"Source": "string",
"Values": [ "string" ]
}
]
}
],
"LogicalOperator": "string"
}
],
"EventTriggerLimits": {
"EventExpiration": number,
"Periods": [
{
"MaxInvocationsPerProfile": number,
"Unit": "string",
"Unlimited": boolean,
"Value": number
}
]
},
"ObjectTypeName": "string",
"SegmentFilter": "string",
"Tags": {
"string" : "string"
}
}
```

**`ComparisonOperator` は、以下の値をサポートします。**


|  ComparisonOperator  |  Comment  |  サポートされている型  | 
| --- | --- | --- | 
|  INCLUSIVE  |  ターゲットに指定された値がすべて含まれているかどうかを確認します。 |  String  | 
|  排他的  |  ターゲットに指定された値がすべて含まれていないかどうかを確認します。 |  String  | 
|  CONTAINS  |  ターゲットに指定された値のいずれかが含まれているかどうかを確認します。 |  String  | 
|  BEGINS\_WITH  |  ターゲットが指定された値で始まるかどうかを確認します。 |  String  | 
|  ENDS\_WITH  |  ターゲットが指定された値で終わるかどうかを確認します。 |  String  | 
|  GREATER\_THAN  |  ターゲットが指定された値より大きい場合は true。 |  Number  | 
|  LESS\_THAN  |  ターゲットが指定された値より小さい場合は true。 |  Number  | 
|  GREATER\_THAN\_OR\_EQUAL  |  この値は、フィールドで指定した値以上 (>=) の場合は true。 |  Number  | 
|  LESS\_THAN\_OR\_EQUAL  |  ターゲットが指定された値以下の場合は true。 |  Number  | 
|  EQUAL  |  ターゲットが指定された値と等しい場合は true。 |  Number  | 
|  間  |  ターゲットが特定の値の範囲またはタイムスタンプ内にある場合は true。 |  数値/日付\*  | 
|  NOT\_BETWEEN  |  ターゲットが特定の値の範囲またはタイムスタンプ内にない場合は true。 |  数値/日付\*  | 
|  前  |  ターゲットが指定されたタイムスタンプより前である場合は true。 |  日付  | 
|  後  |  ターゲットが指定されたタイムスタンプより後である場合は true。 |  日付  | 
|  オン  |  ターゲットが指定されたタイムスタンプにある場合は true。 |  日付  | 
+ **ソース**: オブジェクトで属性を定義するために使用されます。
  + 1 つのエントリで許可される属性は 1 つだけ`ObjectAttribute`です。
+ **FieldName**: データマッピングでマッピングされた属性を指すために使用されます。
  + 1 つのエントリで許可される属性は 1 つだけ`ObjectAttribute`です。
+ **ObjectTypeName**: すべてのデフォルトおよびカスタムオブジェクトタイプ名をサポートしますが、`_profile`、、 `_asset` `_order`などの標準オブジェクトタイプはサポートしません。
+ **EventTriggerLimits**:
  +  デフォルトでは、カスタマードメインごとに最大 20 個の同時イベントトリガーを許可します。
  +  デフォルトの呼び出し制限は、プロファイルごと、トリガーごとに 1 日あたり 10 回です。これを上書きするには、`MaxInvocationPerProfile` で `UNLIMITED` を指定します。
  +  **MaxInvocationPerProfile**:
    + 有効範囲: 最小値 1。最大値は 1000 です。(または `UNLIMITED`)
  +  単位:
    + 有効な値: HOURS、DAYS、WEEKS、MONTHS
  +  値:
    + 有効範囲: 最小値 1。最大値 24
+  時間範囲の比較 
  +  Customer Profiles は、標準ライブラリを使用して時間値を解析します。グローバルサービスでは、正確な処理を確保するためにタイムゾーン変換を考慮することが重要です。
+ `EventExpiration` 値はミリ秒単位で指定されます。キャンペーンのトリガーに使用すると、最大有効期限は 15 分に制限されます。

**アウトバウンドキャンペーンイベントトリガー API**
+ **CreateCampaignV2**

  イベントトリガーキャンペーンの作成に必要な変更は、強調表示されたフィールドのみです。残りのフィールドは、スケジュールされたキャンペーンと同じです。

  ```
  {
      "name": "string",
      "connectInstanceId": "string",
      "channelSubtypeConfig": { 
      // or other channel parameters 
          "email": {
              "outboundMode": {
                  "agentless":{
                  }
              },
              "defaultOutboundConfig":{
                  "connectSourceEmailAddress":"example@example.com",
                  "wisdomTemplateArn":"arn:aws:wisdom:us-west-2:123456789012:message-template/dXXXXX0Pc8-195a-776f-0000-EXAMPLE/51219d5c-b1f4-4bad-b8d3-000673332",
                  "sourceEmailAddressDisplayName": "testEmailDisplayName"
              }
          }
      },
      "connectCampaignFlowArn": {{<Flow ARN>}},
      "schedule": {
              "endTime": "2024-12-11T21:22:00Z",
              "startTime": "2024-10-31T20:14:49Z",
              "timeZone": "America/Los_Angeles"
      },
      "source": {
          "eventTrigger": {
              "customerProfilesDomainArn": {{<Domain ARN>}}
  }
  ```
+ **PutProfileOutboundRequestBatch**

  この API を直接呼び出すことはできませんが、Cloudtrail ログに記録されます。この API は、イベントを受信した後にキャンペーンをトリガーするために使用されます。これは、音声通話、E メール、または SMS を開始するメカニズムです。