Skip to main content

概要

ファネル系ツールでは、ファネル(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 を含みます。 パラメータ: 指示例:
  • 「このページの内容を見せて」
  • 「ページの要素構造を確認したい」
ライセンス制のファネルのページではエラー(forbidden)になります。

funnel_page_update

ページを更新します。指定したフィールドのみ更新する部分更新です。未指定のフィールドは既存値が維持されます。
未指定のフィールドは既存値が維持されるため、変更したいフィールドのみ送信できます(nullに上書きされることはありません)。elements / popup_elements を指定すると、配列全体が element_id で既存の要素と同期されます。element_id を付けた要素は送った項目だけ更新、element_id の無い要素は新規追加、配列に含めなかった既存要素は削除、children を省略した要素は既存の子要素を維持します(配列を指定しない場合は既存の要素が維持されます)。
パラメータ: 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 では行えません。 パラメータ: なし 指示例:
  • 「ファネルアクションのグループ一覧を見せて」