Eingestellte Funktionen und Funktionen

Zeitplan:

• 17. Mai 2023: Die Auslieferung von Werbebuchungen mit manuellen Triggern in Display & Video 360 wird eingestellt. Wenn Sie nach diesem Datum einen manuellen Trigger aktivieren, der mit einer aktiven Werbebuchung verknüpft ist, werden über die Werbebuchung keine Anzeigen ausgeliefert.
• 1. August 2023: Der Dienst advertisers.manualTriggers in der DV360 API v1 und v2, der enum-Wert LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER in der DV360 API v1 und das Feld LineItemFlight.triggerId in der DV360 API v1 werden eingestellt. Danach werden Anfragen an diese Dienste oder an diese Felder mit einem Fehler quittiert.

Empfohlene Maßnahmen:

• Verwenden Sie keine manuellen Trigger mehr, um die Auslieferung von Werbebuchungen zu starten und zu beenden.
• Senden Sie keine Anfragen mehr an den Dienst advertisers.manualTriggers.
• Aktualisieren Sie die Felder flight.flightDateType und flight.triggerId für alle Werbebuchungen mithilfe manueller Trigger.

Zeitplan:

• 20. Mai 2023: Sie können dann keine GoogleAudience-Ressourcen mit einer GoogleAudienceType von GOOGLE_AUDIENCE_TYPE_INSTALLED_APPS oder GOOGLE_AUDIENCE_TYPE_NEW_MOBILE_DEVICES mehr dem Zielgruppen-Targeting von Werbebuchungen oder Anzeigenaufträgen zuweisen. Anfragen, bei denen diese Zielgruppen dem Zielgruppen-Targeting einer Werbebuchung zugewiesen werden, lösen einen Fehler aus. Dazu gehören advertisers.lineItems.duplicate- und advertisers.lineItems.generateDefault-Anfragen, wenn die erstellte Werbebuchung nicht mehr unterstützte Zielgruppen im Zielgruppen-Targeting enthält.
• 8. Juni 2023: Die betroffenen Zielgruppen werden aus allen Targetings für Werbebuchungen und Anzeigenauftragen sowie aus allen kombinierten Zielgruppen entfernt. Wenn für eine Werbebuchung nach dem Entfernen dieser Zielgruppen keine Anzeigen mehr ausgeliefert werden können, wird sie pausiert. An diesem Datum können diese Zielgruppen auch nicht mehr über den Dienst googleAudiences abgerufen werden.

Empfohlene Aufgaben:

• Wir empfehlen Ihnen, die betroffenen Zielgruppen bei zukünftigen Aktualisierungen des Targetings Ihrer Werbebuchung sofort zu entfernen.
• Entfernen Sie alle betroffenen Zielgruppen aus dem Targeting der vorhandenen Werbebuchungen und Anzeigenaufträge. Weitere Informationen zum Aktualisieren des Zielgruppen-Targetings finden Sie in unserem Leitfaden zu Zielgruppen.

Zeitplan:

• 20. Mai 2023: Sie können dann keine FirstAndThirdPartyAudience-Ressourcen mit einer AudienceType von ACTIVITY_BASED oder FREQUENCY_CAP mehr dem Zielgruppen-Targeting von Werbebuchungen oder Anzeigenaufträgen zuweisen. Anfragen, bei denen diese Zielgruppen dem Zielgruppen-Targeting einer Werbebuchung zugewiesen werden, lösen einen Fehler aus. Dazu gehören advertisers.lineItems.duplicate- und advertisers.lineItems.generateDefault-Anfragen, wenn die erstellte Werbebuchung nicht mehr unterstützte Zielgruppen im Zielgruppen-Targeting enthält.
• 8. Juni 2023: Die betroffenen Zielgruppen werden aus allen Targetings für Werbebuchungen und Anzeigenauftragen sowie aus allen kombinierten Zielgruppen entfernt. Wenn für eine Werbebuchung nach dem Entfernen dieser Zielgruppen keine Anzeigen mehr ausgeliefert werden können, wird sie pausiert. An diesem Datum können diese Zielgruppen auch nicht mehr über den Dienst firstAndThirdPartyAudiences abgerufen werden.

Empfohlene Aufgaben:

• Wir empfehlen Ihnen, die betroffenen Zielgruppen bei zukünftigen Aktualisierungen des Targetings Ihrer Werbebuchung sofort zu entfernen.
• Entfernen Sie alle betroffenen Zielgruppen aus dem Targeting der vorhandenen Werbebuchungen und Anzeigenaufträge. Weitere Informationen zum Aktualisieren des Zielgruppen-Targetings finden Sie in unserem Leitfaden zu Zielgruppen.

Am 30. Mai 2023 werden die bestehenden Nutzungslimits durch ein hybrides Kontingent ersetzt, das folgende Vorteile bietet:

1. Das Kontingent für Anfragen pro Tag und Projekt entfällt.
2. Es wird ein Kontingent für Anfragen pro Minute, Werbetreibender und Projekt für berechtigte Methoden festgelegt.

Diese neuen Limits ermöglichen eine größere Flexibilität bei der API-Nutzung und die Parallelisierung von Anfragen für Werbetreibende. Weitere Informationen zu dieser Änderung finden Sie in der Dokumentation zu bestehenden Kontingentlimits.

Ab dem 21. Juni 2023 können in LIST-Anfragefilter-Parametern keine OR-logischen Operatoren mehr zwischen Einschränkungen verschiedener Felder verwendet werden.

Ressourcen, die mit dem Filterstring lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT" OR insertionOrderId="123" gekennzeichnet sind, müssen beispielsweise mit zwei LIST-Anfragen mit den folgenden Filterstrings abgerufen werden:

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

Weitere Informationen zu den Einschränkungen von logischen Operatoren finden Sie in unserem Leitfaden zum Filtern von LIST-Anfragen.

Prüfen Sie vor dem 21. Juni 2023 die filter-Abfrageparameter aller Ihrer vorhandenen LIST-Aufrufe und achten Sie darauf, dass der logische Operator „ODER“ korrekt verwendet wird, um Dienstunterbrechungen zu vermeiden.

Datum des Inkrafttretens aktualisiert

Ab dem 21. Juni 2023 werden budget.budget_segments.date_range.end_date und flight.dateRange.endDate nicht mehr als Felder in den Abfrageparametern advertisers.insertionOrders.list und advertisers.lineItems.list filter und orderBy akzeptiert. Danach werden für Anfragen, die diese Felder in den Abfrageparametern filter und orderBy verwenden, Fehler zurückgegeben.

Entfernen Sie vor dem 21. Juni 2023 alle Filter- und Sortierlogiken, die diese beiden Felder verwenden, um eine Unterbrechung des Dienstes zu vermeiden.

Ab dem 21. Juni 2023 wird in advertisers.lineItems.list das Filtern nach den folgenden Feldern nicht mehr unterstützt:

• flight.triggerId
• targetedChannelId
• targetedNegativeKeywordListId
• warningMessages

Entfernen Sie vor dem 21. Juni 2023 alle Filterlogiken, die diese vier Felder verwenden, um Dienstunterbrechungen zu vermeiden.

Am 1. August 2023 werden Anzeigenaufträge mit ergebnisbasierten Käufen, die durch einen Feldwert von billableOutcome BILLABLE_OUTCOME_PAY_PER_CLICK oder BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION definiert sind, und die zugehörigen untergeordneten Werbebuchungen archiviert.

Diese Änderung betrifft die folgenden Anfragen:

• Wenn Sie versuchen, mit advertisers.insertionOrders.create einen Anzeigenauftrag mit ergebnisbasierten Käufen zu erstellen, wird der Fehler 400 zurückgegeben.
• Wenn Sie versuchen, mit advertisers.lineItems.create, advertisers.lineItems.duplicate oder advertisers.lineItems.generateDefault eine Werbebuchung unter einem Anzeigenauftrag mit ergebnisbasierten Käufen zu erstellen, wird der Fehler 400 zurückgegeben.
• Da archivierte Ressourcen standardmäßig nicht in LIST-Anfragen enthalten sind, werden betroffene Ressourcen standardmäßig nicht mehr mit den Methoden advertisers.insertionOrders.list und advertisers.lineItems.list zurückgegeben.

Ab dem 26. Juni 2024 wird das Feld publisherReviewStatuses eingestellt und ist beim Abrufen von Creative-Ressourcen leer.

Am 30. September 2024 werden die folgenden Werte für die genannten Targeting-Typen für „YouTube und Partner“-Werbebuchungen eingestellt:

• 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

Die Einstellung „Auslaufendes Targeting“ wird automatisch aus dem Targeting bestehender Werbebuchungen entfernt. Diese Werte können weiterhin für das Targeting auf Werbetreibendenebene verwendet werden.

Entfernen Sie dieses Targeting vor dem Enddatum aus allen vorhandenen „YouTube und Partner“-Werbebuchungen, um Dienstunterbrechungen zu vermeiden.

Am 30. September 2024 werden die Ressourcenquellen FirstAndThirdPartyAudience von Oracle eingestellt. Nach der Einstellung werden diese Zielgruppen aus allen bestehenden Ressourcen-Targetings und kombinierten Zielgruppen entfernt. Wenn eine Werbebuchung nur auf eingestellte Zielgruppen ausgerichtet ist oder diese ausschließt, wird sie durch diese Aktualisierung automatisch pausiert.

