> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryprofound.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Campaigns

> 接続済みの Google Ads アカウントから有効な検索キャンペーンを取得します

**List Campaigns ノード**は、接続済みの Google Ads 顧客アカウントから有効な検索キャンペーンを取得します。

このノードは上流のルックアップステップとして設計されています。その役割は、パフォーマンス分析を実行する前に、後続の Google Ads ノードがデータ取得のフィルタ、ラベル付け、範囲指定に使用するキャンペーンリストを提供することです。

## このノードを使用する場面

List Campaigns ノードは、次のようなタスクに使用します。

* **後続のノードの範囲を特定のキャンペーンに絞る:** まずキャンペーン ID と名前を取得し、それをフィルタとして [Search Terms](/ja-jp/integrations/google-ads/search-terms)、[Keywords](/ja-jp/integrations/google-ads/keywords)、[Landing Pages](/ja-jp/integrations/google-ads/landing-pages)、[Ads](/ja-jp/integrations/google-ads/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](/ja-jp/integrations/google-ads/search-terms): キャンペーン ID でフィルタし、そのキャンペーンに対する実際のユーザーのクエリを CTR、CPC、CVR、CPA、ROAS とともに取得します
* [Keywords](/ja-jp/integrations/google-ads/keywords)**:** キーワードの品質スコアと効率の監査を特定のキャンペーンに絞り込みます
* [Ads](/ja-jp/integrations/google-ads/ads): 特定のキャンペーンの RSA クリエイティブアセット (広告見出しと説明文) のみを取得します
* [Prompt LLM](/ja-jp/agents/nodes/prompt-llm): キャンペーンリストを渡して、要約、命名規則の監査、キャンペーン構造の分析を行います
* **Code ノードまたは** [**Conditional**](/ja-jp/agents/how-tos/add-conditionals) **ノード**: キャンペーンデータのフィルタ、並べ替え、切り出しを行ったり、ステータスやキャンペーンの有無などの要素に基づいてワークフローのロジックを分岐させたりします

## 使用例: 除外キーワードの週次発見

先週のすべてのキャンペーンの検索語句をスキャンし、無駄な広告費を特定して、実行可能な除外キーワードの推奨事項を Slack に投稿する Agent を設定します。構成例は次のとおりです。

**1. List Campaigns ノード**

* **Google Integration** を選択し、**Google Ads Account** にご自身の Google Ads アカウントを設定します
* **Output label** を `campaigns` に設定します

**2.** [Search Terms](/ja-jp/integrations/google-ads/search-terms) **ノード**

* 前のステップと同じ **Google Integration** と **Ads Account** を設定します
* **Date Range** を Last 7 days に設定します
* 必要に応じて **Campaigns**、**Ad Groups**、**Output Fields** のフィルタを設定します
* **Output** label を `search_term_data` に設定します

<Tip>List Campaigns ノードと Search Terms ノードのデータは、Prompt LLM ノードに直接送るには大きすぎる場合があります。**Agent Assistant** を使用して、検索語句データを削減する Code ノードなどのデータ前処理ステップを Agent に組み込んでください。</Tip>

**3.** [Prompt LLM](/ja-jp/agents/nodes/prompt-llm) **ノード**

* 次のプロンプトを入力します。

  ```text expandable wrap theme={null}
  You are a paid search analyst. Review last week's Google Ads search term
  data: {{search_term_data}}.

  Campaigns context: {{campaigns}}.

  Flag terms as negative keyword candidates if they have:
  - Zero conversions and cost over $100
  - CVR below 1% and cost over $50
  - Informational or off-target intent (e.g. "free", "what is", "certification")
  - Competitor branded terms we are not intentionally targeting

  For each flagged term: name, campaign, cost, conversions, reason to negate,
  recommended match type (Exact or Phrase).

  End with: total wasted spend, top 3 negatives to add today.

  Format as a scannable Slack message with bullet points.
  ```

* **Output label** を `negative_keyword_report` に設定します

<Tip>Prompt LLM ノードについては、[プロンプトのベストプラクティス](/ja-jp/agents/how-tos/prompt-llm-best-practices)ガイドをご覧ください。</Tip>

**4.** [Slack](/ja-jp/integrations/slack/overview) **ノード**

* 更新を受け取る Slack ワークスペースとチャンネルを選択します
* メッセージテキストを入力するか、**Message** フィールドで `negative_keyword_report` 変数を使用します

Agent を毎週 (例: 毎週月曜日の午前 9 時) 実行するようにスケジュールします。

## ベストプラクティス

### 他の Google Ads ノードの補助として使用する

List Campaigns はルックアップステップです。その出力を範囲指定のフィルタとして [Search Terms](/ja-jp/integrations/google-ads/search-terms)、[Keywords](/ja-jp/integrations/google-ads/keywords)、[Landing Pages](/ja-jp/integrations/google-ads/landing-pages)、[Ads](/ja-jp/integrations/google-ads/ads) に渡すことで、真価を発揮します。

### 複数キャンペーンの Agents には Iterations を使用する

後続のノードをキャンペーンごとに個別に実行するには、List Campaigns が返す各キャンペーン ID をループ処理する [**Iteration ブロック**](/ja-jp/agents/how-tos/add-iterations)でそれらのノードを囲みます。

### まず単一のキャンペーンでテストする

多数のキャンペーンがあるアカウントでは、テスト実行時に 1 つのキャンペーン ID に範囲を絞り、パイプラインを検証してから規模を拡大してください。