技術リファレンス: 本ガイドでは build_creative タスク の使い方を示します。完全な API 仕様はタスクリファレンスを参照してください。
概要
Creative Protocol は AI を用いたクリエイティブ生成を提供します。build_creative: 静的マニフェストまたは動的コードを使い AI でクリエイティブを生成preview_creative: クリエイティブマニフェストのプレビューを生成list_creative_formats: サポートされるクリエイティブフォーマットを探索
クイックスタート: 最初のクリエイティブを生成する
ステップ 1: 基本的な生成
ネイティブディスプレイ広告を生成する最もシンプルなリクエスト例:ステップ 2: レスポンスの理解
構造化されたクリエイティブマニフェストが返却されます。ステップ 3: クリエイティブの洗練
マニフェストを修正し再生成することで、生成されたクリエイティブを反復できます。よくあるパターン
ブランドマニフェストの活用
ブランドのコンテキストを提供して、より良い生成結果を得ます。保有アセットの利用
既存のアセットを提供し、クリエイティブに組み込みます。動的コードの生成
リアルタイムのパーソナライゼーションにはコードモードを使用します。フォーマットディスカバリー
標準フォーマット
すぐに使える一般的なフォーマット ID:display_native- ネイティブ広告フォーマットdisplay_300x250- ミディアムレクタングルバナーvideo_standard_30s- 30 秒動画広告
パブリッシャー固有のフォーマット
パブリッシャーのカスタムフォーマットを使う場合は、ソースを指定します。次のステップ
- サンプルを見る: 詳細な例は Task Reference を参照
- 高度な機能を学ぶ: リアルタイム推論や動的クリエイティブ生成を探索
- 統合ガイド: 既存のクリエイティブワークフローとの統合方法を学ぶ
- ベストプラクティス: アセット整理とクリエイティブ最適化の戦略
よくある問題
フォーマットが見つからない
フォーマットエラーが出る場合、そのフォーマットをパブリッシャーがサポートしていない可能性があります。次を試してください。- まず標準の AdCP フォーマット(
display_native,video_standard_30s)を使用する - パブリッシャーの
list_creative_formatsエンドポイントを確認する format_sourceの URL が正しいか検証する
クリエイティブ品質の問題
出力を改善するには:- メッセージをより具体的にする: 「アーストーンでミニマルなコーヒー広告を作成して」
- アセットやガイドラインを含む充実したブランドマニフェストを提供する
context_idを使った会話的な改善機能で反復する
アセット管理
アセットは Brand Manifest 経由で提供します。- ブランドマニフェストに説明的なタグ付きでアセットを含める
- リクエストで
asset_filtersを使い特定アセットを選択する - 大規模な在庫では商品カタログを参照する