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) |
例:
activation_mappings: [
{
"delta_status": "new",
"connector_field": "mode",
"connector_field_value": "append"
},
{
"delta_status": "deleted",
"connector_field": "mode",
"connector_field_value": "delete"
}
]配列内のマッピングの順序によって、結果エクスポートの処理順序が決まります。ワークフローは、表示される順序でマッピングを順次処理します。
例 - 最初に新規プロファイルを処理し、次に削除を処理:
activation_mappings: [
{
"delta_status": "new",
"connector_field": "mode",
"connector_field_value": "append"
},
{
"delta_status": "deleted",
"connector_field": "mode",
"connector_field_value": "delete"
}
]新規プロファイルのみを宛先に送信します。以前にアクティベーションされ、もはや適格でないプロファイルは、プラットフォームに残ります。
activation_mappings: [
{
"delta_status": "new",
"connector_field": "mode",
"connector_field_value": "append"
}
]ユースケース:
- 累積オーディエンスを構築したいBrazeキャンペーン
- 履歴追跡のために削除されたプロファイルを残しておきたいGoogle Adsカスタマーリスト
- 新規見込み客のみを追加するMeta Custom Audiences
新規または変更されたプロファイルを宛先に送信します。
activation_mappings: [
{
"delta_status": "new",
"connector_field": "mode",
"connector_field_value": "append"
},
{
"delta_status": "updated",
"connector_field": "mode",
"connector_field_value": "append"
}
]ユースケース:
- マーケティングプラットフォームでプロファイル属性を更新
- CRMシステムで連絡先情報を更新
- メールマーケティングプラットフォームに設定変更を同期
宛先リストをクリアし、現在適格なプロファイルで置き換えます。
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
- インクリメンタル更新をサポートしていないプラットフォーム
- 正確な同期が必要なシナリオ
新規プロファイルを追加し、もはや適格でないプロファイルを明示的に削除します。
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の例:
activation_mappings: [
{
"delta_status": "new",
"connector_field": "operation",
"connector_field_value": "add"
},
{
"delta_status": "deleted",
"connector_field": "operation",
"connector_field_value": "remove"
}
]すべての結果エクスポートコネクタが動的モード設定をサポートしているわけではありません。マッピングを設定する前に:
- コネクタのドキュメントを確認: コネクタが必要な操作(追加、更新、削除、置換)をサポートしていることを確認します。
- 小さなデータセットでテスト: 本番環境で使用する前に、マッピングが期待どおりに機能することを検証します。
- サポートに問い合わせ: コネクタの機能について不明な点がある場合は、カスタマーサクセス担当者にお問い合わせください。
- TikTok Custom Audiences: ユーザーの削除に対するサポートが制限されています。更新は非同期で処理されます(最大48時間)
- 一部のメールマーケティングプラットフォーム: append操作のみをサポートしている場合があります
1つのワークフローで最大4つのマッピング要素を定義でき、これは4つの差分ステータスタイプ(new、updated、deleted、unchanged)に対応します。
- 各
delta_status値は、マッピング配列内で1回のみ表示される必要があります connector_fieldは、宛先コネクタの有効なフィールドである必要がありますconnector_field_valueは、コネクタでサポートされている必要があります- 少なくとも1つのマッピングを定義する必要があります
新規のカート放棄者をBrazeに送信し、購入を完了した人を削除します。
activation_mappings: [
{
"delta_status": "new",
"connector_field": "mode",
"connector_field_value": "append"
},
{
"delta_status": "deleted",
"connector_field": "mode",
"connector_field_value": "delete"
}
]新規の高価値リードとそのスコア変更をGoogle Adsで更新します。
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に同期し、正確なリストの精度を確保します。
activation_mappings: [
{
"delta_status": "new",
"connector_field": "mode",
"connector_field_value": "replace"
},
{
"delta_status": "updated",
"connector_field": "mode",
"connector_field_value": "replace"
}
]Salesforce B2C Commerce Cloudとの完全な顧客同期を維持し、正確な顧客データのためにフル同期を使用します。
activation_mappings: [
{
"delta_status": "new",
"connector_field": "mode",
"connector_field_value": "append"
},
{
"delta_status": "updated",
"connector_field": "mode",
"connector_field_value": "replace"
}
]