サポート終了のお知らせ

Timeline:

• 2023 年 5 月 17 日: 手動トリガーを使用した広告申込情報は、ディスプレイ＆ビデオ 360 での配信を停止します。この日以降、有効な広告申込情報にリンクされた手動トリガーを有効にした場合、その広告申込情報では広告が配信されなくなります。
• 2023 年 8 月 1 日: DV360 API v1 と v2 の advertisers.manualTriggers サービス、DV360 API v1 の LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER 列挙型値、DV360 API v1 の LineItemFlight.triggerId フィールドが廃止されます。この日以降、これらのサービスまたはこれらのフィールドに対して行われたリクエストはエラーを返します。

おすすめの対処法:

• 広告申込情報の配信の開始と停止に手動トリガーを使用することを直ちに停止してください。
• advertisers.manualTriggers サービスへのリクエストを停止します。
• 手動トリガーを使用して、すべての広告申込情報の flight.flightDateType フィールドと flight.triggerId フィールドを更新します。

Timeline:

• 2023 年 5 月 20 日: GoogleAudienceType が GOOGLE_AUDIENCE_TYPE_INSTALLED_APPS または GOOGLE_AUDIENCE_TYPE_NEW_MOBILE_DEVICES の GoogleAudience リソースを、広告申込情報または広告掲載オーダーのオーディエンス ターゲティングに割り当てることができなくなります。これらのオーディエンスを広告申込情報のオーディエンス ターゲティングに割り当てるリクエストはエラーを返します。これには、作成する広告申込情報のオーディエンス ターゲティングに非推奨のオーディエンスが含まれる場合の advertisers.lineItems.duplicate リクエストと advertisers.lineItems.generateDefault リクエストが含まれます。
• 2023 年 6 月 8 日: 影響を受けるオーディエンスは、すべての広告申込情報と広告掲載オーダーのターゲティングから削除され、すべての統合オーディエンスからも削除されます。これらのオーディエンスが削除されたときに広告を配信できない広告申込情報は、一時停止されます。この日をもって、これらのオーディエンスは googleAudiences サービスを使用して取得できなくなります。

推奨されるタスク:

• 今後広告申込情報のターゲティングを更新する際は、影響を受けるオーディエンスの使用を直ちに停止することをおすすめします。
• 影響を受けるオーディエンスを、既存の広告申込情報と広告掲載オーダーのターゲティングからすべて削除します。オーディエンス ターゲティングの更新については、対象グループ ガイドをご覧ください。

Timeline:

• 2023 年 5 月 20 日: AudienceType が ACTIVITY_BASED または FREQUENCY_CAP の FirstAndThirdPartyAudience リソースを、広告申込情報または広告掲載オーダーのオーディエンス ターゲティングに割り当てることができなくなります。これらのオーディエンスを広告申込情報のオーディエンス ターゲティングに割り当てるリクエストはエラーを返します。これには、作成する広告申込情報のオーディエンス ターゲティングに非推奨のオーディエンスが含まれる場合の advertisers.lineItems.duplicate リクエストと advertisers.lineItems.generateDefault リクエストが含まれます。
• 2023 年 6 月 8 日: 影響を受けるオーディエンスは、すべての広告申込情報と広告掲載オーダーのターゲティングから削除され、すべての統合オーディエンスからも削除されます。これらのオーディエンスが削除されたときに広告を配信できない広告申込情報は、一時停止されます。この日をもって、これらのオーディエンスは firstAndThirdPartyAudiences サービスを使用して取得できなくなります。

推奨されるタスク:

• 今後広告申込情報のターゲティングを更新する際は、影響を受けるオーディエンスの使用を直ちに停止することをおすすめします。
• 影響を受けるオーディエンスを、既存の広告申込情報と広告掲載オーダーのターゲティングからすべて削除します。オーディエンス ターゲティングの更新については、対象グループ ガイドをご覧ください。

