# Incremental Activationマッピング

Incremental Activationはベータ版のリリースです。詳細については、カスタマーサクセス担当者にお問い合わせください。

アクティベーションマッピングは、差分レコードが宛先プラットフォームにどのように送信されるかを定義します。各マッピングは、差分ステータス(新規、更新、削除、または変更なし)を特定のコネクタ設定に接続し、アクティベーション中にさまざまなタイプの変更がどのように処理されるかを制御できます。

## アクティベーションマッピングについて

各ワークフロー実行後、ソーステーブルデータには次のものが含まれる可能性があります。

- **新規行**: セグメントに追加されたプロファイル
- **更新された行**: 属性が変更されたプロファイル
- **削除された行**: セグメントから削除されたプロファイル
- **変更なしの行**: 変更されずに残っているプロファイル


Incremental Activationワークフローは、これらの変更を自動的に識別します。アクティベーションマッピングは、各タイプの変更に対してどのアクションを実行するかを決定します。

## マッピング構造

`activation_mappings`パラメータは、マッピングオブジェクトの配列を受け入れます。各マッピングオブジェクトには3つのフィールドが含まれます。

| フィールド | 必須 | 説明 |
|  --- | --- | --- |
| `delta_status` | はい | 計算された差分レコードステータス:`new`、`updated`、`deleted`、または`unchanged` |
| `connector_field` | はい | コネクタ設定フィールド名(例:Snowflakeの`mode`、Klaviyoの`operation`) |
| `connector_field_value` | はい | コネクタフィールドに設定する値(例:`append`、`replace`、`delete`) |


**例**:


```yaml
activation_mappings: [
  {
    "delta_status": "new",
    "connector_field": "mode",
    "connector_field_value": "append"
  },
  {
    "delta_status": "deleted",
    "connector_field": "mode",
    "connector_field_value": "delete"
  }
]
```

## 処理順序

配列内のマッピングの順序によって、結果エクスポートの処理順序が決まります。ワークフローは、表示される順序でマッピングを順次処理します。

**例 - 最初に新規プロファイルを処理し、次に削除を処理**:


```yaml
activation_mappings: [
  {
    "delta_status": "new",
    "connector_field": "mode",
    "connector_field_value": "append"
  },
  {
    "delta_status": "deleted",
    "connector_field": "mode",
    "connector_field_value": "delete"
  }
]
```

## 一般的なマッピングパターン

### 新規プロファイルのみ追加

新規プロファイルのみを宛先に送信します。以前にアクティベーションされ、もはや適格でないプロファイルは、プラットフォームに残ります。


```yaml
activation_mappings: [
  {
    "delta_status": "new",
    "connector_field": "mode",
    "connector_field_value": "append"
  }
]
```

**ユースケース**:

- 累積オーディエンスを構築したいBrazeキャンペーン
- 履歴追跡のために削除されたプロファイルを残しておきたいGoogle Adsカスタマーリスト
- 新規見込み客のみを追加するMeta Custom Audiences


### 更新されたプロファイルを追加

新規または変更されたプロファイルを宛先に送信します。


```yaml
activation_mappings: [
  {
    "delta_status": "new",
    "connector_field": "mode",
    "connector_field_value": "append"
  },
  {
    "delta_status": "updated",
    "connector_field": "mode",
    "connector_field_value": "append"
  }
]
```

**ユースケース**:

- マーケティングプラットフォームでプロファイル属性を更新
- CRMシステムで連絡先情報を更新
- メールマーケティングプラットフォームに設定変更を同期


### 更新されたプロファイルで置換

宛先リストをクリアし、現在適格なプロファイルで置き換えます。


```yaml
activation_mappings: [
  {
    "delta_status": "new",
    "connector_field": "mode",
    "connector_field_value": "replace"
  },
  {
    "delta_status": "updated",
    "connector_field": "mode",
    "connector_field_value": "replace"
  }
]
```

このモードでは、コネクタが`replace`操作をサポートしている必要があります。宛先プラットフォームとの互換性を確認してください。

**ユースケース**:

- 精密なターゲティングが必要なSalesforce Marketing Cloud
- インクリメンタル更新をサポートしていないプラットフォーム
- 正確な同期が必要なシナリオ


### 更新を追加&不足を削除

新規プロファイルを追加し、もはや適格でないプロファイルを明示的に削除します。


```yaml
activation_mappings: [
  {
    "delta_status": "new",
    "connector_field": "mode",
    "connector_field_value": "append"
  },
  {
    "delta_status": "updated",
    "connector_field": "mode",
    "connector_field_value": "append"
  },
  {
    "delta_status": "deleted",
    "connector_field": "mode",
    "connector_field_value": "delete"
  }
]
```

このモードでは、コネクタが追加/appendと削除/remove操作の両方をサポートしている必要があります。宛先プラットフォームとの互換性を確認してください。

**ユースケース**:

