公開投稿参照クリエイティブ
公開投稿参照クリエイティブは、セラーがプラットフォーム認可とレビューの後に解決してサーブする既存の投稿です。それらは新しいformat_kind を必要としません: クリエイティブ形状は依然として video_hosted、image、または native_in_feed です。違いは、バイヤーがアップロードされたメディアバイトの代わりに published_post 参照を出荷することです。
このパターンは、ソースオブジェクトがパブリッシャー、クリエイター、またはソーシャルプラットフォームに既に存在するブースト/スポンサー投稿製品に使います。カタログ駆動リテールメディアには使わないでください。リテールメディアは source_catalog スロットを持つ sponsored_placement のままです。
製品宣言
製品は正準フォーマットを宣言し、asset_source: "publisher_owned_reference" を設定し、適切なときアップロードされたバイトを拒否し、published_post スロットを使います。
asset_source は情報的です。バインディングコントラクトは依然として params.slots[] です: バイヤーは video アップロードではなく published_post アセットを提出しなければならないことを知ります。
下流接続
公開投稿製品はしばしば 1 つ以上の下流プラットフォーム付与を必要とします。短編動画プラットフォームは、例えば広告を買うための advertiser account 接続と、ソース投稿を所有するクリエイター、ページ、またはプロフィールのための別の publisher identity 接続を要求するかもしれません。 AdCP はそれらを複数の AdCP 認証としてモデル化しません。呼び出し元はセラーに一度認証します。セラーは下流接続を保存して使い、バイヤーに代わってプラットフォームを呼び、それらの要件をparams.required_connections[] で宣言します。
プラットフォーム付与を区別するには connection_type を使います:
それらの下流付与の 1 つが欠けている、期限切れ、または失効しているため呼び出しが進めない場合、
error.details.missing_connections[] を伴う AUTHORIZATION_REQUIRED を返します。各ブロックされたエントリーは、バイヤーが人間を正しいプロバイダー固有の接続フローにルーティングできるよう、provider または authorization_url のいずれかを含まなければなりません。エントリーは authorization_instructions と、投稿 URL やプロフィール URL のような安全な resource_ref ヒントも運べます。
required_for は、広範なカテゴリーではなく具体的な AdCP 操作名を運びます。バイヤーエージェントが接続プロンプトを実行しようとする操作にルーティングできるよう、list_creatives、sync_creatives、create_media_buy、get_media_buy_delivery、get_creative_delivery のような値を優先します。
マニフェストが post_url なしで platform_post_id を使うとき、選択された製品またはフォーマットオプションが既にプラットフォームを絞らない限り platform を含めます。素のプラットフォームネイティブ id はそうでなければプロバイダー名前空間全体で曖昧です。
クリエイティブマニフェスト
クリエイティブマニフェストは、他の任意の 3.1 クリエイティブと同じ正準パスを使います。唯一の新しい部分はアセットペイロードです。error.details(できれば missing_connections[])にリカバリー詳細を伴う AUTHORIZATION_REQUIRED を返します。
published_post アセットの reference_authorization はサーバー発行の認可状態です。セラーは読み取り表面でそれを返してもよいが、プラットフォーム拡張が署名付き証明を定義しセラーがその証明を検証しない限り、書き込みリクエストのバイヤー供給認可状態クレームを無視しなければなりません。
ライフサイクル
公開投稿参照は承認後に利用不可になりうる。問題が回復可能なときsuspended を使います:
アクティブなバイには、suspended クリエイティブは
resource_type: "creative" と transition.to: "suspended" を伴うメディアバイ機能低下も作ります。バイヤーは list_creatives 経由でクリエイティブスナップショットを、get_media_buys 経由でバイスナップショットを照合します。webhook 順序は保証されません。
セラーが後でそのクリエイティブの依存関係が復元できないと判断する場合、identity_authorization_revoked のような同じ理由ファミリーで suspended → rejected に遷移してもよい。バイヤーは次に参照された投稿を置き換えるか別のクリエイティブを再提出する必要があります。
ディスカバリー境界
list_creatives はライブラリ/読み取り表面で、投稿検索 API ではありません。セラーは既に認可されたまたは以前同期された投稿参照を list_creatives の仮想クリエイティブとして露出してもよい(MAY)が、AdCP はセラーにすべてのネイティブプラットフォーム投稿を列挙することを要求しません。
publisher identity 認可を要求するプラットフォームには、list_creatives は接続されたアイデンティティを通じてセラーが見ることを許可された投稿のみを列挙できます。バイヤーが公開投稿ライブラリビューを求め必要な publisher identity 接続が欠けている場合、セラーは投稿がないと黙って暗示するのではなく missing_connections[] を伴う AUTHORIZATION_REQUIRED を返すべきです。
バイヤーが投稿 URL またはプラットフォーム投稿 ID を既に知っているとき、sync_creatives が正準書き込みパスです。認可が欠けているためセラーがまだそれをサーブできない場合、正しいレスポンスは新しいアイデンティティディスカバリータスクではなく AUTHORIZATION_REQUIRED です。