v1 広告枠は、フィード エンティティの階層構造を JSON-LD 形式で表したものです。このスキーマにより、早期アクセス プログラム パートナーはスキーマを使用してエンドツーエンドの注文と統合できるようになりました。v1 インベントリ スキーマのサポートは終了しました。
データフィード仕様の最新版である v2 広告枠は、フラットな構造でリレーショナル スキーマモデルを使用しています。これにより、パートナーはリレーショナル データベースからエンティティを抽出して変換し、より簡単な方法でデータフィードを作成できます。v2 インベントリは、改行区切りの JSON 形式である NDJSON です。
v1 から v2 に移行すべき理由
エンドツーエンドの注文 v1 インベントリ スキーマ統合では、引き続きメンテナンス サポートをパートナー様に提供していますが、新しいパートナーとの統合はすべて v2 インベントリを使用する必要があります。
v2 インベントリの新機能が、v1 インベントリでは使用できない場合があります。例については、ディールをご覧ください。
移行の手順
v2 インベントリを使用するには、個別の注文エンドツーエンド プロジェクトと新しい統合が必要です。次のプロセスでは、v1 インベントリを v2 インベントリに移行する方法について説明します。
- 新しい v2 プロジェクトを作成するには、まず統合の手順を完了します。
- データフィードを実装するには、リレーショナル在庫スキーマを使用します。
- 必要に応じて、v1 プロジェクトのフルフィルメント エンドポイントを再利用します。
- v2 プロジェクトをリリースする準備ができたら、次の手順を行います。
- v2 プロジェクトがリリース準備チェックリストを満たしていることを確認します。
ロールバックの手順
v2 プロジェクトを本番環境にデプロイした後に v1 にロールバックする場合は、v2 プロジェクトでの本番環境リリースのデプロイを解除してから、v1 プロジェクトの本番環境リリースを再デプロイできます。
パートナー データとプロバイダのランキングへの影響
パートナーのデータとプロバイダ ランキングに与え得る影響は次のとおりです。
- v1 プロジェクトのトランザクション ログと分析データは、v2 プロジェクトに転送されません。
- v1 プロジェクトのコンバージョン率や API 指標など、パフォーマンス指標は v2 プロジェクトに移行されません。これにより、Ordering End-to-End でプロバイダのランキングがリセットされます。