2023 年 5 月 30 日をもって、既存の使用上限は、次の機能を備えたハイブリッド割り当て構造に置き換えられます。

1. プロジェクトごとの 1 日あたりのリクエストの割り当てが不要になります。
2. 適格な方法に対して、広告主様ごとのプロジェクトごとの 1 分あたりのリクエスト数に割り当てを設定します。

これらの新しい上限により、API の使用をより柔軟に行うことができ、広告主間でリクエストを並列化できるようになります。この変更の詳細については、既存の割り当て上限に関するドキュメントをご覧ください。

2023 年 6 月 21 日より、LIST リクエストの filter パラメータで、異なるフィールドの制限間で OR 論理演算子を使用できなくなります。

たとえば、フィルタ文字列 lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT" OR insertionOrderId="123" で識別されるリソースは、代わりに次のフィルタ文字列を使用して 2 つの LIST リクエストを使用して取得する必要があります。

• lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT"
• insertionOrderId="123"

論理演算子の制限について詳しくは、LIST リクエストのフィルタリングに関する方法ガイドをご覧ください。

サービスが中断されないように、2023 年 6 月 21 日までに、すべての既存の LIST 呼び出しの filter クエリ パラメータを確認し、OR 論理演算子が正しく使用されていることを確認してください。

最初の発効日が更新されました

2023 年 6 月 21 日をもって、advertisers.insertionOrders.list と advertisers.lineItems.list の filter と orderBy クエリ パラメータで、budget.budget_segments.date_range.end_date と flight.dateRange.endDate のフィールドが使用できなくなります。この日以降、filter クエリ パラメータと orderBy クエリ パラメータでこれらのフィールドを使用するリクエストはエラーを返します。

2023 年 6 月 21 日までに、これらの 2 つのフィールドを使用したフィルタと並べ替えのロジックをすべて削除して、サービスの中断を回避してください。

2023 年 6 月 21 日をもって、advertisers.lineItems.list で次のフィールドによるフィルタリングがサポートされなくなります。

• flight.triggerId
• targetedChannelId
• targetedNegativeKeywordListId
• warningMessages

サービスが中断されないように、2023 年 6 月 21 日までに、これらの 4 つのフィールドを使用したフィルタ ロジックをすべて削除してください。

2023 年 8 月 1 日をもって、billableOutcome フィールド値が BILLABLE_OUTCOME_PAY_PER_CLICK または BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION に設定された成果ベースの購入を使用する広告掲載オーダーと、その子広告申込情報はアーカイブされます。

この変更は、次のリクエストに影響します。

• advertisers.insertionOrders.create を使用して成果ベースの購入で広告掲載オーダーを作成しようとすると、400 エラーが返される
• advertisers.lineItems.create、advertisers.lineItems.duplicate、advertisers.lineItems.generateDefault を使用して、成果に基づく購入を使用して広告掲載オーダーの下に広告申込情報を作成しようとすると、400 エラーが返されます
• アーカイブされたリソースはデフォルトで LIST リクエストに含まれないため、影響を受けるリソースはデフォルトで advertisers.insertionOrders.list メソッドと advertisers.lineItems.list メソッドによって返されなくなります。

2024 年 6 月 26 日より、publisherReviewStatuses フィールドのサポートが終了し、Creative リソースの取得時に空になります。

2024 年 9 月 30 日をもって、YouTube とパートナーの広告申込情報で、以下のターゲティング タイプがサポートされなくなります。

• TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION:
• CONTENT_RATING_TIER_UNRATED
• CONTENT_RATING_TIER_GENERAL
• CONTENT_RATING_TIER_PARENTAL_GUIDANCE
• CONTENT_RATING_TIER_TEENS
• CONTENT_RATING_TIER_MATURE
• CONTENT_RATING_TIER_FAMILIES
• TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION:
• SENSITIVE_CATEGORY_EMBEDDED_VIDEO
• SENSITIVE_CATEGORY_LIVE_STREAMING_VIDEO