Um Dienstunterbrechungen zu vermeiden, sollten Sie alle Oracle-Zielgruppen vor dem Enddatum aus dem Zielgruppen-Targeting bestehender Werbebuchungen und kombinierten Zielgruppen entfernen.

Am 30. September 2024 sind LineItem-Ressourcen, für die eine Teilmenge von Gebotsstrategien verwendet wird, nicht mehr mit dem optimierten Targeting kompatibel. Durch diese Änderung werden LineItem-Ressourcen, bei denen targetingExpansion.enableOptimizedTargeting auf True und bidStrategy.maximizeSpendAutoBid.performanceGoalType auf BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA, BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN oder BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED oder bidStrategy.performanceGoalAutoBid.performanceGoalType auf BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM festgelegt ist, aktualisiert. Dabei wird targetingExpansion.enableOptimizedTargeting auf False gesetzt.

Aktualisieren Sie Ihre Werbebuchungen, für die diese Gebotsstrategien verwendet werden, und prüfen Sie, ob das optimierte Targeting deaktiviert ist, um Dienstunterbrechungen zu vermeiden.

Ab dem 5. November 2024 ist PACING_TYPE_ASAP nicht mehr mit PACING_PERIOD_FLIGHT kompatibel, wenn Sie das Feld pacing des Anzeigenauftrags festlegen. Die pacingType für alle vorhandenen Anzeigenaufträge mit dieser Konfiguration wird auf PACING_TYPE_AHEAD aktualisiert.

Aktualisieren Sie die pacing aller vorhandenen Anzeigenaufträge mit PACING_TYPE_ASAP und PACING_PERIOD_FLIGHT, um Dienstunterbrechungen zu vermeiden.

Am 28. Februar 2025:

• Bei Anfragen zum Erstellen oder Aktualisieren von LineItem-, InsertionOrder- und Campaign-Ressourcen, bei denen ein FrequencyCap-Objekt mit einem timeUnit-Feld verwendet wird, das auf TIME_UNIT_LIFETIME oder ein timeUnit-Feld festgelegt ist, das auf TIME_UNIT_MONTH und ein timeUnitCount-Feld festgelegt ist, das auf 2 festgelegt ist, wird der Fehler 400 zurückgegeben.
• Einträge in strukturierten Datendateien für Werbebuchungen, Anzeigenaufträge und Kampagnen, für die in der Spalte „Häufigkeitszeitraum“ entweder der Wert „Lifetime“ oder „Monate“ und in der Spalte „Häufigkeitsmenge“ der Wert „2“ angegeben ist, können beim Hochladen der Datei nicht erstellt oder aktualisiert werden.
• Vorhandene Kampagnen, Anzeigenaufträge und Werbebuchungen werden so aktualisiert, dass für das Frequency Capping ein Zeitraum von maximal 30 Tagen verwendet wird.

So vermeiden Sie Dienstunterbrechungen:

• Aktualisieren Sie vorhandene Kampagnen-, Anzeigenauftrags- und Werbebuchungsressourcen, für die ein Frequency Capping-Zeitraum von mehr als 30 Tagen festgelegt ist, auf maximal 30 Tage.
• Prüfen Sie, ob Ihre Integration beim Erstellen oder Aktualisieren von Kampagnen-, Anzeigenauftrags- oder Werbebuchungsressourcen mit der Display & Video 360 API oder strukturierten Datendateien keinen Zeitraum für die Häufigkeitsobergrenze von mehr als 30 Tagen festlegt.

Am 6. März 2025:

• Bei Anfragen zum Erstellen oder Aktualisieren von LineItem-Ressourcen, um das Feld BiddingStrategy fixedBid und das Feld TargetingExpansionConfig enableOptimizedTargeting auf „wahr“ zu setzen, wird ein 400-Fehler zurückgegeben.
• Einträge in strukturierten Datendateien für Werbebuchungen mit dem Spaltenwert „Fixed“ (Fest) für „Bid Strategy Type“ (Typ der Gebotsstrategie) und dem Spaltenwert „True“ (Wahr) für „Optimized Targeting“ (Optimiertes Targeting) können beim Hochladen der Datei nicht erstellt oder aktualisiert werden.
• Bestehende Werbebuchungen mit festen Geboten werden so aktualisiert, dass das optimierte Targeting deaktiviert wird.

So vermeiden Sie Dienstunterbrechungen:

• Aktualisieren Sie vorhandene Werbebuchungsressourcen, für die sowohl die Festpreiseinstellung als auch das optimierte Targeting verwendet werden.
• Prüfen Sie, ob bei der Erstellung oder Aktualisierung von Werbebuchungsressourcen mit der Display & Video 360 API oder strukturierten Datendateien keine feste Gebotsstrategie und kein optimiertes Targeting festgelegt wird.

Am 6. März 2025 wird die Standardseitengröße für firstAndThirdPartyAudiences.list-Anfragen von 100 auf 5.000 aktualisiert.

Aktualisieren Sie Ihre Integration, um eine Dienstunterbrechung zu vermeiden. Legen Sie dazu den Abfrageparameter pageSize Ihrer firstAndThirdPartyAudiences.list-Anfragen auf die gewünschte Seitengröße fest.

Ab dem 6. März 2025 wird bei sdfdownloadtasks.create-Anfragen, bei denen mithilfe eines übergeordneten Entitätsfilters nach Werbetreibenden gefiltert wird, die nicht untergeordnet sind der Gruppe partnerId, der Fehler 400 zurückgegeben.

Am 1. April 2025:

• Bei advertisers.lineItems.create-Anfragen, bei denen versucht wird, das Feld floodlightActivityConfigs des ConversionCountingConfig-Objekts und das Feld customBiddingAlgorithmId von MaximizeSpendBidStrategy- oder PerformanceGoalBidStrategy-Objekten festzulegen, für die keine übereinstimmenden Floodlight-Aktivitäten verwendet werden, wird der Fehler 400 zurückgegeben.
• Bei advertisers.lineItems.patch-Anfragen, bei denen versucht wird, das Feld floodlightActivityConfigs des ConversionCountingConfig-Objekts zu aktualisieren, während das Feld customBiddingAlgorithmId von MaximizeSpendBidStrategy- oder PerformanceGoalBidStrategy-Objekten festgelegt ist, wird ein 400-Fehler zurückgegeben.
• Einträge in strukturierten Datendateien für Werbebuchungen, bei denen versucht wird, die Spalte „Conversion-Floodlight-Aktivitäts-IDs“ zu aktualisieren, wenn die Spalte „Algorithmus-ID“ festgelegt ist, werden beim Dateiupload nicht aktualisiert.
• customBiddingAlgorithms.patch-, customBiddingAlgorithms.rules.create- und customBiddingAlgorithms.scripts.create-Anfragen für CustomBiddingAlgorithm-Ressourcen, die einer Werbebuchung zugewiesen sind, werfen einen Fehler zurück.

Aktualisieren Sie Ihre Integration, um Dienstunterbrechungen zu vermeiden:

• Prüfen Sie, ob die relevanten Floodlight-Aktivitäten einer Werbebuchung vor oder gleichzeitig mit der Zuweisung eines Algorithmus für benutzerdefinierte Gebote zugewiesen sind.
• Vor dem Aktualisieren werden vorhandene Algorithmen für die benutzerdefinierte Gebotseinstellung von allen Werbebuchungen getrennt.

Ab dem 7. April 2025 ist bei FirstAndThirdPartyAudience-Ressourcen keine unbegrenzte Dauer der Zielgruppenmitgliedschaft mehr zulässig. Bei firstAndThirdPartyAudiences.create- und firstAndThirdPartyAudiences.patch-Anfragen, bei denen der Feldwert membershipDurationDays auf 10.000 festgelegt wird, wird der Fehler 400 zurückgegeben. Bei bestehenden Zielgruppen mit dem Feldwert „10.000“ für membershipDurationDays wird dieser Wert auf „540“ aktualisiert. Die neue Mitgliedschaftsdauer wird rückwirkend auf bestehende Mitgliedschaften angewendet. Dadurch laufen alle Mitgliedschaften ab, die älter als 540 Tage sind.

So vermeiden Sie Dienstunterbrechungen:

• Prüfen Sie,ob der Feldwert membershipDurationDays neuer oder vorhandener Zielgruppen in Ihrer Integration nicht auf 10.000 festgelegt ist.
• Aktualisieren Sie die Mitgliedschaften Ihrer bestehenden Zielgruppen mit Kundenabgleich mit firstAndThirdPartyAudiences.editCustomerMatchMembers.
• Aktualisieren Sie die Mitgliedschaften in Zielgruppen für den Kundenabgleich regelmäßig, damit die Listengröße Ihrer Zielgruppen nicht versehentlich kleiner wird.

Ab dem 1. Mai 2025 können Einträge in strukturierten Datendateien für Werbebuchungen, bei denen versucht wird, die Spalte „Gebotsmultiplikatoren“ festzulegen, beim Dateiupload nicht mehr erstellt oder aktualisiert werden.