# ビヘイビアアクティベーションの設定

この機能はパブリックベータ版リリースです。

このトピックでは、Behavior Activationの有効化と設定方法について説明します。Treasure AI コンソールでの単一のビヘイビアテーブルの設定と、Audience APIを使用した複数のビヘイビアテーブルの設定の両方を扱います。

## ビヘイビアアクティベーションの有効化

ビヘイビアアクティベーションは、ペアレントセグメントレベルで有効にする必要があります。

1. Treasure コンソールを開きます。
2. Data Workbench > Master Segmentsに移動します。
3. 既存のペアレントセグメントを選択するか、新しいペアレントセグメントを作成します。詳細については、[ペアレントセグメントの作成](/products/customer-data-platform/data-workbench/parent-segments/creating-parent-segments)を参照してください。
4. ビヘイビアカラムマッピングを有効にします。
![](/assets/image2023-6-5_16-41-20.dc9e64e5ec6d69f056faee9940d5b155109fdee655b9f33a9652ec131d3de920.cf3845cb.png)
5. 単一のユーザープロファイルに関連付けることができる行の最大数を設定します。単一のユーザープロファイルに最大20行まで関連付けることができます。


## ビヘイビアデータを使用したセグメントのアクティベート

セグメントアクティベーションUI要素の一般的な詳細については、[アクティベーション出力のカスタマイズ](/ja/products/customer-data-platform/audience-studio/activation/customize-activation-output)を参照してください。

1. Treasure コンソールを開きます。
2. Audience Studioに移動します。
![](/assets/image2023-6-5_16-58-36.af34b9b1872d78182020341b35f03cff3d6f2891a54c5bd51823c02c1525461b.cf3845cb.png)
3. 既存のペアレントセグメントを選択するか、新しいペアレントセグメントを作成します。詳細については、[ペアレントセグメントの作成](/products/customer-data-platform/data-workbench/parent-segments/creating-parent-segments)を参照してください。
4. 対象のペアレントセグメント内で、既存のセグメントを選択するか、新しいセグメントを作成します。
5. ビヘイビアデータを選択するように設定されたセグメントルールを使用して、新しいセグメントを作成します。詳細については、[セグメントの概要](/ja/products/customer-data-platform/audience-studio/segment/segments-overview)を参照してください。次のスクリーンショットは、購入ビヘイビアなどを選択するセグメントを示しています。


アクティベートする場合は、セグメントルールでビヘイビアフィールドを選択して使用する必要があります。ビヘイビアフィールドを使用しない場合、アクティベートできません。

![](/assets/image2023-6-26_15-1-58.59a6226afd2e38fb70a34d80a2da6772b7fc97e4bc0fc041a30e764e0103e2c2.cf3845cb.png)

マッチロジックANYを使用し、属性とビヘイビアをアクティベートする場合、アクティベートされたビヘイビアテーブルのルールを満たすレコードがない適格なプロファイルについては、ビヘイビアデータ値がNULLとしてマークされます。詳細については、[NULL値を使用したマッチロジックANYの例](/ja/products/customer-data-platform/audience-studio/segment/rule-operator/match-logic-any-advanced-example)を参照してください。

1. セグメントを選択します。
2. 「アクティベーション」タブを選択します。
![](/assets/image2023-6-6_11-10-17.0ee478cbf89ce549dab2dca5df6051f8b309d117effa01e7acdf55c932ba8190.cf3845cb.png)
3. 「アクティベーションの作成」を選択します。
![](/assets/image2023-6-6_11-5-44.831d59286ea43e2dddc5ea9136722168cc8e4d6ce329452e0aef92b972675592.cf3845cb.png)
4. 該当する詳細を入力します。テンプレートまたはアクティベーションを選択する際、リストをスクロールして**アクティベーションテンプレート**または**既存のv5アクティベーション**を使用できます。
![](/assets/configuring-behavior-activation-2024-09-05.48fa5058eb7fe5138c2332b2544e5bf601cbfa51897fc62e969cb716f72f2a52.cf3845cb.png)
5. 「出力マッピング」を選択します。
6. 「ビヘイビアカラム」セクションで、「テーブルの追加」を選択します。
![](/assets/image2023-6-6_11-18-4.5c91b807a0872c216c3ada8b6a6ad37d424d43e8f78a98fe79fc196b7e970205.cf3845cb.png)
7. 「カラムの追加」を選択します。ソーステーブルのカラムを出力テーブルの出力カラムにマッピングできます。このマッピングはビヘイビアカラムマッピングと呼ばれます。出力カラム名を変更するオプションがあります。


特定のカラムデータでアクティベーションエクスポートデータを順序付けする場合は、ソースカラム名が異なる出力カラム名にマッピングされていないことを確認してください。

![](/assets/image2023-6-26_14-53-21.dea73d549eac5dca4c677532f4792f3d80b99e1260d2f1c8a4262d1c0ab5f07f.cf3845cb.png)

