概要
ファネル系ツールでは、ファネル(LP・セールスページ等のWebページ群)の作成・編集・削除を行えます。 ファネルは以下の階層構造を持ちます。ファネル操作
funnel_list
ファネル一覧を取得します。名前で部分一致検索できます。share_source_only で、ファネルアクション・配信アクションの share_funnel / share_funnel_cancel に指定できるファネルだけに絞り込めます。
パラメータ:
指示例:
- 「ファネル一覧を見せて」
- 「“セミナー”を含むファネルを検索して」
funnel_create
ファネルを新規作成します。作成後にfunnel_step_create でステップ、funnel_page_create でページを追加します。
パラメータ:
指示例:
- 「“新商品LP”というファネルを作成して」
funnel_update
ファネルの名前・メモ・JavaScript設定を更新します。JS設定は全ページ共通で適用されます(HTML直接入力のページにも適用)。 パラメータ:
指示例:
- 「このファネルにGTMタグを設定して」
ステップ操作
funnel_step_list
ファネル配下のステップ一覧を取得します。各ステップの公開URL(step_url)を含みます。ステップの更新・並び替えやページ操作で指定する step_id の取得元です。
パラメータ:
指示例:
- 「このファネルのステップ一覧を見せて」
- 「ページのURLを確認したい」
funnel_step_create
ファネルにステップを新規作成します。ステップはページをグループ化する単位です。 パラメータ:
指示例:
- 「“サンクスページ”というステップを追加して」
funnel_step_update
ステップ名を更新します。 パラメータ:
指示例:
- 「このステップ名を”オプトインページ”に変更して」
funnel_step_reorder
ステップの並び順を変更します。全ステップのIDを含める必要があります。 パラメータ:
指示例:
- 「ステップの順番を入れ替えて、サンクスページを最後にして」
ページ操作
funnel_page_list
ステップ配下のページ一覧を取得します。各ページのcontent_type、step_url、page_url を含みます。ページの取得・更新・削除で指定する page_id の取得元です。
パラメータ:
指示例:
- 「このステップのページ一覧を見せて」
funnel_page_create
ページを新規作成します。content_type で要素構造(elements)またはHTML直接入力(raw_html)を選択できます。
主要パラメータ
補足パラメータ
ポップアップ関連パラメータ
要素構造
content_type=elements の場合、ページは以下の階層構造で構成されます。
使用可能な要素タイプとプロパティは、
element_types_funnel と element_types_funnel_properties で取得できます。pc_widthの注意点
指示例:
- 「新しいLPページを作成して」
- 「HTMLで直接ページを作りたい」
funnel_page_get
ページの詳細情報を取得します。要素構造またはhtml_source を含みます。
パラメータ:
指示例:
- 「このページの内容を見せて」
- 「ページの要素構造を確認したい」
funnel_page_update
ページを更新します。指定したフィールドのみ更新する部分更新です。未指定のフィールドは既存値が維持されます。 パラメータ:funnel_page_create と同じパラメータに加えて、対象を特定する以下のパスパラメータが必須です。
注意事項:
content_typeは作成後に変更できません(異なる値を指定するとエラー(bad_request)になります)
- 「このページのヘッドラインを変更して」
- 「ページの背景色を変更して」
funnel_page_delete
ページを削除します。 パラメータ:
指示例:
- 「このページを削除して」
要素リファレンス
element_types_funnel
ページ構築に使える要素タイプの一覧を取得します。デフォルトは基本カテゴリ(layout, content, other)のみです。 パラメータ:
includeの値:
- 「使える要素の種類を見せて」
- 「フォーム要素を含めた要素一覧を取得して」
element_types_funnel_properties
指定した要素タイプのプロパティ定義を取得します。要素に設定可能なプロパティ(色・サイズ・配置等)の詳細仕様を返します。 パラメータ:
指示例:
- 「ボタン要素で設定できるプロパティを教えて」
- 「テキスト要素と画像要素のプロパティ定義を取得して」
統計・登録者
funnel_stats_get
ファネルの全体データを取得します。ステップ×ページ単位のPV・UU・登録数・登録率・売上件数・購入率・売上金額を集計します(管理画面「データ(合算)」画面と同等)。登録数は、フォームからの登録者数に、ボタン要素の「CV計測」を「計測する」にしたボタンのクリック数(IPアドレスによるユニーク数)を加えた値で、登録率もこの値を分子に算出します。 パラメータ:
指示例:
- 「このファネルのデータを見せて」
- 「先月のファネル全体の登録率と売上を集計して」
funnel_stats_daily
ファネルの日ごとデータを取得します。指定ページの日別PV・UU・登録数・売上を集計します(管理画面「データ(日別)」画面と同等)。date_from/date_to 未指定時は直近7日間が対象です。登録数は、日別・合計ともに、フォームからの登録者数に「CV計測」を「計測する」にしたボタンのクリック数(IPアドレスによるユニーク数)を加えた値です。
パラメータ:
指示例:
- 「このファネルの日ごとのデータを見せて」
- 「先週の日別の登録数の推移を教えて」
funnel_subscriber_list
ファネルの登録者(サブスクライバー)一覧を取得します。各ページのフォームから登録された氏名・連絡先・登録経路・UTM・登録日時を返します。 パラメータ:
指示例:
- 「このファネルの登録者一覧を見せて」
- 「特定のページから登録した人の連絡先を確認したい」
登録経路
登録経路は、ファネルのステップ(またはページ)の公開URLに?ftid={登録経路ID} を付けた、流入元ごとのURLです。管理画面「登録経路」と同じ設定を操作できます。一覧は funnel_tracking_list、登録経路別の集計は funnel_tracking_stats を使います。
funnel_tracking_list
ファネルの登録経路一覧を取得します。各登録経路に公開URL(url)・ステップ・ページ・所属する登録経路グループ・登録時のラベル自動付与の設定(auto_label_type / auto_label_name)を含みます。メッセージの配信条件、ファネル統計(funnel_stats_get / funnel_stats_daily)、登録者一覧(funnel_subscriber_list)の絞り込みなど、登録経路ID(tracking_id)を指定する操作のID取得元です。登録経路の作成・更新・削除は funnel_tracking_create / funnel_tracking_update / funnel_tracking_delete で行います。
パラメータ:
指示例:
- 「このファネルの登録経路一覧を見せて」
- 「配信条件で使う登録経路ID(tracking_id)を調べたい」
funnel_tracking_stats
ファネルの登録経路別集計を取得します。登録経路ごとのPV・UU・登録数を返します(管理画面「登録経路分析」画面と同等)。登録数は登録経路ごとの登録者数で、登録者が0件の登録経路に限り「CV計測」を「計測する」にしたボタンのクリック数(IPアドレスによるユニーク数)を返します(登録者がいる登録経路には加算しません)。 パラメータ:
指示例:
- 「登録経路別のPVと登録数を見せて」
- 「どの流入経路が一番登録につながっているか教えて」
funnel_tracking_create
ファネルに登録経路を作成し、公開URL(url)を発行します。管理画面「登録経路」の追加と同等です。ステップ・ページは作成後に変更できません。
パラメータ:
指示例:
- 「このファネルのオプトインページ用に”Instagram広告”という登録経路を作って」
- 「登録経路を作って、そのURLを教えて」
funnel_tracking_get
登録経路の詳細(公開URL・ステップ・ページ・所属グループ・登録時のラベル自動付与の設定)を取得します。一覧と異なり、指定したページが削除済みの登録経路も取得できます。 パラメータ:
指示例:
- 「この登録経路の設定とURLを見せて」
funnel_tracking_update
登録経路を部分更新します。送信した項目のみ更新されます(管理名称・所属グループ・登録時のラベル自動付与)。step_id / page_id は作成後に変更できません(取得結果をそのまま送り返すために受け付けますが、現在と異なる値はエラー(bad_request)になります)。
パラメータ:
指示例:
- 「この登録経路の管理名称を”Instagram広告(2026年秋)“に変更して」
- 「この登録経路を”SNS”グループに移して」
funnel_tracking_delete
登録経路を削除します。登録者・アクセス記録・配信条件に残っている登録経路との紐付けは削除されません。 パラメータ:
指示例:
- 「使っていない登録経路を削除して」
funnel_tracking_group_list
登録経路グループの一覧を全件・表示順で取得します。グループは管理画面「登録経路」の「グループ管理」で作る登録経路の整理用のグループで、funnel_tracking_create / funnel_tracking_update の tracking_group_id に指定します。
パラメータ:
指示例:
- 「このファネルの登録経路グループを見せて」
funnel_tracking_group_create
登録経路グループを作成します。グループ一覧の末尾に追加されます。登録経路の所属はfunnel_tracking_create / funnel_tracking_update の tracking_group_id で指定します。
パラメータ:
指示例:
- 「“広告”という登録経路グループを作って」
funnel_tracking_group_get
登録経路グループの詳細を取得します。 パラメータ:
指示例:
- 「この登録経路グループの情報を見せて」
funnel_tracking_group_update
登録経路グループを部分更新します。name に null を送るとグループ名なしになります(管理画面でグループ名を空にして保存したグループの取得結果をそのまま送り返すためのものです)。
パラメータ:
指示例:
- 「この登録経路グループの名前を”広告(2026年)“に変更して」
funnel_tracking_group_delete
登録経路グループを削除します。登録経路が1件でも所属しているグループは削除できません(エラー(conflict))。先に funnel_tracking_update の tracking_group_id で、所属している登録経路を未分類または他のグループに移してください。
パラメータ:
指示例:
- 「空になった登録経路グループを削除して」
ファネルアクション
ファネルアクション(管理画面「アクション設定」)は、フォームからの登録・決済完了・イベント申込などの後に実行する動作(webhook、バンドルへ登録/停止、継続課金を停止、ファネルの共有ライセンスを発行/停止、Googleスプレッドシートへ追記)をまとめたもので、ファネルページのフォーム要素・決済要素などのaction_id から参照します。配信アカウント配下の配信アクション(message_action_*)とは別のリソースです。シナリオ登録・ラベル付与はファネルアクションの動作にはありません。
funnel_action_list
ファネルアクションの一覧を取得します。管理名称で部分一致検索、アクショングループ・アーカイブ状態で絞り込めます。一覧に動作(details)は含まれないため、動作は funnel_action_get で取得します。
パラメータ:
指示例:
- 「ファネルアクションの一覧を見せて」
- 「“購入後”を含む名前のファネルアクションを探して」
funnel_action_create
ファネルアクションを作成します。details は配列の順に実行される動作で、type ごとに必要な項目が異なります(下の「動作(details)の構造」を参照)。作成したファネルアクションは、ファネルページのフォーム要素・決済要素などの action_id で参照して紐づけます(紐づけは funnel_page_create / funnel_page_update で行います)。
パラメータ:
動作(details)の構造
各要素はtype で動作の種類を指定します。ID を指定する項目は、各一覧ツールが返す文字列の ID です。
- 「フォーム登録後に https://example.com/hook へメールアドレスと名前を送るファネルアクションを作って」
- 「購入後にバンドルへ登録するファネルアクションを作って」
funnel_action_get
ファネルアクションの詳細(動作details を含む)を取得します。
パラメータ:
指示例:
- 「このファネルアクションの動作を見せて」
funnel_action_update
ファネルアクションを部分更新します。指定した項目のみ変更され、省略した項目は既存値を維持します。details を指定すると動作を全件置き換えます(空配列で全削除)。省略すると既存の動作を維持します。取得した details をそのまま送り返した動作については、参照先の再検証を行いません。
パラメータ:
指示例:
- 「このファネルアクションにGoogleスプレッドシートへの追記を追加して」
- 「このファネルアクションをアーカイブして」
funnel_action_delete
ファネルアクションを動作ごと削除します。このファネルアクションを参照しているファネルページの要素では、削除後は動作が実行されなくなります。 パラメータ:
指示例:
- 「このファネルアクションを削除して」
funnel_action_group_list
ファネルアクションのグループ(管理画面「アクション設定」の「グループ管理」で作成するグループ)の一覧を全件・表示順で取得します。funnel_action_create / funnel_action_update の action_group_id と、funnel_action_list の絞り込みに使います。グループの作成・更新・削除は API では行えません。
パラメータ: なし
指示例:
- 「ファネルアクションのグループ一覧を見せて」