ファネルツール - UTAGE API ドキュメント

概要

ファネル系ツールでは、ファネル（LP・セールスページ等のWebページ群）の作成・編集・削除を行えます。ファネルは以下の階層構造を持ちます。

ファネル
  └── ステップ
        └── ページ
              └── 要素（section > row > col > コンテンツ）

ファネル操作

funnel_list

ファネル一覧を取得します。名前で部分一致検索できます。 パラメータ:

パラメータ	型	必須	説明
`name`	string	-	ファネル名で部分一致検索
`page`	integer	-	ページ番号
`per_page`	integer	-	1ページあたりの件数

指示例:

「ファネル一覧を見せて」
「“セミナー”を含むファネルを検索して」

funnel_create

ファネルを新規作成します。作成後に funnel_step_create でステップ、funnel_page_create でページを追加します。 パラメータ:

パラメータ	型	必須	説明
`name`	string	必須	ファネル名（最大255文字）

指示例:

「“新商品LP”というファネルを作成して」

funnel_update

ファネルの名前・メモ・JavaScript設定を更新します。JS設定は全ページ共通で適用されます（Raw HTMLページにも適用）。 パラメータ:

パラメータ	型	必須	説明
`funnel_id`	string	必須	ファネルID
`name`	string	必須	ファネル名（最大255文字）
`memo`	string	-	メモ
`js_head`	string	-	headタグ内に挿入するJavaScript（GTMタグ等）
`js_body_top`	string	-	bodyタグ直後に挿入するJavaScript
`js_body`	string	-	body末尾に挿入するJavaScript

指示例:

「このファネルにGTMタグを設定して」

ステップ操作

funnel_step_list

ファネル配下のステップ一覧を取得します。各ステップの公開URL（step_url）を含みます。 パラメータ:

パラメータ	型	必須	説明
`funnel_id`	string	必須	ファネルID

指示例:

「このファネルのステップ一覧を見せて」
「ページのURLを確認したい」

funnel_step_create

ファネルにステップを新規作成します。ステップはページをグループ化する単位です。 パラメータ:

パラメータ	型	必須	説明
`funnel_id`	string	必須	ファネルID
`name`	string	必須	ステップ名（最大255文字）

指示例:

「“サンクスページ”というステップを追加して」

funnel_step_update

ステップ名を更新します。 パラメータ:

パラメータ	型	必須	説明
`funnel_id`	string	必須	ファネルID
`step_id`	string	必須	ステップID
`name`	string	必須	ステップ名（最大255文字）

指示例:

「このステップ名を”オプトインページ”に変更して」

funnel_step_reorder

ステップの並び順を変更します。全ステップのIDを含める必要があります。 パラメータ:

パラメータ	型	必須	説明
`funnel_id`	string	必須	ファネルID
`step_ids`	array	必須	並び替え後のステップIDの配列（JSON文字列でも可）

指示例:

「ステップの順番を入れ替えて、サンクスページを最後にして」

ページ操作

funnel_page_list

ステップ配下のページ一覧を取得します。各ページの content_type、step_url、page_url を含みます。 パラメータ:

パラメータ	型	必須	説明
`funnel_id`	string	必須	ファネルID
`step_id`	string	必須	ステップID

指示例:

「このステップのページ一覧を見せて」

funnel_page_create

ページを新規作成します。content_type で要素構造（elements）またはHTML直接入力（raw_html）を選択できます。

主要パラメータ

パラメータ	型	必須	説明
`funnel_id`	string	必須	ファネルID
`step_id`	string	必須	ステップID
`title`	string	必須	管理用タイトル
`content_type`	string	-	`elements`（デフォルト）または `raw_html`
`elements`	array	条件付き	要素配列（`content_type=elements` 時に必須）
`html_source`	string	条件付き	HTML文字列（`content_type=raw_html` 時に必須）
`page_title`	string	-	ブラウザのtitleタグ（`elements` のみ）
`pc_width`	integer	-	PC表示時のコンテンツ幅（100=全幅、640-1200px）
`background_color`	string	-	背景色（`#RRGGBB`、全幅時のみ）

補足パラメータ

パラメータ	型	説明
`meta_title`	string	OGPタイトル
`meta_description`	string	OGP説明文（最大500文字）
`meta_og_image`	string	OGP画像URL
`is_no_index`	integer	noindex設定（0=許可、1=不許可）
`border_type`	string	ボーダー（`shadow`, `border`, `none`）
`swipe_type`	string	スワイプ（`none`, `vertical`, `horizontal`）
`background_image_src`	string	背景画像URL
`background_image_style`	string	背景画像表示方式
`js_head`	string	headタグ内JavaScript
`js_body_top`	string	body直後JavaScript
`js_body`	string	body末尾JavaScript
`css`	string	カスタムCSS
`is_high_speed_mode`	integer	高速表示モード（0=無効、1=有効）

ポップアップ関連パラメータ

パラメータ	型	説明
`use_popup`	integer	ポップアップ使用（0=無効、1=有効）
`popup_elements`	array	ポップアップ要素配列
`popup_action`	string	表示条件（`exit`, `exit_all`）
`popup_width`	integer	ポップアップ幅（600-1000px）
`popup_background_color`	string	ポップアップ背景色
`popup_vertical_align`	string	垂直配置（`top`, `centered`）

