このページでは、ディスプレイ＆ビデオ 360 API を使用してターゲティングを管理する際の制限事項とベスト プラクティスについて説明します。
広告申込情報の作成時に割り当てられたターゲティング
一部のターゲティング タイプには、広告申込情報の作成時にデフォルト値が割り当てられます。これらのターゲティング タイプは次のとおりです。
エラーを回避するには、作成時に広告申込情報に割り当てられるターゲティングの完全なスイートを把握しておいてください。bulkListAssignedTargetingOptions を使用すると、広告申込情報に割り当てられているすべてのターゲティングを取得できます。
特定のタイプのターゲティングが割り当てられていない場合、一部の設定は暗黙的に指定されます。たとえば、広告申込情報に TARGETING_TYPE_AUTHORIZED_SELLER_STATUS ターゲティング オプションが割り当てられていない場合、広告の配信時に「認定販売者と再販業者」が使用されます。
ターゲティング オプションが非推奨になる可能性がある
ターゲティング オプションは静的ではありません。少数のオプションは随時非推奨になる可能性があります。非推奨のターゲティング オプションは、広告申込情報の広告配信には影響しません。非推奨になると、これらのオプションの割り当ては解除されます。これらのオプションの取得または割り当てを試みるリクエストはエラーになります。
これらのエラーを回避するには、保存されているターゲット設定オプション ID を定期的に確認してください。割り当てを節約するには、よく使用される ID をキャッシュに保存することをおすすめします。ID を保存すると、ターゲティング オプションが非推奨になったことに気づかない可能性があります。get メソッドを定期的に使用して、保存されているすべてのターゲティング オプション ID を取得し、それらがディスプレイ＆ビデオ 360 で引き続きサポートされていることを確認します。
同じ広告申込情報に対する同時ターゲティング リクエストは失敗する
同時リクエストを使用して広告申込情報の割り当てられたターゲティングまたは設定を更新しようとすると、エラーが返されます。
1 つの広告申込情報に割り当てられた複数のターゲティング オプションを同時に追加または削除するには、1 つの bulkEditAssignedTargetingOptions リクエストを使用します。広告申込情報の設定とターゲティングを更新する場合は、リクエストをキューに登録して、順番に送信されるようにします。
ターゲティングに関する一般的なエラー
ディスプレイ＆ビデオ 360 API を使用してターゲティングを管理する際にエラーが発生する一般的な原因は 3 つあります。
構成エラー
ターゲティングは構成の制限を受けます。これらのルールに違反するようターゲティングを更新しようとすると、リクエストはエラーを返します。
構成エラーは、多くの場合、既存のターゲティングが原因で発生します。これを回避するには、次の操作を行います。
listリクエストを使用して、特定のタイプの既存のターゲティングを取得します。- 既存のターゲティングを確認します。目的の設定を実現するために、追加または削除する必要があるターゲティングを評価します。
bulkEditAssignedTargetingOptionsリクエストを使用してターゲティングを更新します。
親リソースから継承されたターゲティングは削除できませんが、これらのエラーの原因となる可能性があります。
YouTube とパートナーのエラー
ディスプレイ＆ビデオ 360 API を使用して YouTube とパートナーのターゲティングを更新することはできません。このターゲティングを更新しようとするリクエストはエラーを返します。
このターゲティングは次のように定義されます。
同時実行エラー
同じ広告申込情報の設定またはターゲティングを同時に更新するリクエストは、エラーを返すことがあります。
これを回避するには: