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

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

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

1. Treasure コンソールを開きます。
2. Data Workbench > Master Segmentsに移動します。
3. 既存のペアレントセグメントを選択するか、新しいペアレントセグメントを作成します。詳細については、ペアレントセグメントの作成を参照してください。
4. ビヘイビアカラムマッピングを有効にします。
5. 単一のユーザープロファイルに関連付けることができる行の最大数を設定します。単一のユーザープロファイルに最大20行まで関連付けることができます。

セグメントアクティベーションUI要素の一般的な詳細については、アクティベーション出力のカスタマイズを参照してください。

1. Treasure コンソールを開きます。
2. Audience Studioに移動します。
3. 既存のペアレントセグメントを選択するか、新しいペアレントセグメントを作成します。詳細については、ペアレントセグメントの作成を参照してください。
4. 対象のペアレントセグメント内で、既存のセグメントを選択するか、新しいセグメントを作成します。
5. ビヘイビアデータを選択するように設定されたセグメントルールを使用して、新しいセグメントを作成します。詳細については、セグメントの概要を参照してください。次のスクリーンショットは、購入ビヘイビアなどを選択するセグメントを示しています。

1. セグメントを選択します。

2. 「アクティベーション」タブを選択します。

3. 「アクティベーションの作成」を選択します。

4. 該当する詳細を入力します。テンプレートまたはアクティベーションを選択する際、リストをスクロールしてアクティベーションテンプレートまたは既存のv5アクティベーションを使用できます。

5. 「出力マッピング」を選択します。

6. 「ビヘイビアカラム」セクションで、「テーブルの追加」を選択します。

7. 「カラムの追加」を選択します。ソーステーブルのカラムを出力テーブルの出力カラムにマッピングできます。このマッピングはビヘイビアカラムマッピングと呼ばれます。出力カラム名を変更するオプションがあります。

1. 提供された基準に基づいてビヘイビアが選択されます。エクスポートする行を選択します。
2. 行の選択に基づいて、該当する追加の詳細を設定できます。

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

1. 「並べ替え順序」を選択してカラムを指定し、出力テーブルの順序を設定します。順序と行-カラムのフォーマットの詳細については、アクティベーション出力のカスタマイズを参照してください。

2. （オプション）必要に応じて、ストリングビルダーを使用してカラムを追加できます。これにより、特定のセグメント、キャンペーン、または日時にアクティベーションを追跡または関連付けるのに役立つカスタムテキストを追加できます。詳細については、ストリングビルダーを参照してください。

3. アクティベーションに必要なすべての情報を入力したら、「作成」を選択してアクティベーションを送信します。

1つのアクティベーションで、最大4つのビヘイビアテーブルからデータをアクティベートできます。現時点ではこの機能はAudience APIのみで利用可能です。Treasure AI コンソールでは、上記の通り単一のビヘイビアテーブルの設定に対応しています。この機能の背景については、マルチテーブルBehavior Activationを参照してください。

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

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

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

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

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

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

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

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

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

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

"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 リファレンスを参照してください。

出力テーブルデータは、「エクスポート」、「並べ替え順序」、および「フォーマット」フィールドに基づいて設定されます。

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

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

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

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

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

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

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

各プロファイルについて、すべての行がアクティベートされます。

各プロファイルの最初のレコードがアクティベートされます。

各プロファイルの最後のレコードがアクティベートされます。

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