サポート終了のターゲティング オプションは、既存の広告申込情報のターゲティングから自動的に削除されます。これらの値は、引き続き広告主レベルのターゲティングで使用できます。

サービスが中断されないようにするには、サポート終了日までに、既存の YouTube とパートナーの広告申込情報からこのターゲティングを削除してください。

2024 年 9 月 30 日に、Oracle の FirstAndThirdPartyAudience リソースソースが廃止されます。サポート終了後は、これらのオーディエンスは既存のリソース ターゲティングと統合オーディエンスから削除されます。広告申込情報でサポート終了のオーディエンスをターゲットに設定している場合、またはサポート終了のオーディエンスを除外している場合、この更新により、その広告申込情報は自動的に一時停止されます。

サービスが中断されないようにするには、サポート終了日までに、既存の広告申込情報のオーディエンス ターゲティングと組み合わせオーディエンスから Oracle オーディエンスを特定して削除してください。

2024 年 9 月 30 日をもって、入札戦略のサブセットを使用するLineItemリソースは、最適化されたターゲティングに対応しなくなります。この変更により、targetingExpansion.enableOptimizedTargeting が True に設定され、bidStrategy.maximizeSpendAutoBid.performanceGoalType が BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA、BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN、BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED に設定されているか、bidStrategy.performanceGoalAutoBid.performanceGoalType が BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM に設定されている LineItem リソースは更新され、targetingExpansion.enableOptimizedTargeting が False に設定されます。

サービスの中断を避けるため、これらの入札戦略を使用している広告申込情報を更新し、最適化されたターゲティングが有効になっていないことを確認してください。

2024 年 11 月 5 日をもって、広告掲載オーダーの pacing フィールドを設定する場合、PACING_TYPE_ASAP は PACING_PERIOD_FLIGHT に対応しなくなります。この構成の既存の広告掲載オーダーの pacingType はすべて PACING_TYPE_AHEAD に更新されます。

サービスの中断を避けるため、PACING_TYPE_ASAP と PACING_PERIOD_FLIGHT を使用して、既存の広告掲載オーダーの pacing を更新します。

2025 年 2 月 28 日:

• LineItem、InsertionOrder、Campaign リソースを作成または更新するリクエストで、FrequencyCap オブジェクトを使用する場合、timeUnit フィールドが TIME_UNIT_LIFETIME に設定されているか、timeUnit フィールドが TIME_UNIT_MONTH に設定され、timeUnitCount フィールドが 2 に設定されていると、400 エラーが返されます。
• 広告申込情報、広告掲載オーダー、キャンペーンの構造化データファイルのエントリで、[Frequency Period] 列の値が [Lifetime] の場合、または [Frequency Period] 列の値が [Months] で [Frequency Amount] 列の値が [2] の場合、ファイルのアップロード時に作成または更新が失敗します。
• 既存のキャンペーン、広告掲載オーダー、広告申込情報は、フリークエンシー キャップの期間が 30 日以内になるように更新されます。

サービスの中断を避けるため、次の点にご注意ください。

• フリークエンシー キャップの期間が 30 日を超える既存のキャンペーン、広告掲載オーダー、広告申込情報のリソースを、30 日以内に更新します。
• ディスプレイ＆ビデオ 360 API または構造化データファイルを使用してキャンペーン、広告掲載オーダー、広告申込情報のリソースを作成または更新する際に、フリークエンシー キャップの期間が 30 日を超えないようにしてください。

2025 年 3 月 6 日:

• LineItem リソースを作成または更新するリクエストで、BiddingStrategy フィールドを fixedBid に、TargetingExpansionConfig フィールドを enableOptimizedTargeting に設定すると、400 エラーが返されます。
• 広告申込情報の構造化データファイルのエントリで、[入札戦略の種類] 列の値が「固定」で、[最適化されたターゲティング] 列の値が「true」の場合、ファイルのアップロード時に作成または更新が失敗します。
• 固定入札を使用している既存の広告申込情報は、最適化されたターゲティングがオフになるよう更新されます。