1. 提供された基準に基づいてビヘイビアが選択されます。エクスポートする行を選択します。
![](/assets/image2023-6-6_11-22-32.2da0aca9d10b320faa4be126515dfcae457dbdb97e168b6338688e10ba49baf7.cf3845cb.png)
2. 行の選択に基づいて、該当する追加の詳細を設定できます。


* 「すべての行」または「上位 # 行」が選択されている場合、エクスポートされたビヘイビアデータの各行に対して属性が複製されます。「上位 # 行」を選択する場合は、エクスポートする上位行の数、行を順序付けするカラム、およびテーブルのフォーマットを設定できます。
* プロファイルごとに1行のみをエクスポートする必要がある場合は、「最初の行」または「最後の行」を選択します。行の選択に基づく出力テーブルの例については、[例](/ja/products/customer-data-platform/audience-studio/activation/configuring-behavior-activation#ConfiguringBehaviorActivation-Example)を参照してください。


| オプション | 説明 |
|  --- | --- |
| すべての行 | テーブルのすべての行。 |
| 最初の行 | 最初の行のみ。 |
| 最後の行 | 最後の行のみ。 |
| 上位 # 行 | エクスポートする必要がある上位行の数を指定します。​ |


1. 「並べ替え順序」を選択してカラムを指定し、出力テーブルの順序を設定します。順序と行-カラムのフォーマットの詳細については、[アクティベーション出力のカスタマイズ](/ja/products/customer-data-platform/audience-studio/activation/customize-activation-output)を参照してください。
![image2023-6-6_13-18-48.png](/assets/image2023-6-6_13-18-48.14b3b3ad6a3539e6be68a4dc1db91f0e2d9dbd0ea6c0b4ecf0be50be6f6d2420.cf3845cb.png)
2. （オプション）必要に応じて、ストリングビルダーを使用してカラムを追加できます。これにより、特定のセグメント、キャンペーン、または日時にアクティベーションを追跡または関連付けるのに役立つカスタムテキストを追加できます。詳細については、[ストリングビルダー](/products/customer-data-platform/audience-studio/activation/create-new-strings-for-export-using-string-builder)を参照してください。
3. アクティベーションに必要なすべての情報を入力したら、「作成」を選択してアクティベーションを送信します。


## 複数のビヘイビアテーブルの設定

1つのアクティベーションで、最大4つのビヘイビアテーブルからデータをアクティベートできます。現時点ではこの機能はAudience APIのみで利用可能です。Treasure AI コンソールでは、上記の通り単一のビヘイビアテーブルの設定に対応しています。この機能の背景については、[マルチテーブルBehavior Activation](/ja/products/customer-data-platform/audience-studio/activation/behavior-activation-overview#multi-table-behavior-activations)を参照してください。

### ビヘイビアテーブルの選択

複数のテーブルを設定するには、アクティベーションの作成または更新時に、`syndicationBehavior` フィールド(`syndicationBehaviors` の導入により廃止予定ですが、移行期間中は単一テーブルのアクティベーションでは引き続き利用できます)の代わりに、`syndicationBehaviors` フィールドにテーブル設定の配列を送信します。

* `syndicationBehaviors` には、ビヘイビアテーブル1つにつき1項目、最大4項目を指定できます。
* 各項目の `behaviorTableName` でテーブルを指定します。参照する各テーブルは、単一テーブルのBehavior Activationと同様に、アクティベーションのセグメントルールにも含まれている必要があります。
* 同じビヘイビアテーブルを `syndicationBehaviors` 配列内で複数回指定することはできません。


### カラムのマッピング

各テーブルの `columns` 配列は、単一テーブルで使用されるものと同じビヘイビアカラムマッピングの考え方で、ソースカラムを出力カラムにマッピングします。

* `column` は出力カラム名です。
* `source.column` は、そのビヘイビアテーブル内のカラム名です。
* 出力カラム名は異なるテーブル間で重複しても構いませんが、出力の曖昧さを避けるため、同じテーブルの `columns` 配列内では一意にする必要があります。


### 行数制限の設定

各テーブルの `joinStrategy` フィールドで、そのテーブルからエクスポートする行を選択します。これは、単一テーブルで利用できる「エクスポート」オプションに対応しています。

| オプション | 説明 |
|  --- | --- |
| All | テーブルのすべての行。 |
| First | 最初の行のみ。 |
| Last | 最後の行のみ。 |
| Top-N | 上位N行。Nは `joinRow` で設定します。 |


`joinRow` は `joinStrategy` が `Top-N` の場合にのみ使用され、そのテーブルからプロファイルごとにエクスポートする行数を指定します。

[ビヘイビアアクティベーションの有効化](#enable-behavior-activation)で設定した、プロファイルごとの最大20行の制限は、マルチテーブルのアクティベーションでも変わりません。この制限はテーブルごとではなく、プロファイルが持つすべてのビヘイビアテーブルを合わせた合計として適用されます。

### フォーマットと出力の並べ替え

各テーブルの `formatting` フィールドは、そのテーブルの出力の行-カラムフォーマットを制御し、単一テーブルの「フォーマット」オプションに対応します。

| オプション | 説明 |
|  --- | --- |
| rows | プロファイルごとに複数行。 |
| cols | 行を列に転置。 |


各テーブルの `orderBy` 配列は、そのテーブルのエクスポート行を並べ替えるためのカラム(`key`)と方向(`ascending` または `descending`)を指定します。

### 出力の動作

設定されたテーブルはFULL OUTER JOINで結合され、`syndicationBehaviors` に記載された順序で出力に表示されます。例として、1つ目のテーブルからすべての行をエクスポートし、2つ目のテーブルから `purchased_at` の降順で上位3行をエクスポートする、2テーブル構成の例を示します。

```json
"syndicationBehaviors": [
  {
    "behaviorTableName": "email_subscription",
    "columns": [{ "column": "email", "source": { "column": "email" } }],
    "joinStrategy": "All",
    "formatting": "cols",
    "orderBy": [{ "key": "email", "order": "ascending" }]
  },
  {
    "behaviorTableName": "purchase_history",
    "columns": [{ "column": "product_name", "source": { "column": "product_name" } }],
    "joinStrategy": "Top-N",
    "joinRow": 3,
    "formatting": "rows",
    "orderBy": [{ "key": "purchased_at", "order": "descending" }]
  }
]
```

リクエストおよびレスポンスの詳細については、[Audience API リファレンス](/apis/audience-api)を参照してください。

## ビヘイビアアクティベーションの例

出力テーブルデータは、「エクスポート」、「並べ替え順序」、および「フォーマット」フィールドに基づいて設定されます。
![](/assets/image2023-6-23_18-44-36.90398c972688427b79af7821b54d41f5bd004f108c0550b025ab93d2586391ea.cf3845cb.png)

「エクスポート」には、次の4つの行選択オプションがあります。

* すべての行
* 最初の行
* 最後の行
* 上位 # 行


「並べ替え順序」は、順序を決定するカラム名を設定し、順序オプションはカラムデータ型に基づいています。

![](/assets/image2023-6-6_13-18-48.14b3b3ad6a3539e6be68a4dc1db91f0e2d9dbd0ea6c0b4ecf0be50be6f6d2420.cf3845cb.png)

* アルファベット順（A → Z または Z → A）
* 数値順（最小から最大、または最大から最小）
* タイムスタンプ（最も古いものから最新、または最新から最も古いもの）


「フォーマット」は、次のようにテーブルの行-カラムフォーマットを設定します。

| オプション | 説明 |
|  --- | --- |
| プロファイルごとに複数行 | 各プロファイルに対して複数の行を許可します。 |
| 行を列に転置 | 行を列に変換します。 |


次のソーステーブルサンプルを、次のような属性とビヘイビアの設定で考えます。
ソーステーブル：

![](/assets/image2023-6-26_14-55-12.072dfe77e4242cd02e711f80382986e0abdf48a01314c83b4eb4739e36feb082.cf3845cb.png)

### 属性の設定

![](/assets/image2023-6-23_17-7-48.c54de6c7abbdf83e8ab990ea5d7bcdeb18922c96815dfbe93a2e7ecae6c495b1.cf3845cb.png)

### ビヘイビアの設定

![image2023-6-23_17-4-29.png](/assets/image2023-6-23_17-4-29.c9a7880d1a3405a3a2030cd88e4bc56a151e41ee709a980dbab862afb2e2713c.cf3845cb.png)

### 出力例

次の画像は、「エクスポート」での行選択に基づく出力テーブルの例を示しています。

#### すべての行

各プロファイルについて、すべての行がアクティベートされます。
![](/assets/image2023-6-26_14-56-55.bb3b57bcd886a283720e6daff93a94fc553b57a4c8709dcab0b524d3db9374d6.cf3845cb.png)

#### 最初の行

各プロファイルの最初のレコードがアクティベートされます。
![](/assets/image2023-6-26_14-58-11.f202c0eb422689c45e3c243d287291584fa9aef80edad60fa38bf547ace869d9.cf3845cb.png)

#### 最後の行

各プロファイルの最後のレコードがアクティベートされます。
![](/assets/image2023-6-26_14-58-48.59e0e00807d08c12d7da0b7d24f662765acd8bf0ffbc220fc07c040d05d08d47.cf3845cb.png)

#### 上位 # 行

「#」が3に設定されている場合、各ユーザープロファイルの上位3行がアクティベートされます。

![](/assets/image2023-6-26_14-59-20.dccebb00d5673c769478c872cea6600dfda861613ddc21d8afc75be682079ecc.cf3845cb.png)