MA
DECA MA（マーケティング施策）と連携してマーケティング施策を管理する
アクション
このノードが実行できる処理です。ステップを追加 からノードを追加し、アクションを選びます。
プロジェクト一覧
組織下のすべてのプロジェクト一覧を取得する
設定項目
設定項目はありません。
出力
後続のステップでは、$ の一覧でこのステップを選んでデータを使います。たとえば created_at は $.<ステップID>.output.created_at です。
{
"created_at": "string",
"id": "string",
"name": "string",
"organization_id": "string",
"settings": {},
"updated_at": "string"
}例の値はデータの形を示すもので、実際の値ではありません。前のステップのデータを使う を参照してください。
フィールドの説明
| 項目 | 型 | 説明 |
|---|---|---|
created_at | テキスト | プロジェクトが作成されたタイムスタンプ |
id | テキスト | プロジェクトの一意識別子 |
name | テキスト | プロジェクト名 |
organization_id | テキスト | 組織識別子 |
settings | オブジェクト | プロジェクト設定 |
updated_at | テキスト | プロジェクトが最後に更新されたタイムスタンプ |
セグメント一覧
すべてのセグメント一覧を取得する
設定項目
| 項目 | 型 | 必須 | 説明 |
|---|---|---|---|
| プロジェクト ID | テキスト | はい | セグメントをフィルタするプロジェクト識別子 |
| 検索 | テキスト | セグメントを絞り込む検索語句 | |
| ソート | テキスト | ソート順（例: -id でID降順） 既定値: -id | |
| ページ | 数値 | ページ番号（ページネーション用） 既定値: 1 | |
| 件数/ページ | 数値 | 1ページあたりの項目数 既定値: 30 |
出力
後続のステップでは、$ の一覧でこのステップを選んでデータを使います。たとえば auto_update_flag は $.<ステップID>.output.auto_update_flag です。
{
"auto_update_flag": false,
"conditions": [],
"conditions_combination": "string",
"created_at": "string",
"id": "string",
"matched_type": "matched_all",
"name": "string",
"updated_at": "string"
}例の値はデータの形を示すもので、実際の値ではありません。前のステップのデータを使う を参照してください。
フィールドの説明
| 項目 | 型 | 説明 |
|---|---|---|
auto_update_flag | はい / いいえ | セグメントが自動更新されるかどうか |
conditions[] | リスト | セグメント条件 |
conditions_combination | テキスト | 条件の結合方法 |
created_at | テキスト | セグメントが作成されたタイムスタンプ |
id | テキスト | セグメントの一意識別子 |
matched_type | テキスト | マッチングの種類（例: matched_all, matched_any） |
name | テキスト | セグメント名 |
updated_at | テキスト | セグメントが最後に更新されたタイムスタンプ |
セグメント作成
新しいセグメントを作成する
設定項目
| 項目 | 型 | 必須 | 説明 |
|---|---|---|---|
| プロジェクト ID | テキスト | はい | プロジェクト識別子 |
| データ | コード | はい | セグメントデータペイロード |
出力
後続のステップでは、$ の一覧でこのステップを選んでデータを使います。たとえば auto_update_flag は $.<ステップID>.output.auto_update_flag です。
{
"auto_update_flag": false,
"conditions": [],
"conditions_combination": "string",
"created_at": "string",
"id": "string",
"matched_type": "matched_all",
"name": "string",
"updated_at": "string"
}例の値はデータの形を示すもので、実際の値ではありません。前のステップのデータを使う を参照してください。
フィールドの説明
| 項目 | 型 | 説明 |
|---|---|---|
auto_update_flag | はい / いいえ | セグメントが自動更新されるかどうか |
conditions[] | リスト | セグメント条件 |
conditions_combination | テキスト | 条件の結合方法 |
created_at | テキスト | セグメントが作成されたタイムスタンプ |
id | テキスト | セグメントの一意識別子 |
matched_type | テキスト | マッチングの種類（例: matched_all, matched_any） |
name | テキスト | セグメント名 |
updated_at | テキスト | セグメントが最後に更新されたタイムスタンプ |
CRMビュー一覧
CRMビュー一覧を取得する
設定項目
| 項目 | 型 | 必須 | 説明 |
|---|---|---|---|
| プロジェクト ID | テキスト | はい | CRMビューをフィルタするプロジェクト識別子 |
出力
後続のステップでは、$ の一覧でこのステップを選んでデータを使います。たとえば deca_org_id は $.<ステップID>.output.deca_org_id です。
{
"deca_org_id": "string",
"id": "string",
"name": "string",
"object_id": "string",
"object_name": "string",
"workspace_id": "string"
}例の値はデータの形を示すもので、実際の値ではありません。前のステップのデータを使う を参照してください。
フィールドの説明
| 項目 | 型 | 説明 |
|---|---|---|
deca_org_id | テキスト | DECA組織ID |
id | テキスト | CRMビューの一意識別子 |
name | テキスト | CRMビュー名 |
object_id | テキスト | オブジェクト ID |
object_name | テキスト | オブジェクト名 |
workspace_id | テキスト | ワークスペース識別子 |
マーケティング施策一覧
すべてのマーケティング施策一覧を取得する
設定項目
| 項目 | 型 | 必須 | 説明 |
|---|---|---|---|
| プロジェクト ID | テキスト | はい | マーケティング施策をフィルタするプロジェクト識別子 |
| アクション 名 | テキスト | アクション名でフィルタ (部分一致 — 大文字小文字を区別して含む) | |
| アクションタイプ | 選択 | マーケティングアクションタイプでフィルタリング。 リッチメニューを使用して、特定のセグメントのアクティブなLINEリッチメニューキャンペーンを見つける。 選択肢: リッチメニュー, ポップアップ, 通知, チャットボット, インフロー, 外部, Webhook メッセージ | |
| ステータス | 選択 | 公開ステータスでフィルター 選択肢: 下書き, 承認 保留, アクティブ, 一時停止, 拒否, 終了 | |
| ターゲットセグメント ID | テキスト | この セグメントID を ターゲットに する アクション を フィルタ する（セグメント が アクション の ターゲット_セグメント の メンバー で ある 場合 に 一致 する） | |
| から開始 | 日時 | この日付/時刻以降に start_at があるアクションを返します。 | |
| 開始から | 日時 | 開始 する 時間 が 指定 した 日時 と同じか それ より 前 の アクション を 返します。 | |
| 一つの 結果が 必要 です | はい / いいえ | 有効になっている場合、ゼロまたは複数の一致するアクションが返されると、アクションは失敗します。これをユニーク アクションのルックアップ（例: 特定のセグメント用のアクティブ リッチ メニュー）に使用します。 既定値: false |
出力
後続のステップでは、$ の一覧でこのステップを選んでデータを使います。たとえば created_at は $.<ステップID>.output.created_at です。
{
"created_at": "string",
"description": "string",
"end_at": "string",
"id": "string",
"marketing_action_type": {},
"marketing_action_type_id": 0,
"organization_id": "string",
"project_id": "string",
"settings": {},
"start_at": "string",
"status": "string",
"target_segments": [],
"updated_at": "string"
}例の値はデータの形を示すもので、実際の値ではありません。前のステップのデータを使う を参照してください。
フィールドの説明
| 項目 | 型 | 説明 |
|---|---|---|
created_at | テキスト | マーケティング施策が作成されたタイムスタンプ |
description | テキスト | マーケティング施策の説明 |
end_at | テキスト | マーケティング施策の終了日時 |
id | テキスト | マーケティング施策の一意識別子 |
marketing_action_type | オブジェクト | マーケティング施策タイプの詳細 |
marketing_action_type_id | 数値 | マーケティング施策タイプの ID |
organization_id | テキスト | 組織識別子 |
project_id | テキスト | プロジェクト識別子 |
settings | オブジェクト | マーケティング施策設定 |
start_at | テキスト | マーケティング施策の開始日時 |
status | テキスト | マーケティング施策の状態 |
target_segments[] | リスト | マーケティング施策のターゲットセグメント |
updated_at | テキスト | マーケティング施策が最後に更新されたタイムスタンプ |
マーケティング施策作成
新しいマーケティング施策を作成する
設定項目
| 項目 | 型 | 必須 | 説明 |
|---|---|---|---|
| プロジェクト ID | テキスト | はい | プロジェクト識別子 |
| データ | コード | はい | マーケティング施策データペイロード |
出力
後続のステップでは、$ の一覧でこのステップを選んでデータを使います。たとえば created_at は $.<ステップID>.output.created_at です。
{
"created_at": "string",
"description": "string",
"end_at": "string",
"id": "string",
"marketing_action_type": {},
"marketing_action_type_id": 0,
"organization_id": "string",
"project_id": "string",
"settings": {},
"start_at": "string",
"status": "string",
"target_segments": [],
"updated_at": "string"
}例の値はデータの形を示すもので、実際の値ではありません。前のステップのデータを使う を参照してください。
フィールドの説明
| 項目 | 型 | 説明 |
|---|---|---|
created_at | テキスト | マーケティング施策が作成されたタイムスタンプ |
description | テキスト | マーケティング施策の説明 |
end_at | テキスト | マーケティング施策の終了日時 |
id | テキスト | マーケティング施策の一意識別子 |
marketing_action_type | オブジェクト | マーケティング施策タイプの詳細 |
marketing_action_type_id | 数値 | マーケティング施策タイプの ID |
organization_id | テキスト | 組織識別子 |
project_id | テキスト | プロジェクト識別子 |
settings | オブジェクト | マーケティング施策設定 |
start_at | テキスト | マーケティング施策の開始日時 |
status | テキスト | マーケティング施策の状態 |
target_segments[] | リスト | マーケティング施策のターゲットセグメント |
updated_at | テキスト | マーケティング施策が最後に更新されたタイムスタンプ |
マーケティング施策作成 (通常メッセージ)
通常メッセージで新しいマーケティング施策を作成する
設定項目
| 項目 | 型 | 必須 | 説明 |
|---|---|---|---|
| データ | オブジェクト | マーケティング施策データペイロード |
出力
後続のステップでは、$ の一覧でこのステップを選んでデータを使います。たとえば created_at は $.<ステップID>.output.created_at です。
{
"created_at": "string",
"description": "string",
"end_at": "string",
"id": "string",
"marketing_action_type": {},
"marketing_action_type_id": 0,
"organization_id": "string",
"project_id": "string",
"settings": {},
"start_at": "string",
"status": "string",
"target_segments": [],
"updated_at": "string"
}例の値はデータの形を示すもので、実際の値ではありません。前のステップのデータを使う を参照してください。
フィールドの説明
| 項目 | 型 | 説明 |
|---|---|---|
created_at | テキスト | マーケティング施策が作成されたタイムスタンプ |
description | テキスト | マーケティング施策の説明 |
end_at | テキスト | マーケティング施策の終了日時 |
id | テキスト | マーケティング施策の一意識別子 |
marketing_action_type | オブジェクト | マーケティング施策タイプの詳細 |
marketing_action_type_id | 数値 | マーケティング施策タイプの ID |
organization_id | テキスト | 組織識別子 |
project_id | テキスト | プロジェクト識別子 |
settings | オブジェクト | マーケティング施策設定 |
start_at | テキスト | マーケティング施策の開始日時 |
status | テキスト | マーケティング施策の状態 |
target_segments[] | リスト | マーケティング施策のターゲットセグメント |
updated_at | テキスト | マーケティング施策が最後に更新されたタイムスタンプ |
マーケティング アクションを取得
ID でマーケティング アクションを1つ取得し、設定全体を含める（例：settings.line_rich_menus の下で LINE に公開されたリッチ メニュー ID）。
設定項目
| 項目 | 型 | 必須 | 説明 |
|---|---|---|---|
| プロジェクトID | テキスト | はい | プロジェクト識別子 |
| Marketing Action ID | テキスト | はい | 取得する マーケティング アクション の ID。通常は、前の「リスト マーケティング アクション」ノードから接続される。 |
出力
後続のステップでは、$ の一覧でこのステップを選んでデータを使います。たとえば created_at は $.<ステップID>.output.created_at です。
{
"created_at": "string",
"description": "string",
"end_at": "string",
"id": "string",
"marketing_action_type": {},
"marketing_action_type_id": 0,
"organization_id": "string",
"project_id": "string",
"settings": {},
"start_at": "string",
"status": "string",
"target_segments": [],
"updated_at": "string"
}例の値はデータの形を示すもので、実際の値ではありません。前のステップのデータを使う を参照してください。
フィールドの説明
| 項目 | 型 | 説明 |
|---|---|---|
created_at | テキスト | マーケティング施策が作成されたタイムスタンプ |
description | テキスト | マーケティング施策の説明 |
end_at | テキスト | マーケティング施策の終了日時 |
id | テキスト | マーケティング施策の一意識別子 |
marketing_action_type | オブジェクト | マーケティング施策タイプの詳細 |
marketing_action_type_id | 数値 | マーケティング施策タイプの ID |
organization_id | テキスト | 組織識別子 |
project_id | テキスト | プロジェクト識別子 |
settings | オブジェクト | マーケティング施策設定 |
start_at | テキスト | マーケティング施策の開始日時 |
status | テキスト | マーケティング施策の状態 |
target_segments[] | リスト | マーケティング施策のターゲットセグメント |
updated_at | テキスト | マーケティング施策が最後に更新されたタイムスタンプ |
CSVセグメントアップロード
CSVデータから新しいセグメントをアップロードする
設定項目
| 項目 | 型 | 必須 | 説明 |
|---|---|---|---|
| プロジェクト ID | テキスト | はい | プロジェクト識別子 |
| CSVデータ | コード | はい | CSVデータを表すオブジェクト配列 既定値: email,phone,lineId,TEXT_COLUMN1,TEXT_COLUMN2,TEXT_COLUMN3,TEXT_COLUMN4,TEXT_COLUMN5 a@b.com,,Ua74c67bdb611a4dc9470d41ddc00000c,,,,, |
出力
後続のステップでは、$ の一覧でこのステップを選んでデータを使います。たとえば file_name は $.<ステップID>.output.file_name です。
{
"file_name": "string",
"key": "string",
"name": "string",
"segment": "csv",
"status": "string"
}例の値はデータの形を示すもので、実際の値ではありません。前のステップのデータを使う を参照してください。
フィールドの説明
| 項目 | 型 | 説明 |
|---|---|---|
file_name | テキスト | アップロードされたCSVファイル名 |
key | テキスト | アップロードされたCSVファイルのS3キー |
name | テキスト | CSVセグメントアップロードの表示名 |
segment | テキスト | セグメントタイプ（例: csv） |
status | テキスト | CSVセグメントアップロード処理の状態 |
Libero ラベル一覧
すべての Libero ラベルを取得する
設定項目
| 項目 | 型 | 必須 | 説明 |
|---|---|---|---|
| プロジェクト ID | テキスト | はい | Libero ラベルをフィルタするためのプロジェクト識別子 |
出力
後続のステップでは、$ の一覧でこのステップを選んでデータを使います。たとえば [0].group は $.<ステップID>.output.[0].group です。
[
{
"group": {},
"id": "string",
"name": "string",
"source": "string",
"type": "string"
}
]例の値はデータの形を示すもので、実際の値ではありません。前のステップのデータを使う を参照してください。
フィールドの説明
| 項目 | 型 | 説明 |
|---|---|---|
group | オブジェクト | Libero ラベルのグループ |
id | テキスト | Libero ラベルの一意の識別子 |
name | テキスト | Libero ラベルの名称 |
source | テキスト | Libero ラベルのソース |
type | テキスト | Libero ラベルのタイプ |
アップロードURL生成
セグメントファイルのアップロードURLを生成する
設定項目
| 項目 | 型 | 必須 | 説明 |
|---|---|---|---|
| プロジェクトID | テキスト | はい | プロジェクト識別子 |
出力
後続のステップでは、$ の一覧でこのステップを選んでデータを使います。たとえば key は $.<ステップID>.output.key です。
{
"key": "string",
"presigned_url": "string"
}例の値はデータの形を示すもので、実際の値ではありません。前のステップのデータを使う を参照してください。
フィールドの説明
| 項目 | 型 | 説明 |
|---|---|---|
key | テキスト | S3 object key for the file |
presigned_url | テキスト | Presigned URL for file upload |
セグメント処理初期化
セグメントファイルの処理を初期化する
設定項目
| 項目 | 型 | 必須 | 説明 |
|---|---|---|---|
| プロジェクトID | テキスト | はい | プロジェクト識別子 |
| S3キー | テキスト | はい | アップロード された セグメンテーション ファイル の S3 オブジェクト キー |
| 職種 | テキスト | はい | 開始するセグメント処理ジョブのタイプ 既定値: upload_target_csv |
| ターゲットセグメントグループ | テキスト | セグメントファイル処理の対象セグメントグループ 既定値: include | |
| ターゲットセグメントタイプ | テキスト | セグメントファイル処理対象セグメントタイプ 既定値: csv |
出力
後続のステップでは、$ の一覧でこのステップを選んでデータを使います。たとえば job_id は $.<ステップID>.output.job_id です。
{
"job_id": "string",
"message": "string",
"status": "success"
}例の値はデータの形を示すもので、実際の値ではありません。前のステップのデータを使う を参照してください。
フィールドの説明
| 項目 | 型 | 説明 |
|---|---|---|
job_id | テキスト | Unique identifier for the processing job |
message | テキスト | Additional information about the job status |
status | テキスト | Status of the file processing job (e.g., success, processing, failed) |
Aggregation Report
Get an aggregation report
設定項目
| 項目 | 型 | 必須 | 説明 |
|---|---|---|---|
| Project ID | テキスト | はい | Project identifier |
| Marketing Action ID | テキスト | Marketing Action ID | |
| Target Segment | テキスト | Target segment | |
| Delivery Type | テキスト | Delivery type 既定値: notification | |
| Device Type | テキスト | Device type | |
| From | テキスト | はい | From |
| To | テキスト | はい | To |
出力
後続のステップでは、$ の一覧でこのステップを選んでデータを使います。たとえば aggregation_end は $.<ステップID>.output.aggregation_end です。
{
"aggregation_end": "string",
"aggregation_start": "string",
"alias": "string",
"click_uu": 0,
"cv_amount": 0,
"cv_type": "string",
"cv_uu": 0,
"delivery_uu": 0,
"description": "string",
"display_uu": 0,
"marketing_action_id": "string",
"notification_type": "string",
"open_uu": 0,
"optout_uu": 0,
"organization_id": "string",
"project_id": "string",
"use_uu": 0
}例の値はデータの形を示すもので、実際の値ではありません。前のステップのデータを使う を参照してください。
フィールドの説明
| 項目 | 型 | 説明 |
|---|---|---|
aggregation_end | テキスト | Aggregation end |
aggregation_start | テキスト | Aggregation start |
alias | テキスト | Marketing Action Alias |
click_uu | 数値 | Click UU |
cv_amount | 数値 | Conversion Amount |
cv_type | テキスト | Conversion type |
cv_uu | 数値 | Conversion UU |
delivery_uu | 数値 | Delivery UU |
description | テキスト | Description |
display_uu | 数値 | Display UU |
marketing_action_id | テキスト | Marketing Action ID |
notification_type | テキスト | Notification type |
open_uu | 数値 | Open UU |
optout_uu | 数値 | Optout UU |
organization_id | テキスト | Organization identifier |
project_id | テキスト | Project identifier |
use_uu | 数値 | Use UU |
Delivery Status Report
Get a delivery status report
設定項目
| 項目 | 型 | 必須 | 説明 |
|---|---|---|---|
| Project ID | テキスト | はい | Project identifier |
| Marketing Action ID | テキスト | はい | Marketing Action ID |
出力
後続のステップでは、$ の一覧でこのステップを選んでデータを使います。たとえば aggregation_time は $.<ステップID>.output.aggregation_time です。
{
"aggregation_time": "string",
"error": "string",
"marketing_action_description": "string",
"marketing_action_id": "string",
"organization_id": "string",
"project_id": "string",
"reserved": "string",
"sent": "string"
}例の値はデータの形を示すもので、実際の値ではありません。前のステップのデータを使う を参照してください。
フィールドの説明
| 項目 | 型 | 説明 |
|---|---|---|
aggregation_time | テキスト | Aggregation time |
error | 任意 | |
error.email | 数値 | Number of Emails |
error.line | 数値 | Number of Line messages |
error.sms | 数値 | Number of SMS |
marketing_action_description | テキスト | Marketing Action Description |
marketing_action_id | テキスト | Marketing Action ID |
organization_id | テキスト | Organization identifier |
project_id | テキスト | Project identifier |
reserved | 任意 | |
reserved.email | 数値 | Number of Emails |
reserved.line | 数値 | Number of Line messages |
reserved.sms | 数値 | Number of SMS |
sent | 任意 | |
sent.email | 数値 | Number of Emails |
sent.line | 数値 | Number of Line messages |
sent.sms | 数値 | Number of SMS |