サービスが中断されないようにするには:

• 固定入札と最適化されたターゲティングの両方を使用する既存の広告申込情報リソースを更新します。
• ディスプレイ＆ビデオ 360 API または構造化データファイルを使用して広告申込情報リソースを作成または更新する際に、固定入札戦略と最適化されたターゲティングが設定されていないことを確認します。

2025 年 3 月 6 日、firstAndThirdPartyAudiences.list リクエストのデフォルトのページサイズが 100 から 5,000 に更新されます。

サービスの中断を回避するには、統合を更新して、firstAndThirdPartyAudiences.list リクエストの pageSize クエリ パラメータを希望するページサイズに設定します。

2025 年 3 月 6 日より、親エンティティ フィルタを使用してセット partnerId の子ではない広告主でフィルタする sdfdownloadtasks.create リクエストは、400 エラーを返すようになります。

2025 年 4 月 1 日:

• ConversionCountingConfig オブジェクトの floodlightActivityConfigs フィールドと、一致する Floodlight アクティビティを使用しない MaximizeSpendBidStrategy オブジェクトまたは PerformanceGoalBidStrategy オブジェクトの customBiddingAlgorithmId フィールドを設定しようとする advertisers.lineItems.create リクエストは、400 エラーを返します。
• MaximizeSpendBidStrategy オブジェクトまたは PerformanceGoalBidStrategy オブジェクトの customBiddingAlgorithmId フィールドが設定されているときに、ConversionCountingConfig オブジェクトの floodlightActivityConfigs フィールドを更新しようとする advertisers.lineItems.patch リクエストは、400 エラーを返します。
• [Algorithm Id] 列が設定されているときに、[Conversion Floodlight Activity Ids] 列を更新しようとする [広告申込情報] 構造化データファイル内のエントリは、ファイルのアップロード時に更新されません。
• 広告申込情報に割り当てられた CustomBiddingAlgorithm リソースに対する customBiddingAlgorithms.patch、customBiddingAlgorithms.rules.create、customBiddingAlgorithms.scripts.create リクエストはエラーを返します。

サービスの中断を避けるため、インテグレーションを以下のように更新してください。

• カスタム入札アルゴリズムの割り当て前または同時に、関連する Floodlight アクティビティが広告申込情報に割り当てられていることを確認します。
• 更新を試みる前に、既存のカスタム入札アルゴリズムはすべての広告申込情報から割り当て解除されます。

2025 年 4 月 7 日より、FirstAndThirdPartyAudience リソースでオーディエンス メンバーシップの有効期間を無期限に設定できなくなります。firstAndThirdPartyAudiences.create リクエストと firstAndThirdPartyAudiences.patch リクエストで membershipDurationDays フィールドの値を 10,000 に設定すると、400 エラーが返されます。membershipDurationDays フィールドの値が 10,000 の既存のオーディエンスは 540 に更新され、新しいメンバーシップの期間が既存のメンバーシップに遡及的に適用されます。これにより、540 日以上経過したすべてのメンバーシップが期限切れになります。

サービスの中断を避けるため、次の点にご注意ください。

• 統合で、新規または既存のオーディエンスの membershipDurationDays フィールド値が 10,000 に設定されていないことを確認します。
• firstAndThirdPartyAudiences.editCustomerMatchMembers を使用して、既存のカスタマー マッチ オーディエンスのメンバーシップを更新します。
• カスタマー マッチのオーディエンス メンバーシップは定期的に更新し、オーディエンスのリストサイズが意図せず小さくならないようにしてください。

v4 では、この変更が FirstPartyAndPartnerAudience リソースに反映されます。

2025 年 5 月 1 日より、広告申込情報の構造化データファイルで [入札単価調整額] 列の設定を試みると、ファイルのアップロード時にリソースの作成または更新が失敗します。