Skip to main content
Creative Protocol は、広告キャンペーン向けに AI を活用したクリエイティブ生成とアセット管理を可能にします。本ガイドでは 5 分で最初のクリエイティブを作成する方法を説明します。
技術リファレンス: 本ガイドでは build_creative タスク の使い方を示します。完全な API 仕様はタスクリファレンスを参照してください。

概要

Creative Protocol は AI を用いたクリエイティブ生成を提供します。
  • build_creative: 静的マニフェストまたは動的コードを使い AI でクリエイティブを生成
  • preview_creative: クリエイティブマニフェストのプレビューを生成
  • list_creative_formats: サポートされるクリエイティブフォーマットを探索
アセットは Brand Manifest 経由で提供され、個別のアセットライブラリ管理は不要です。

クイックスタート: 最初のクリエイティブを生成する

ステップ 1: 基本的な生成

ネイティブディスプレイ広告を生成する最もシンプルなリクエスト例:
{
  "message": "Create a simple ad for a coffee shop promotion - 20% off all drinks this week",
  "format_id": {
    "agent_url": "https://creative.adcontextprotocol.org",
    "id": "display_native"
  },
  "output_mode": "manifest"
}

ステップ 2: レスポンスの理解

構造化されたクリエイティブマニフェストが返却されます。
{
  "creative_manifest": {
    "format_id": {
      "agent_url": "https://creative.adcontextprotocol.org",
      "id": "display_native"
    },
    "assets": {
      "headline": {
        "content": "20% Off All Drinks This Week!"
      },
      "description": {
        "content": "Visit our cozy coffee shop and enjoy premium coffee at an unbeatable price."
      },
      "call_to_action": {
        "content": "Visit Today"
      }
    }
  }
}

ステップ 3: クリエイティブの洗練

マニフェストを修正し再生成することで、生成されたクリエイティブを反復できます。
{
  "message": "Make the headline more exciting and add urgency",
  "target_format_id": {
    "agent_url": "https://creative.adcontextprotocol.org",
    "id": "display_native"
  },
  "creative_manifest": {
    "format_id": {
      "agent_url": "https://creative.adcontextprotocol.org",
      "id": "display_native"
    },
    "assets": {
      "headline": {
        "content": "20% Off All Drinks This Week!"
      }
    }
  }
}

よくあるパターン

ブランドマニフェストの活用

ブランドのコンテキストを提供して、より良い生成結果を得ます。
{
  "message": "Create a display ad for our coffee shop promotion",
  "format_id": {
    "agent_url": "https://creative.adcontextprotocol.org",
    "id": "display_300x250"
  },
  "brand_manifest": {
    "url": "https://mycoffeeshop.com",
    "name": "Brew & Co",
    "colors": {
      "primary": "#6F4E37",
      "secondary": "#C4A35A"
    },
    "tone": "warm and inviting"
  },
  "output_mode": "manifest"
}
最小限のブランドマニフェスト: URL のみから手軽に生成を始められます。
{
  "message": "Create a coffee shop ad",
  "format_id": {
    "agent_url": "https://creative.adcontextprotocol.org",
    "id": "display_native"
  },
  "brand_manifest": {
    "url": "https://mycoffeeshop.com"
  }
}
詳細な例は Brand Manifest Reference を参照してください。

保有アセットの利用

既存のアセットを提供し、クリエイティブに組み込みます。
{
  "message": "Create a display ad featuring our signature latte",
  "target_format_id": {
    "agent_url": "https://creative.adcontextprotocol.org",
    "id": "display_300x250"
  },
  "creative_manifest": {
    "format_id": {
      "agent_url": "https://creative.adcontextprotocol.org",
      "id": "display_300x250"
    },
    "assets": {
      "brand_logo": {
        "url": "https://mycoffeeshop.com/assets/logo.png",
        "width": 200,
        "height": 50
      }
    }
  }
}

動的コードの生成

リアルタイムのパーソナライゼーションにはコードモードを使用します。
{
  "message": "Create a weather-responsive coffee ad that shows hot drinks when cold, iced drinks when warm",
  "format_id": {
    "agent_url": "https://creative.adcontextprotocol.org",
    "id": "display_native"
  },
  "output_mode": "code"
}

フォーマットディスカバリー

標準フォーマット

すぐに使える一般的なフォーマット ID:
  • display_native - ネイティブ広告フォーマット
  • display_300x250 - ミディアムレクタングルバナー
  • video_standard_30s - 30 秒動画広告

パブリッシャー固有のフォーマット

パブリッシャーのカスタムフォーマットを使う場合は、ソースを指定します。
{
  "message": "Create a premium video ad",
  "format_id": {
    "agent_url": "https://premium-publisher.com",
    "id": "premium_video_15s"
  },
  "output_mode": "manifest"
}

次のステップ

  • サンプルを見る: 詳細な例は Task Reference を参照
  • 高度な機能を学ぶ: リアルタイム推論や動的クリエイティブ生成を探索
  • 統合ガイド: 既存のクリエイティブワークフローとの統合方法を学ぶ
  • ベストプラクティス: アセット整理とクリエイティブ最適化の戦略

よくある問題

フォーマットが見つからない

フォーマットエラーが出る場合、そのフォーマットをパブリッシャーがサポートしていない可能性があります。次を試してください。
  1. まず標準の AdCP フォーマット(display_native, video_standard_30s)を使用する
  2. パブリッシャーの list_creative_formats エンドポイントを確認する
  3. format_source の URL が正しいか検証する

クリエイティブ品質の問題

出力を改善するには:
  1. メッセージをより具体的にする: 「アーストーンでミニマルなコーヒー広告を作成して」
  2. アセットやガイドラインを含む充実したブランドマニフェストを提供する
  3. context_id を使った会話的な改善機能で反復する

アセット管理

アセットは Brand Manifest 経由で提供します。
  1. ブランドマニフェストに説明的なタグ付きでアセットを含める
  2. リクエストで asset_filters を使い特定アセットを選択する
  3. 大規模な在庫では商品カタログを参照する
最初のクリエイティブを作る準備はできましたか?上記の基本例から始めて試してみてください。