要素構造

content_type=elements の場合、ページは以下の階層構造で構成されます。

section          ← セクション（最上位）
  └── row        ← 行（横並びレイアウト）
        └── col  ← カラム（列）
              └── text, image, button, form ...  ← コンテンツ要素

[
  {
    "type": "section",
    "children": [
      {
        "type": "row",
        "children": [
          {
            "type": "col",
            "children": [
              {
                "type": "text",
                "content": "<p>テキストコンテンツ</p>"
              }
            ]
          }
        ]
      }
    ]
  }
]

使用可能な要素タイプとプロパティは、element_types_funnel と element_types_funnel_properties で取得できます。

pc_widthの注意点

設定値	動作	background_color
`640`-`1200`	コンテンツが中央配置、指定幅内に収まる	指定しない（崩れる）
`100`	要素がブラウザ全幅に広がる	必要に応じて指定（指定しないと左右が白くなる）

指示例:

「新しいLPページを作成して」
「HTMLで直接ページを作りたい」

funnel_page_get

ページの詳細情報を取得します。要素構造または html_source を含みます。 パラメータ:

パラメータ	型	必須	説明
`funnel_id`	string	必須	ファネルID
`step_id`	string	必須	ステップID
`page_id`	string	必須	ページID

指示例:

「このページの内容を見せて」
「ページの要素構造を確認したい」

ライセンス共有ファネルのページでは403エラーが返ります。

funnel_page_update

ページを更新します。変更箇所以外も全て含めて送信する必要があります。

更新前に必ず funnel_page_get で現在の値を取得し、変更箇所以外もすべて含めて送信してください。未指定のフィールドはnullに上書きされます。

パラメータ: funnel_page_create と同じパラメータに加えて、以下が必須です。

パラメータ	型	必須	説明
`funnel_id`	string	必須	ファネルID
`step_id`	string	必須	ステップID
`page_id`	string	必須	ページID
`title`	string	必須	管理用タイトル（Raw HTMLでも必須）

注意事項:

content_type は作成後に変更できません

指示例:

「このページのヘッドラインを変更して」
「ページの背景色を変更して」

funnel_page_delete

ページを削除します。 パラメータ:

パラメータ	型	必須	説明
`funnel_id`	string	必須	ファネルID
`step_id`	string	必須	ステップID
`page_id`	string	必須	ページID

指示例:

「このページを削除して」

要素リファレンス

element_types_funnel

ページ構築に使える要素タイプの一覧を取得します。デフォルトは基本カテゴリ（layout, content, other）のみです。 パラメータ:

パラメータ	型	必須	説明
`include`	string	-	拡張カテゴリのカンマ区切り

includeの値:

値	説明	ユースケース
`form`	登録フォーム	LP・メルマガ登録・資料請求
`payment`	決済要素	商品販売ページ
`event`	イベント申込	説明会・セミナー・個別相談
`webinar`	自動ウェビナー	ウェビナーページ

// LP用のフォーム要素も含めて取得
include=form

// 決済とフォーム両方を取得
include=form,payment

指示例:

「使える要素の種類を見せて」
「フォーム要素を含めた要素一覧を取得して」

element_types_funnel_properties

指定した要素タイプのプロパティ定義を取得します。要素に設定可能なプロパティ（色・サイズ・配置等）の詳細仕様を返します。 パラメータ:

パラメータ	型	必須	説明
`types`	string	必須	要素タイプ名のカンマ区切り

// テキストとボタンのプロパティを取得
types=text,button

// 画像のプロパティを取得
types=image

レスポンス構造:

フィールド	説明
`global_common_properties`	全要素共通のプロパティ
`content_common_properties`	コンテンツ要素共通（padding, border, background）
`{type}.properties`	要素固有のプロパティ

指示例:

「ボタン要素で設定できるプロパティを教えて」
「テキスト要素と画像要素のプロパティ定義を取得して」

MCP (Model Context Protocol)

​概要

​ファネル操作

​funnel_list

​funnel_create

​funnel_update

​ステップ操作

​funnel_step_list

​funnel_step_create

​funnel_step_update

​funnel_step_reorder

​ページ操作

​funnel_page_list

​funnel_page_create

​主要パラメータ

​補足パラメータ

​ポップアップ関連パラメータ

​要素構造

​pc_widthの注意点

​funnel_page_get

​funnel_page_update

​funnel_page_delete

​要素リファレンス

​element_types_funnel

​element_types_funnel_properties

概要

ファネル操作

funnel_list

funnel_create

funnel_update

ステップ操作

funnel_step_list

funnel_step_create

funnel_step_update

funnel_step_reorder

ページ操作

funnel_page_list

funnel_page_create

主要パラメータ

補足パラメータ

ポップアップ関連パラメータ

要素構造

pc_widthの注意点

funnel_page_get

funnel_page_update

funnel_page_delete

要素リファレンス

element_types_funnel

element_types_funnel_properties