Skip to main content
call_adcp_agent ツールを使うと、任意の AdCP シグナルエージェントに対してこれらのタスクを実行できます。

​
Task Overview

TaskPurposeResponse Time
get_signalsDiscover signals using natural language~60s
activate_signalActivate a signal on a platform/agentMinutes-Hours

​
Typical Workflow

  1. シグナルを探索する: ターゲット要件を自然言語で記述して get_signals を実行
  2. 選択肢を確認する: カバレッジ、価格、デプロイ状況でシグナルを評価
  3. 必要に応じて有効化: プラットフォームで未稼働のシグナルは activate_signal で有効化
  4. キャンペーンで利用: メディアバイのターゲティングにアクティベーションキーを指定

​
Task Reference

​
get_signals

自然言語の説明を基にシグナルを探索し、プラットフォームごとのデプロイ状況を取得します。 
{
  "signal_spec": "High-income households interested in luxury goods",
  "deliver_to": {
    "deployments": [
      {
        "type": "platform",
        "platform": "the-trade-desk",
        "account": "agency-123"
      }
    ],
    "countries": ["US"]
  },
  "filters": {
    "max_cpm": 5.0,
    "catalog_types": ["marketplace"]
  },
  "max_results": 5
}
主要フィールド:
  • signal_spec (string, 必須): 求めるシグナルの自然言語による説明
  • deliver_to (object, 必須): シグナルを利用する場所
    • deployments (array): type, platform/agent_url と任意の account を持つ対象プラットフォーム/エージェント
    • countries (array): シグナルを利用する国の ISO 3166-1 alpha-2 コード（大文字推奨、大小は不問）
  • filters (object, 任意): catalog_types、data_providers、max_cpm、min_coverage_percentage で絞り込み
  • max_results (number, 任意): 返却結果数の上限
Deployment types: 
// DSP platform
{ "type": "platform", "platform": "the-trade-desk", "account": "agency-123" }

// Sales agent
{ "type": "agent", "agent_url": "https://salesagent.example.com" }
レスポンスに含まれるもの:
  • signals: 条件に合致したシグナルの配列
    • signal_agent_segment_id: activate_signal で使用
    • name, description: シグナル情報
    • data_provider: シグナルデータの提供元
    • coverage_percentage: エージェント人口に対する到達度
    • deployments: プラットフォームごとの is_live、activation_key、estimated_activation_duration_minutes
    • pricing: CPM と通貨

​
activate_signal

特定のプラットフォームまたはエージェントでシグナルを利用できるよう有効化します。 
{
  "signal_agent_segment_id": "luxury_auto_intenders",
  "deployments": [
    {
      "type": "platform",
      "platform": "the-trade-desk",
      "account": "agency-123-ttd"
    }
  ]
}
主要フィールド:
  • signal_agent_segment_id (string, 必須): get_signals のレスポンスで返された値
  • deployments (array, 必須): type, platform/agent_url と任意の account を持つデプロイ先
レスポンスに含まれるもの:
  • deployments: デプロイ先ごとの有効化結果
    • activation_key: ターゲティングに使用するキー（セグメント ID または key-value）
    • deployed_at: 有効化完了時の ISO タイムスタンプ
    • estimated_activation_duration_minutes: 非同期の場合の残り時間
  • errors: 発生した警告やエラー

​
Key Concepts

​
Deployment Targets

シグナルは次の 2 種類のターゲットに有効化できます。 DSP Platforms: 
{
  "type": "platform",
  "platform": "the-trade-desk",
  "account": "agency-123"
}
Sales Agents: 
{
  "type": "agent",
  "agent_url": "https://wonderstruck.salesagents.com"
}

​
Activation Keys

シグナルが稼働状態になると、レスポンスにターゲティング用のアクティベーションキーが含まれます。 Segment ID format (typical for DSPs): 
{
  "type": "segment_id",
  "segment_id": "ttd_segment_12345"
}
Key-Value format (typical for sales agents): 
{
  "type": "key_value",
  "key": "audience_segment",
  "value": "luxury_auto_intenders"
}

​
Signal Types

  • marketplace: データプロバイダーからライセンス供与（CPM 課金）
  • custom: 特定のプリンシパルアカウント向けに構築
  • owned: 自社データを元にしたプライベートシグナル（費用なし）

​
Coverage Percentage

エージェントの人口に対するシグナルの到達度を示します。
  • 99%: ほぼすべての識別子にマッチする非常に広いシグナル
  • 50%: 中程度の広さ
  • 1%: 非常にニッチなシグナル

​
Asynchronous Operations

シグナルの有効化には時間がかかる場合があります。レスポンスを確認してください。
  • is_live: true + activation_key: すぐに利用可能
  • is_live: false + estimated_activation_duration_minutes: 有効化進行中
ポーリングまたは Webhook で完了状況を確認してください。

​
Error Handling

よくあるエラーコード:
  • SIGNAL_AGENT_SEGMENT_NOT_FOUND: 無効な signal_agent_segment_id
  • ACTIVATION_FAILED: シグナルを有効化できない
  • ALREADY_ACTIVATED: 指定ターゲットで既に有効
  • DEPLOYMENT_UNAUTHORIZED: プラットフォーム/アカウントの権限がない
  • AGENT_NOT_FOUND: プリンシパルから非公開のプライベートエージェント
  • AGENT_ACCESS_DENIED: シグナルエージェントへのアクセス権がない
エラーレスポンス例: 
{
  "errors": [
    {
      "code": "DEPLOYMENT_UNAUTHORIZED",
      "message": "Account not authorized for this data provider",
      "field": "deployment.account",
      "suggestion": "Contact your account manager to enable access"
    }
  ]
}