​

バイヤーブリーフと get_products リクエスト形状

​

メンタルモデル

​

ブリーフに入るもの

• キャンペーン目的: 認知、検討、適格トラフィック、来店、コンバージョン、更新
• 人間の言葉でのオーディエンス記述
• 製品、オファー、季節的コンテキスト、またはクリエイティブの方向性
• ファミリー適合性や競合隣接性のような、理解必須の機微
• メトリックフィルターではない成功言語、例えば「信頼される編集環境を優先」

{
  "buying_mode": "brief",
  "brief": "Launch Nova Running's spring trail shoe line with outdoor enthusiasts. Favor trusted adventure and fitness contexts, avoid discount-led positioning, and prioritize packages that can support a brand-lift readout.",
  "brand": {
    "domain": "novarunning.example"
  }
}

​

フィルターに入るもの

• 必須チャネルまたはフォーマット
• 必須ジオターゲティングサポート
• 必須の測定またはレポートケイパビリティ
• 価格通貨制約
• 予算範囲
• 固定価格要件
• ホールセール / カタログ用途の製品カテゴリー

{
  "buying_mode": "brief",
  "brief": "Launch Nova Running's spring trail shoe line with outdoor enthusiasts. Favor trusted adventure and fitness contexts.",
  "brand": {
    "domain": "novarunning.example"
  },
  "filters": {
    "channels": ["ctv", "display"],
    "pricing_currencies": ["USD"],
    "required_metrics": ["impressions", "clicks"]
  }
}

​

ブリーフ対 refine

​

実装チェックリスト

• セラーを呼ぶ前に、人間のリクエストを意図、ハードな制約、フォローアップの変更に正規化する。
• バイヤーのビジネス言語を brief に保つ; それをキーワードだけに崩さない。
• 型付き制約を filters に置き、セラーが filter_diagnostics を通じて除外を説明できるようにする。
• brief を wholesale モードから外す。
• 後の refine 呼び出しと wholesale_feed_version 比較が正しくスコープされるよう、リクエストタプルをレスポンスとともに永続化する。

​

練習プロンプト

Acme Meals の新しいファミリーディナーキットのための 6 週間のローンチが必要。CTV またはオンラインビデオが欲しく、USD 価格のみ、子供のいる親に適したもの、そして完了率レポートが必要。

• ブリーフ: ファミリーディナーキットのローンチ、親オーディエンス、適したコンテキスト、6 週間のローンチ。
• フィルター: ビデオ対応チャネル / フォーマット制約、USD 価格、完了率レポート。
• ブランド: Acme Meals ドメインまたは BrandRef。