ディスプレイ＆ビデオ 360 の Deal Sync API との統合に関するよくある質問とその回答をご紹介します。
Q: Exchange ID は何ですか？
A: エクスチェンジ ID は、認証設定時にディスプレイ＆ビデオ 360 チームによって割り当てられます。
Q: 注文と商品の階層の目的は何ですか？
A: この階層により、パブリッシャーと広告主は複数の取引を交渉し、1 つの交渉オブジェクトとしてまとめて送信できます。制限事項として、注文内のすべての商品は同じ取引タイプと価格タイプを共有する必要があります。1 つの注文に 1 つの商品という設定を常に使用しても問題ありません。
Q: すべての広告主が利用できる取引タイプはありますか？
A: Deal Sync API はプライベート取引向けに設計されています。すべての広告主様向けに厳選された公開取引については、オークション パッケージ（広告枠パッケージ）をご覧ください。
Q: 案件に終了日が設定されていない場合はどうなりますか？
A: 終了日は必須なので、将来の日付を設定すれば問題ありません。指定できる最大年は 2036 年です。終了日は、後で更新または延長できます。
Q: dimensionCreativeConfig フィールドで複数のサイズを指定できますか？
A: はい。ただし、プロダクトごとに許可されるクリエイティブ タイプは 1 つのみです。
Q: ネイティブ クリエイティブはプログラマティック保証型（PG）取引でサポートされていますか？
A: いいえ。予約（保証型）取引では、ネイティブ クリエイティブ（CREATIVE_TYPE_NATIVE）はサポートされていません。
ネイティブ クリエイティブを受け入れるプログラマティック保証型取引を実施する場合は、Google の担当者にお問い合わせください。
Q: 予約済み取引でオークション価格を受け付けますか？
A: いいえ。予約型（保証型）取引では固定価格のみがサポートされます。
Q: 動画のプログラマティック保証型（PG）取引では再生時間が必要ですか？
A: いいえ。設定しなかった場合、期間はデフォルトで ANY になります。
Q: 注文ステータスによって取引が停止されることはありますか？
A: いいえ。注文は純粋に交渉オブジェクトです。広告主様が注文書を承認するまで、広告配信に反映されません。
Q: エクスチェンジが更新呼び出しを送信した場合、承認済みの取引はどうなりますか？
A: 以前に承認された条件で引き続き配信されます。広告主様が更新された利用規約に同意すると、新しい利用規約で取引の配信が開始されます。
Q: 更新された利用規約にまだ同意していない場合、取引は引き続き配信されますか？
A: CPM がすでにエクスチェンジ側で変更され、入札リクエストに反映されていると仮定します。
- 予約取引の場合: 広告主様が再度承認するまで、取引は費用を消費しません。広告申込情報は取引条件に基づいて生成されます。更新は、広告主様が承認するまで交渉中のままになります。
- 予約以外の取引の場合: 配信は、取引をターゲットに設定している広告申込情報のターゲティングによって異なります。入札リクエストがこの取引をターゲットとする広告申込情報の条件と一致する場合、配信は継続されます。
Q: 複数の取引で取引 ID を再利用できますか？
A: いいえ。external_deal_id はすべてのプロダクトで一意である必要があります。
Q: 1 つの取引に複数のパートナーを設定できますか？
A: 取引を複数のパートナーに関連付ける場合は、セントラル パートナーに取引を送信します。
Q: 取引に関連付けられたパートナー ID は、作成後に変更できますか？
A: いいえ。オーダーの作成後にパートナーを変更することはできません。
Q: 注文で複数のパブリッシャー名をサポートしていますか？
A: パブリッシャー名のフィールドは、広告主様向けの参考情報として使用される文字列です。複数のパブリッシャー名をカンマで区切って指定するか、「Exchange X の複数のパブリッシャー」と指定します。
Q: 注文ステータスの「CANCELED（キャンセル済み）」と「ARCHIVED（アーカイブ済み）」の違いは何ですか？
A: 注文をアーカイブして復元できます。キャンセルした注文を再度有効にしたり、キャンセルを取り消したりすることはできません。
Q: 「インスタント取引」とは何ですか？
A: インスタント ディールは、Seller API エンドポイントを使用する別の統合作業です。インスタント ディール固有の属性は無視してください。これらはディール同期ワークフローに関連していません。
Q: Bad Request エラーが表示された場合は、何を確認すればよいですか？
A: 一般的な原因としては、次のようなものが考えられます。
- リファレンス ガイドで、すべての必須フィールドが入力されていることを確認します。
external_deal_idがすべての商品で一意であることを確認します。- 予約取引でオークション価格が指定されていないことを確認します。
問題が解決しない場合は、Postman などの HTTP クライアントでリクエストをテストし、レスポンス本文で詳細なエラー メッセージを確認します。
上記の解決策で問題が解決しない場合は、ディスプレイ＆ビデオ 360 Seller API サポートチームにお問い合わせください。