List Campaigns ノードは、接続済みの Google Ads 顧客アカウントから有効な検索キャンペーンを取得します。
このノードは上流のルックアップステップとして設計されています。その役割は、パフォーマンス分析を実行する前に、後続の Google Ads ノードがデータ取得のフィルタ、ラベル付け、範囲指定に使用するキャンペーンリストを提供することです。
このノードを使用する場面
List Campaigns ノードは、次のようなタスクに使用します。
- 後続のノードの範囲を特定のキャンペーンに絞る: まずキャンペーン ID と名前を取得し、それをフィルタとして Search Terms、Keywords、Landing Pages、Ads に渡します。すべてのキャンペーンのデータを一度に取得する必要はありません
- キャンペーンレベルのパフォーマンスデータにラベルを付ける: 後続のノードの出力にキャンペーン名を付加し、LLM が生成するサマリーを人が読みやすい形にします
- キャンペーンを考慮した Agents を大規模に構築する: 多数のキャンペーンを持つ MCC アカウントで特に有用です。指標を掘り下げる前に、キャンペーンを構造的に把握する必要がある場合に役立ちます
ノードの設定
Google Integration (必須)
接続済みの Google アカウントを選択するか、+ Add integration をクリックし、画面の指示に従ってアカウントを接続します。この設定は 1 回だけで済みます。インテグレーションを追加すると、Profound の Settings > Integrations で削除するまで、以降のすべてのセッションで利用できます。
Google Ads Account (必須)
ドロップダウンから Google Ads の顧客アカウントを選択します。ピッカーでは、MCC アカウントとサブアカウントのどちらも選択できます。
Output label
このステップの出力にわかりやすいラベルを入力します (例: campaigns や active_campaigns)。このラベルは、後続のノードで参照する変数名になります。
このノードは、キャンペーン名、日付、ステータスなどのキャンペーンデータを JSON 形式で出力します。
出力の渡し先:
- Search Terms: キャンペーン ID でフィルタし、そのキャンペーンに対する実際のユーザーのクエリを CTR、CPC、CVR、CPA、ROAS とともに取得します
- Keywords: キーワードの品質スコアと効率の監査を特定のキャンペーンに絞り込みます
- Ads: 特定のキャンペーンの RSA クリエイティブアセット (広告見出しと説明文) のみを取得します
- Prompt LLM: キャンペーンリストを渡して、要約、命名規則の監査、キャンペーン構造の分析を行います
- Code ノードまたは Conditional ノード: キャンペーンデータのフィルタ、並べ替え、切り出しを行ったり、ステータスやキャンペーンの有無などの要素に基づいてワークフローのロジックを分岐させたりします
使用例: 除外キーワードの週次発見
先週のすべてのキャンペーンの検索語句をスキャンし、無駄な広告費を特定して、実行可能な除外キーワードの推奨事項を Slack に投稿する Agent を設定します。構成例は次のとおりです。
1. List Campaigns ノード
- Google Integration を選択し、Google Ads Account にご自身の Google Ads アカウントを設定します
- Output label を
campaigns に設定します
2. Search Terms ノード
- 前のステップと同じ Google Integration と Ads Account を設定します
- Date Range を Last 7 days に設定します
- 必要に応じて Campaigns、Ad Groups、Output Fields のフィルタを設定します
- Output label を
search_term_data に設定します
List Campaigns ノードと Search Terms ノードのデータは、Prompt LLM ノードに直接送るには大きすぎる場合があります。Agent Assistant を使用して、検索語句データを削減する Code ノードなどのデータ前処理ステップを Agent に組み込んでください。
-
次のプロンプトを入力します。
-
Output label を
negative_keyword_report に設定します
4. Slack ノード
- 更新を受け取る Slack ワークスペースとチャンネルを選択します
- メッセージテキストを入力するか、Message フィールドで
negative_keyword_report 変数を使用します
Agent を毎週 (例: 毎週月曜日の午前 9 時) 実行するようにスケジュールします。
ベストプラクティス
他の Google Ads ノードの補助として使用する
List Campaigns はルックアップステップです。その出力を範囲指定のフィルタとして Search Terms、Keywords、Landing Pages、Ads に渡すことで、真価を発揮します。
複数キャンペーンの Agents には Iterations を使用する
後続のノードをキャンペーンごとに個別に実行するには、List Campaigns が返す各キャンペーン ID をループ処理する Iteration ブロックでそれらのノードを囲みます。
まず単一のキャンペーンでテストする
多数のキャンペーンがあるアカウントでは、テスト実行時に 1 つのキャンペーン ID に範囲を絞り、パイプラインを検証してから規模を拡大してください。 