- リストの精度が重要なMeta Custom Audiences
- プロファイルの削除が必要なGDPR/CCPAコンプライアンスシナリオ
- カート放棄オーディエンスを正確に維持する必要があるプラットフォーム


## コネクタ固有のフィールド名

異なるコネクタは、アップロード動作を制御するために異なるフィールド名を使用します。正しいフィールド名については、常にコネクタのドキュメントを参照してください。

### 一般的なコネクタフィールド

| コネクタ | フィールド名 | サポートされる値 |
|  --- | --- | --- |
| Snowflake | `mode` | `insert`, `truncate_insert`, `merge` |
| MySQL | `mode` | `append`, `replace`, `truncate` |
| PostgreSQL | `mode` | `append`, `replace`, `truncate` |
| Google Sheets | `mode` | `append`, `replace` |
| Klaviyo | `operation` | `add`, `remove` |
| Salesforce Marketing Cloud | `mode` | `append`, `replace` |
| Salesforce B2C Commerce Cloud | `mode` | `append`, `replace` |
| Meta Custom Audiences | `action` | `add`, `remove` |


**Klaviyoの例**:


```yaml
activation_mappings: [
  {
    "delta_status": "new",
    "connector_field": "operation",
    "connector_field_value": "add"
  },
  {
    "delta_status": "deleted",
    "connector_field": "operation",
    "connector_field_value": "remove"
  }
]
```

## コネクタの互換性

すべての結果エクスポートコネクタが動的モード設定をサポートしているわけではありません。マッピングを設定する前に:

1. **コネクタのドキュメントを確認**: コネクタが必要な操作(追加、更新、削除、置換)をサポートしていることを確認します。
2. **小さなデータセットでテスト**: 本番環境で使用する前に、マッピングが期待どおりに機能することを検証します。
3. **サポートに問い合わせ**: コネクタの機能について不明な点がある場合は、カスタマーサクセス担当者にお問い合わせください。


### サポートが制限されているコネクタ

- **TikTok Custom Audiences**: ユーザーの削除に対するサポートが制限されています。更新は非同期で処理されます(最大48時間)
- **一部のメールマーケティングプラットフォーム**: append操作のみをサポートしている場合があります


## 最大マッピング数

1つのワークフローで最大**4つのマッピング要素**を定義でき、これは4つの差分ステータスタイプ(`new`、`updated`、`deleted`、`unchanged`)に対応します。

## 検証ルール

- 各`delta_status`値は、マッピング配列内で1回のみ表示される必要があります
- `connector_field`は、宛先コネクタの有効なフィールドである必要があります
- `connector_field_value`は、コネクタでサポートされている必要があります
- 少なくとも1つのマッピングを定義する必要があります


## ユースケース別の例

### Eコマース: カート放棄キャンペーン

新規のカート放棄者をBrazeに送信し、購入を完了した人を削除します。


```yaml
activation_mappings: [
  {
    "delta_status": "new",
    "connector_field": "mode",
    "connector_field_value": "append"
  },
  {
    "delta_status": "deleted",
    "connector_field": "mode",
    "connector_field_value": "delete"
  }
]
```

### B2B: リードスコアリング更新

新規の高価値リードとそのスコア変更をGoogle Adsで更新します。


```yaml
activation_mappings: [
  {
    "delta_status": "new",
    "connector_field": "mode",
    "connector_field_value": "append"
  },
  {
    "delta_status": "updated",
    "connector_field": "mode",
    "connector_field_value": "append"
  }
]
```

### 小売: ロイヤルティティアの変更

ロイヤルティティアの変更をSalesforce Marketing Cloudに同期し、正確なリストの精度を確保します。


```yaml
activation_mappings: [
  {
    "delta_status": "new",
    "connector_field": "mode",
    "connector_field_value": "replace"
  },
  {
    "delta_status": "updated",
    "connector_field": "mode",
    "connector_field_value": "replace"
  }
]
```

### Eコマース: Salesforce B2C Commerce Cloudへのフル同期

Salesforce B2C Commerce Cloudとの完全な顧客同期を維持し、正確な顧客データのためにフル同期を使用します。


```yaml
activation_mappings: [
  {
    "delta_status": "new",
    "connector_field": "mode",
    "connector_field_value": "append"
  },
  {
    "delta_status": "updated",
    "connector_field": "mode",
    "connector_field_value": "replace"
  }
]
```

## 次のステップ

- [Incremental Activationの設定](/ja/products/customer-data-platform/audience-studio/activation/configure-incremental-activation)
- [Incremental Activationパラメータ](/ja/products/customer-data-platform/audience-studio/activation/incremental-activation-parameters)
- [Incremental Activationのトラブルシューティング](/ja/products/customer-data-platform/audience-studio/activation/troubleshooting-incremental-activation)


## 関連トピック

- [Incremental Activationの概要](/ja/products/customer-data-platform/audience-studio/activation/incremental-activation-overview)