> ## Documentation Index
> Fetch the complete documentation index at: https://adcp-docs-ja.pier1.co.jp/llms.txt
> Use this file to discover all available pages before exploring further.

# エンドツーエンドのワークフロー

> Sponsored Intelligence のワークフロー全体 — アカウント設定からカタログ同期、プロダクト探索、メディアバイの作成、配信レポートまで。

# エンドツーエンドのワークフロー

<Steps>
  ## アカウントを設定します

  まず、セラーのケイパビリティを確認してアカウントモデルを把握します。ファーストパーティ AI プラットフォームは通常、明示的なアカウント（各広告主が OAuth で認証します）を必要とします。一方、[アドネットワーク](/docs/sponsored-intelligence/networks)は暗黙的なアカウント（エージェントが `sync_accounts` でブランドを宣言します）を使用する場合があります。

  **例: ファーストパーティ AI プラットフォーム（明示的アカウント）**

  ```json theme={null}
  {
    "adcp": { "major_versions": [3] },
    "supported_protocols": ["media_buy", "creative"],
    "account": {
      "require_operator_auth": true,
      "supported_billing": ["operator"],
      "authorization_endpoint": "https://ads.ai-platform.example.com/oauth/authorize",
      "required_for_products": false,
      "sandbox": true
    }
  }
  ```

  主なシグナル:

  * **`require_operator_auth: true`** — 各広告主が OAuth で認証します
  * **`sandbox: true`** — 統合検証用のテストアカウントが利用可能
  * **`required_for_products: false`** — バイヤーはアカウントを設定する前にプロダクトを閲覧できます

  複数プラットフォームをまとめるアドネットワークは、`require_operator_auth: false` と `supported_billing: ["operator", "agent"]` を宣言する可能性が高い。この場合、エージェントは信頼され、`sync_accounts` でアカウントを宣言します。

  明示的アカウントの場合、OAuth 認証後に `list_accounts` で利用可能なアカウントを探索する:

  ```json theme={null}
  {
    "accounts": [
      {
        "account_id": "acct_novabrand_ai_001",
        "name": "Nova Brand - AI Platform",
        "status": "active",
        "sandbox": false
      },
      {
        "account_id": "acct_novabrand_ai_sandbox",
        "name": "Nova Brand - Sandbox",
        "status": "active",
        "sandbox": true
      }
    ]
  }
  ```

  実際の予算を使う前に、サンドボックスアカウントで統合全体を検証します。

  ## カタログを同期します

  これが最も重要なステップだ — プロダクトとオファリングのデータをプラットフォームに投入し、広告生成やトランザクションの素材を提供します。プロダクトカタログはクリエイティブ生成に活用されます。オファリングカタログはプロモーションやコマースのハンドオフを可能にします。フィードが充実しているほど、プラットフォームはインテントとインベントリのマッチングを改善できます。

  ```json theme={null}
  {
    "account": { "account_id": "acct_novabrand_ai_001" },
    "catalogs": [
      {
        "catalog_id": "product-feed",
        "name": "Nova Brand Product Catalog",
        "type": "product",
        "url": "https://novabrand.example.com/products.xml",
        "feed_format": "google_merchant_center",
        "update_frequency": "daily"
      },
      {
        "catalog_id": "offerings-feed",
        "name": "Nova Brand Promotions",
        "type": "offering",
        "url": "https://novabrand.example.com/offerings.json",
        "feed_format": "custom",
        "update_frequency": "weekly"
      }
    ]
  }
  ```

  プラットフォームは各フィードを取り込む:

  * **プロダクトカタログ** — タイトル、説明、価格、画像がスポンサードレスポンス生成に活用されます
  * **オファリングカタログ** — [SI Chat Protocol](/docs/sponsored-intelligence/si-chat-protocol) のブランドエクスペリエンスハンドオフ向けのプロモーション、サービス、シーズンキャンペーン

  <Tip>
    広告を改善するには、投入するデータを改善する必要がある — カタログ、コンバージョンイベント、ブランドアイデンティティ、コンテンツ基準です。カタログには詳細な説明、複数の画像、構造化された属性を含めます。プラットフォームが何が効果的かを把握できるよう、コンバージョンイベントを送信します。プラットフォームはこれらのデータすべてから広告を生成する — インプットが充実しているほど、アウトプットの質が向上します。
  </Tip>

  ## プロダクトを探索します

  `get_products` に `channels: ["sponsored_intelligence"]` を指定して Sponsored Intelligence プロダクトを検索します:

  ```json theme={null}
  {
    "buying_mode": "brief",
    "brief": "Promote our new wireless headphones to tech-savvy consumers on AI platforms.",
    "brand": {
      "domain": "novabrand.example.com"
    },
    "filters": {
      "channels": ["sponsored_intelligence"]
    }
  }
  ```

  セラーはブリーフに一致するプロダクトを返します。カタログ連動型プロダクトの場合、セラーはどのカタログアイテムが対象かを示す `catalog_match` を含めることがあります。プロダクトタイプの全体像については[プロダクトスペクトラム](/docs/sponsored-intelligence/product-spectrum)を参照。

  ## メディアバイを作成します

  メディアバイは複数の Sponsored Intelligence プロダクトタイプにまたがることができる:

  ```json theme={null}
  {
    "account": { "account_id": "acct_novabrand_ai_001" },
    "brand": {
      "domain": "novabrand.example.com"
    },
    "start_time": "2026-04-01T00:00:00Z",
    "end_time": "2026-04-30T23:59:59Z",
    "packages": [
      {
        "product_id": "sponsored_response_assistant",
        "pricing_option_id": "sr_cpc",
        "budget": 10000,
        "bid_price": 2.50,
        "pacing": "even",
        "optimization_goals": [{
          "kind": "metric",
          "metric": "engagements",
          "target": { "kind": "cost_per", "value": 3.00 },
          "priority": 1
        }]
      },
      {
        "product_id": "ai_search_sponsored",
        "pricing_option_id": "search_cpc",
        "budget": 5000,
        "bid_price": 3.00,
        "pacing": "even",
        "targeting_overlay": {
          "keyword_targets": [
            { "keyword": "wireless headphones", "match_type": "broad" },
            { "keyword": "noise cancelling", "match_type": "phrase" },
            { "keyword": "bluetooth earbuds", "match_type": "broad" }
          ]
        }
      }
    ]
  }
  ```

  スポンサードレスポンスのパッケージは、エンゲージメント単価を最適化するためにメトリクスゴールを持つ `optimization_goals` を使用します。AI 検索パッケージは、関連するクエリにリーチするために `keyword_targets` を使用します。

  ## 配信レポート

  配信レポートには、標準の配信データとともにエンゲージメント指標が含まれます:

  ```json theme={null}
  {
    "reporting_period": {
      "start": "2026-04-01T00:00:00Z",
      "end": "2026-04-14T23:59:59Z"
    },
    "currency": "USD",
    "media_buy_deliveries": [
      {
        "media_buy_id": "mb_ai_001",
        "status": "active",
        "totals": {
          "impressions": 125000,
          "spend": 7200
        },
        "by_package": [
          {
            "package_id": "pkg_sr_001",
            "pricing_model": "cpc",
            "rate": 2.40,
            "currency": "USD",
            "impressions": 85000,
            "spend": 4800,
            "clicks": 2000,
            "delivery_status": "delivering"
          },
          {
            "package_id": "pkg_search_001",
            "pricing_model": "cpc",
            "rate": 3.00,
            "currency": "USD",
            "impressions": 40000,
            "spend": 2400,
            "clicks": 800,
            "delivery_status": "delivering"
          }
        ]
      }
    ]
  }
  ```

  指標の定義とコンバージョントラッキングについては[測定](/docs/sponsored-intelligence/measurement)を参照。
</Steps>