Archivierte Versionshinweise

Auf dieser Seite finden Sie Versionshinweise zu eingestellten Versionen der Display & Video 360 API.

Auf unserer Hauptseite mit Versionshinweisen finden Sie alle Releases für Live-Versionen.

4. Dezember 2024

Neue Funktionen

Unterstützung für Core- und Tubi-Exchange-Werte hinzugefügt.

Die maximal zulässige Seitengröße für firstAndThirdPartyAudiences.list wurde von 200 auf 5000 erhöht. Aktualisieren Sie den Parameter pageSize Ihrer firstAndThirdPartyAudiences.list-Anfragen, um die Kontingentnutzung weiter zu optimieren.

v3

• Die folgenden Enum-Werte wurden hinzugefügt:

  Enum	Wert(e)
  Exchange	EXCHANGE_CORE EXCHANGE_TUBI

• Die maximale Seitengröße wurde für die folgenden Listenmethoden erhöht:

  Methode	Neue maximale Seitengröße
  firstAndThirdPartyAudiences.list	5000

22. Oktober 2024

Neue Funktionen

Unterstützung für das Leistungsziel „Cost-per-View“ hinzugefügt.

Es wurde die Möglichkeit hinzugefügt, das Targeting verbundener Geräte festzulegen und abzurufen.

Unter Ausrichtung auf Drittanbieter-Verifier wurden neue Adloox-Einstellungen für die Markensicherheit hinzugefügt.

Es wurde Unterstützung für das Herunterladen von strukturierten Daten im V8-Format hinzugefügt. Diese Funktion befindet sich derzeit in der geschlossenen Betaphase.

v3

• Die folgenden Felder wurden hinzugefügt:

  Objekt

  Feld(er)

  Adloox

  adultExplicitSexualContent armsAmmunitionContent crimeHarmfulActsIndividualsSocietyHumanRightsViolationsContent deathInjuryMilitaryConflictContent debatedSensitiveSocialIssueContent displayIabViewability excludedFraudIvtMfaCategories hateSpeechActsAggressionContent illegalDrugsTobaccoEcigarettesVapingAlcoholContent misinformationContent obscenityProfanityContent onlinePiracyContent spamHarmfulContent terrorismContent videoIabViewability

• Die folgenden Enum-Werte wurden hinzugefügt:

  Enum	Wert(e)
  DeviceType	DEVICE_TYPE_CONNECTED_DEVICE
  PerformanceGoalType	PERFORMANCE_GOAL_TYPE_CPV
  SdfVersion	SDF_VERSION_8

Veraltete Werte

Die Unterstützung für SDF v5.5 wurde entfernt, da die Einstellung am 3. Oktober 2024 erfolgte.

v3

• Die folgenden Enum-Werte wurden eingestellt:

  Enum	Wert(e)
  SdfVersion	SDF_VERSION_5_5

15. August 2024

Neue Funktionen

Unterstützung für den Netflix-Typ Exchange hinzugefügt.

v3

• Die folgenden Enum-Werte wurden hinzugefügt:

  Enum	Wert(e)
  Anzeigenplattform	EXCHANGE_NETFLIX

v2

• Die folgenden Enum-Werte wurden hinzugefügt:

  Enum	Wert(e)
  Anzeigenplattform	EXCHANGE_NETFLIX

15. Juli 2024

Neue Funktionen

In Version 3 wurde die Unterstützung für das Herunterladen von Dateien mit strukturierten Daten für Werbebuchungen und Anzeigengruppen im QA-Format hinzugefügt.

v3

• Die folgenden Felder wurden hinzugefügt:

  Ressource	Feld(er)
  IdFilter	adGroupQaIds lineItemQaIds

• Die folgenden Enum-Werte wurden hinzugefügt:

  Enum	Wert(e)
  FileType	FILE_TYPE_AD_GROUP_QA FILE_TYPE_LINE_ITEM_QA

17. Juni 2024

Neue Funktionen

Es ist jetzt möglich, Keyword-Targeting zu verwalten, das auf Werbetreibendenebene zugewiesen wurde.

Der Anzeigenauftragsressource wurde das neue Feld optimizationObjective hinzugefügt. optimizationObjective ist nur für Kunden auf der Zulassungsliste verfügbar.

v3

• Die folgenden Felder wurden hinzugefügt:

  Ressource	Feld(er)
  InsertionOrder	optimizationObjective

• Die folgenden Methoden unterstützen jetzt die folgenden Targeting-Typen:

  Ausrichtungstyp	Methode(n)
  TARGETING_TYPE_KEYWORD	advertisers.editAssignedTargetingOptions advertisers.listAssignedTargetingOptions advertisers.targetingType.assignedTargetingOptions.create advertisers.targetingType.assignedTargetingOptions.delete advertisers.targetingType.assignedTargetingOptions.get advertisers.targetingType.assignedTargetingOptions.list

v2

• Die folgenden Methoden unterstützen jetzt die folgenden Targeting-Typen:

  Ausrichtungstyp	Methode(n)
  TARGETING_TYPE_KEYWORD	advertisers.editAssignedTargetingOptions advertisers.listAssignedTargetingOptions advertisers.targetingType.assignedTargetingOptions.create advertisers.targetingType.assignedTargetingOptions.delete advertisers.targetingType.assignedTargetingOptions.get advertisers.targetingType.assignedTargetingOptions.list

30. Mai 2024

Neue Funktionen

Unterstützung für Version 7.1 von Dateien mit strukturierten Daten hinzugefügt.

v3

• Die folgenden Enum-Werte wurden hinzugefügt:

  Enum	Wert(e)
  SdfVersion	SDF_VERSION_7_1

v2

• Die folgenden Enum-Werte wurden hinzugefügt:

  Enum	Wert(e)
  SdfVersion	SDF_VERSION_7_1

23. April 2024

Neue Funktionen

Unterstützung für neue KPI-Typen, Exchanges und App-Plattformen wurde hinzugefügt.

v3

• Die folgenden Felder wurden hinzugefügt:

  Ressource	Feld(er)
  KPI	kpiAlgorithmId

• Die folgenden Enum-Werte wurden hinzugefügt:

  Enum	Wert(e)
  AppPlatform	APP_PLATFORM_LG_TV APP_PLATFORM_VIZIO_TV
  Anzeigenplattform	EXCHANGE_DRAX
  KpiType	KPI_TYPE_CPCL KPI_TYPE_CPCV KPI_TYPE_CPV KPI_TYPE_CUSTOM_IMPRESSION_VALUE_OVER_COST KPI_TYPE_MAXIMIZE_PACING KPI_TYPE_TOS10
  YoutubeAndPartnersBiddingStrategyType	YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM

v2

• Die folgenden Enum-Werte wurden hinzugefügt:

  Enum	Wert(e)
  AppPlatform	APP_PLATFORM_LG_TV APP_PLATFORM_VIZIO_TV
  Anzeigenplattform	EXCHANGE_DRAX
  YoutubeAndPartnersBiddingStrategyType	YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM

28. Februar 2024

Neue Funktionen

Es ist jetzt möglich, Mitglieder explizit aus Zielgruppen für den Kundenabgleich zu entfernen.

Unterstützung für das Targeting auf neue Anzeigenplattformen hinzugefügt.

v3

• Die folgenden Felder wurden hinzugefügt:

  Ressource	Feld(er)
  firstAndThirdPartyAudiences.editCustomerMatchMembers	removedContactInfoList removedMobileDeviceIdList

• Die folgenden Enum-Werte wurden hinzugefügt:

  Enum	Wert(e)
  Anzeigenplattform	EXCHANGE_ADMOST_GBID EXCHANGE_APPLOVIN_GBID EXCHANGE_CHARTBOOST_GBID EXCHANGE_FYBER_GBID EXCHANGE_TOPON_GBID EXCHANGE_UNITY_GBID

v2

• Die folgenden Felder wurden hinzugefügt:

  Ressource	Feld(er)
  firstAndThirdPartyAudiences.editCustomerMatchMembers	removedContactInfoList removedMobileDeviceIdList

• Die folgenden Enum-Werte wurden hinzugefügt:

  Enum	Wert(e)
  Anzeigenplattform	EXCHANGE_ADMOST_GBID EXCHANGE_APPLOVIN_GBID EXCHANGE_CHARTBOOST_GBID EXCHANGE_FYBER_GBID EXCHANGE_TOPON_GBID EXCHANGE_UNITY_GBID

29. Januar 2024

Neue Funktionen

Es wurde die Möglichkeit hinzugefügt, Floodlight-Aktivitäten über den neuen Dienst floodlightGroups.floodlightActivities abzurufen.

Es wurde ein neues Feld hinzugefügt, in dem angegeben wird, ob eine „YouTube und Partner“-Werbebuchung Google TV-Inventar in ihr Targeting einbezieht.

Es wurde ein neues Feld hinzugefügt, um die letzte Anmeldezeit für einen Display & Video 360-Nutzer zu übermitteln.

v3

• Die folgenden Methoden wurden hinzugefügt:

  Dienst	Methode(n)
  floodlightGroups.floodlightActivities	get list

• Die folgenden Felder wurden hinzugefügt:

  Ressource	Feld(er)
  Nutzer	lastLoginTime
  YoutubeAndPartnersInventorySourceConfig	includeGoogleTv

v2

• Die folgenden Methoden wurden hinzugefügt:

  Dienst	Methode(n)
  floodlightGroups.floodlightActivities	get list

• Die folgenden Felder wurden hinzugefügt:

  Ressource	Feld(er)
  Nutzer	lastLoginTime
  YoutubeAndPartnersInventorySourceConfig	includeGoogleTv

14. November 2023

Neue Funktionen

Es ist jetzt möglich, die Einwilligung der Endnutzer beim Hochladen von Zielgruppenmitgliedern für den Kundenabgleich in allen Live-Versionen zu übergeben.

v3

• Die folgenden Felder wurden hinzugefügt:

  Ressource	Feld(er)
  ContactInfoList	Einwilligung
  MobileDeviceIdList	Einwilligung

v2

• Die folgenden Felder wurden hinzugefügt:

  Ressource	Feld(er)
  ContactInfoList	Einwilligung
  MobileDeviceIdList	Einwilligung

31. Oktober 2023

Neue Funktionen

Version 3 ist nicht mehr als öffentliche Betaversion, sondern allgemein verfügbar.

Der Enum-Wert AdGroupFormat wurde in Version 3 umbenannt, um das relevante Format genauer wiederzugeben.

Unterstützung für Structured Data Files v7 wurde hinzugefügt. Dazu wurde der Enum-Wert SDF_VERSION_7 in v2 und v3 hinzugefügt.

v3

• Die folgenden Aufzählungswerte wurden entfernt:

  Enum	Wert(e)
  AdGroupFormat	AD_GROUP_FORMAT_ACTION

• Die folgenden Enum-Werte wurden hinzugefügt:

  Enum	Wert(e)
  AdGroupFormat	AD_GROUP_FORMAT_RESPONSIVE
  SdfVersion	SDF_VERSION_7

v2

• Die folgenden Enum-Werte wurden hinzugefügt:

  Enum	Wert(e)
  SdfVersion	SDF_VERSION_7

2. Oktober 2023

Neue Funktionen

Version 3 wurde als öffentliche Betaversion veröffentlicht und enthält die folgenden Änderungen:

• Die Möglichkeit, Listen mit Standorten in der Nähe vollständig zu verwalten, sodass der Dienst advertisers.locationLists.assignedLocations verwendet werden kann, um Standorte zu erstellen und zu löschen, die TARGETING_LOCATION_TYPE_PROXIMITY-Ressourcen vom Typ LocationList zugewiesen sind.
• Ein neues boolesches Feld enableOptimizedTargeting, das das Feld targetingExpansionLevel im TargetingExpansionConfig-Objekt ersetzt.
• Die Anforderung des Felds billingConfig in der Ressource Advertiser, das bei advertisers.create-Anfragen enthalten sein muss, und ein neues Feld billingConfig in der Ressource Partner.
• Neue AdGroup- und AdGroupAd-Ressourcen, die die Ressourcen YoutubeAdGroup und YoutubeAdGroupAd in Version 2 ersetzen.

Folgen Sie der Anleitung in unserem Migrationsleitfaden, um von Version 2 zu Version 3 zu migrieren.

In Version 2 und Version 3 wurden drei neue LineItemType-Werte, ein neuer YoutubeAndPartnersBiddingStrategyType-Wert und ein neuer PartnerCostType-Wert hinzugefügt.

v3

• Die folgenden Methoden wurden hinzugefügt:

  Dienst	Methode(n)
  advertisers.adGroupAds	get list
  advertisers.adGroups	bulkListAdGroupAssignedTargetingOptions get list
  advertisers.adGroups.targetingTypes.assignedTargetingOptions	get list
  customBiddingAlgorithms	uploadRules
  customBiddingAlgorithms.rules	create get list

• Die folgenden Methoden wurden entfernt:

  Dienst	Methode(n)
  advertisers.manualTriggers	aktivieren create deaktivieren get list patch
  advertisers.youtubeAdGroupAds	get list
  advertisers.youtubeAdGroups	bulkListAdGroupAssignedTargetingOptions get list
  advertiser.youtubeAdGroups.targetingTypes.assignedTargetingOptions	get list

• Das Verhalten der folgenden Methode hat sich geändert:

  Methode	Änderung(en)
  advertisers.locationLists.create	Unterstützt jetzt das Erstellen von TARGETING_LOCATION_TYPE_PROXIMITY- und LocationList-Ressourcen.
  advertisers.locationLists.patch	Jetzt wird das Aktualisieren von TARGETING_LOCATION_TYPE_PROXIMITY-LocationList-Ressourcen unterstützt.
  advertisers.locationLists.assignedLocations.bulkEdit	Die Bulk-Bearbeitung der AssignedLocation-Ressourcen in TARGETING_LOCATION_TYPE_PROXIMITY-LocationList-Ressourcen wird jetzt unterstützt.
  advertisers.locationLists.assignedLocations.create	Jetzt wird das Erstellen von AssignedLocation-Ressourcen in TARGETING_LOCATION_TYPE_PROXIMITY-LocationList-Ressourcen unterstützt.

• Die folgenden Abfrageparameter wurden hinzugefügt:

  Methode	Parameter
  inventorySources.get	advertiserId

• Die folgenden Felder sind jetzt Pflichtfelder:

  Ressource	Feld(er)
  Werbetreibender	billingConfig

• Die folgenden Felder wurden hinzugefügt:

  Ressource	Feld(er)
  BiddingStrategy	youtubeAndPartnersBid
  InsertionOrder	kpi
  Partner	billingConfig
  TargetingExpansionConfig	audienceExpansionLevel audienceExpansionSeedListExcluded enableOptimizedTargeting
  YoutubeAndPartnersSettings	thirdPartyMeasurementConfigs
  YoutubeAndPartnersInventorySourceConfig	includeYoutube

• Die folgenden Felder wurden entfernt:

  Ressource	Feld(er)
  InsertionOrder	performanceGoal billableOutcome
  TargetingExpansionConfig	excludeFirstPartyAudience targetingExpansionLevel
  YoutubeAndPartnersSettings	biddingStrategy thirdPartyMeasurementSettings
  YoutubeAndPartnersInventorySourceConfig	includeYoutubeSearch includeYoutubeVideos

• Die folgenden Enum-Werte wurden hinzugefügt:

  Enum	Wert(e)
  CustomBiddingAlgorithmType	RULE_BASED
  LineItemType	LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW
  PartnerCostType	PARTNER_COST_TYPE_SCIBIDS_FEE
  ReadinessState	READINESS_STATE_EVALUATION_FAILURE
  YoutubeAndPartnersBiddingStrategyType	YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV

• Die folgenden Aufzählungswerte wurden entfernt:

  Enum	Wert(e)
  LineItemWarningMessage	DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

v2

• Die folgenden Enum-Werte wurden hinzugefügt:

  Enum	Wert(e)
  LineItemType	LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW
  PartnerCostType	PARTNER_COST_TYPE_SCIBIDS_FEE
  YoutubeAndPartnersBiddingStrategyType	YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV

25. August 2023

Neue Funktionen

Unterstützung für zwei Börsen und zwei neue Gebotsstrategietypen für YouTube und Partner hinzugefügt.

Für „YouTube und Partner“-Werbebuchungen wurde das neue Feld effectiveContentCategory hinzugefügt, um die YoutubeAndPartnersContentCategory der Werbebuchung zu präsentieren, wenn Werte berücksichtigt werden, die sowohl auf Werbetreibenden- als auch auf Werbebuchungsebene zugewiesen sind.

v2

• Die folgenden Felder wurden hinzugefügt:

  Ressource	Feld(er)
  YoutubeAndPartnersSettings	effectiveContentCategory

• Die folgenden Felder wurden entfernt:

  Ressource	Feld(er)
  InventorySource	subSitePropertyId

• Die folgenden Enum-Werte wurden hinzugefügt:

  Enum	Wert(e)
  Anzeigenplattform	EXCHANGE_HIVESTACK EXCHANGE_RESET_DIGITAL
  YoutubeAndPartnersBiddingStrategyType	YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS

5. Juni 2023

Neue Funktionen

In Version 1 und Version 2 wurde ein neuer SdfVersion-Wert für strukturierte Datendateien (Structured Data Files, SDF) v6 hinzugefügt.

v2

• Die folgenden Enum-Werte wurden hinzugefügt:

  Enum	Wert(e)
  SdfVersion	SDF_VERSION_6

v1

• Die folgenden Enum-Werte wurden hinzugefügt:

  Enum	Wert(e)
  SdfVersion	SDF_VERSION_6

9. März 2023

Neue Funktionen

Es wurde ein neuer LineItemWarningMessage-Wert hinzugefügt, der dem Feld warningMessages eines Line-Items zugewiesen wird, wenn für das eingestellte Feld excludeFirstPartyAudience der Wert true festgelegt ist. Das Feld excludeFirstPartyAudience wird eingestellt und nach dem 25. März 2023 auf false gesetzt.

v2

• Die folgenden Enum-Werte wurden hinzugefügt:

  Enum	Wert(e)
  LineItemWarningMessage	DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

v1

• Die folgenden Enum-Werte wurden hinzugefügt:

  Enum	Wert(e)
  LineItemWarningMessage	DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

8. Februar 2023

Neue Funktionen

Es wurde die Möglichkeit hinzugefügt, die Ressourcen YouTubeAdGroup und YouTubeAdGroupAd sowie die Ausrichtung von YouTube-Anzeigengruppen abzurufen. Außerdem haben wir neue abrufbare Targeting-Typen auf YouTube-Anzeigengruppenebene hinzugefügt. Weitere Informationen finden Sie auf unserer neuen Hilfeseite zum Abrufen von „YouTube und Partner“-Ressourcen.

Unterstützung für vier zusätzliche Börsen in Version 1 und Version 2 hinzugefügt.

v2

• Die folgenden Methoden wurden hinzugefügt:

  Dienst	Methode(n)
  advertisers.youtubeAdGroupAds	get list
  advertisers.youtubeAdGroups	bulkListAdGroupAssignedTargetingOptions get list
  advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions	get list

• Die folgenden Felder wurden hinzugefügt:

  Dienst	Methode(n)
  AssignedTargetingOption	sessionPositionDetails youtubeChannelDetails youtubeVideoDetails
  YoutubeAndPartnersSettings	leadFormId linkedMerchantId relatedVideoIds targetFrequency videoAdSequenceSettings

• Die folgenden Enum-Werte wurden hinzugefügt:

  Enum	Wert(e)
  Anzeigenplattform	EXCHANGE_APPLOVIN EXCHANGE_CONNATIX EXCHANGE_JCD EXCHANGE_PLACE_EXCHANGE
  LineItemType	LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY
  TargetingType	TARGETING_TYPE_SESSION_POSITION TARGETING_TYPE_YOUTUBE_CHANNEL TARGETING_TYPE_YOUTUBE_VIDEO

v1

• Die folgenden Enum-Werte wurden hinzugefügt:

  Enum	Wert(e)
  Anzeigenplattform	EXCHANGE_APPLOVIN EXCHANGE_CONNATIX EXCHANGE_JCD EXCHANGE_PLACE_EXCHANGE

6. Dezember 2022

Neue Funktionen

Version 2 ist nicht mehr als öffentliche Betaversion, sondern allgemein verfügbar.

Der AssignedTargetingOption-Ressource wurde das neue Feld assignedTargetingOptionIdAlias hinzugefügt, das anstelle von assignedTargetingOptionId beim Abrufen und Löschen der Ausrichtung verwendet werden kann. Dieses Feld wird nur für zugewiesene Ausrichtungsoptionen von Ausrichtungstypen festgelegt, die über eine Enumeration zugewiesen werden. Der Aliaswert ist der entsprechende Enum-Wert als String.

Der Ressource Advertiser wurde ein neues Feld billingConfig hinzugefügt.

Es wurde Unterstützung für das Abrufen von OTT-Werbebuchungen für YouTube und Partner hinzugefügt, die durch drei neue LineItemType-Werte identifiziert werden.

Die maximale Seitengröße wurde für zahlreiche list-Methoden in Version 1 und Version 2 auf 200 erhöht. Die Standardseitengröße bleibt unverändert.

v2

• Die folgenden Felder wurden hinzugefügt:

  Ressource	Feld(er)
  Werbetreibender	billingConfig
  AssignedTargetingOption	assignedTargetingOptionIdAlias

• Die folgenden Enum-Werte wurden hinzugefügt:

  Enum	Wert(e)
  LineItemType	LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP

• Die maximale Seitengröße wurde für die folgenden Listenmethoden erhöht:

  Methode	Neue maximale Seitengröße
  advertisers.campaigns.list	200
  advertisers.channels.list	200
  advertisers.creatives.list	200
  advertisers.invoices.list	200
  advertisers.lineItems.list	200
  advertisers.list	200
  advertisers.locationLists.assignedLocations.list	200
  advertisers.locationLists.list	200
  advertisers.manualTriggers.list	200
  advertisers.negativeKeywordLists.list	200
  combinedAudiences.list	200
  customBiddingAlgorithms.list	200
  customBiddingAlgorithms.scripts.list	200
  customLists.list	200
  firstAndThirdPartyAudiences.list	200
  googleAudiences.list	200
  guaranteedOrders.list	200
  inventorySourceGroups.list	200
  inventorySources.list	200
  partners.channels.list	200
  partners.list	200
  partners.targetingTypes.assignedTargetingOptions.list	200
  targetingTypes.targetingOptions.list	200
  targetingTypes.targetingOptions.search	200
  users.list	200

v1

• Die maximale Seitengröße wurde für die folgenden Listenmethoden erhöht:

  Methode	Neue maximale Seitengröße
  advertisers.campaigns.list	200
  advertisers.channels.list	200
  advertisers.creatives.list	200
  advertisers.invoices.list	200
  advertisers.lineItems.list	200
  advertisers.list	200
  advertisers.locationLists.assignedLocations.list	200
  advertisers.locationLists.list	200
  advertisers.manualTriggers.list	200
  advertisers.negativeKeywordLists.list	200
  combinedAudiences.list	200
  customBiddingAlgorithms.list	200
  customBiddingAlgorithms.scripts.list	200
  customLists.list	200
  firstAndThirdPartyAudiences.list	200
  googleAudiences.list	200
  guaranteedOrders.list	200
  inventorySourceGroups.list	200
  inventorySources.list	200
  partners.channels.list	200
  partners.list	200
  partners.targetingTypes.assignedTargetingOptions.list	200
  targetingTypes.targetingOptions.list	200
  targetingTypes.targetingOptions.search	200
  users.list	200

Bekannte Probleme

Mit diesem Update werden die folgenden bekannten Probleme in Version 2 behoben:

• Zugewiesene Targeting-Optionen von Targeting-Typen, die mit Enum-Werten in Version 2 zugewiesen wurden, konnten nicht mit ihrem assignedTargetingOptionId entfernt oder abgerufen werden. Stattdessen mussten Nutzer den Enum-Wert verwenden. Mit diesem Update können diese zugewiesenen Targeting-Optionen entweder mit assignedTargetingOptionId oder mit dem Enum-Wert entfernt oder abgerufen werden, der durch das neue Feld assignedTargetingOptionIdAlias in der Ressource AssignedTargetingOption identifiziert wird.
• Bei der Anfrage für die Werbebuchung bulkUpdate wurde der Anfrageparameter advertisersId nicht richtig verwendet, sodass ein Fehler zurückgegeben wurde. Mit diesem Update wurde die Methode korrigiert und der Anfrageparameter wurde von advertisersId in advertiserId umbenannt.

27. Oktober 2022

Es ist jetzt möglich, eine vorhandene Werbebuchung im übergeordneten InsertionOrder zu duplizieren.

Es wurde Unterstützung für das Schreiben von Teil-Einfügereihenfolgen-Targeting für eine Teilmenge von Targeting-Typen eingeführt. Dazu wurden die Methoden create und delete dem Dienst advertisers.insertionOrders.targetingTypes.assignedTargetingOptions hinzugefügt.

Neue Funktionen

v2

• Die folgenden Methoden wurden hinzugefügt:

  Dienst	Methode(n)
  advertisers.insertionOrders.targetingTypes.assignedTargetingOptions	create Delete
  advertisers.lineItems	duplicate

v1

Der Version 1 wurden keine neuen Funktionen hinzugefügt.

20. September 2022

Version 2 wurde als öffentliche Betaversion veröffentlicht und enthält die folgenden Änderungen:

• Die Möglichkeit, „YouTube und Partner“-Werbebuchungen und ihre Targeting-Einstellungen mit den Methoden get und list in den Diensten advertisers.lineItems und advertisers.lineItems.targetingTypes.assignedTargetingOptions abzurufen.
• Zwei neue Bulk-Targeting-Methoden im advertisers.lineItems-Dienst, mit denen sich das zugewiesene Targeting für mehrere Werbebuchungen mit einer einzigen Anfrage bearbeiten und abrufen lässt.
• Eine neue bulkUpdate-Methode, mit der Nutzer die entityStatus mehrerer Werbebuchungen in einer einzigen Anfrage aktualisieren können.
• Neue Ausrichtungslogik, für die AssignedTargetingOption-Ressourcen einer Teilmenge von Ausrichtungstypen mithilfe von Enum-Werten anstelle von Ausrichtungsoptions-IDs zugewiesen und abgerufen werden müssen, die mit dem targetingTypes.targetingOptions-Dienst abgerufen werden.

Folgen Sie der Anleitung in unserem Migrationsleitfaden, um von v1 zu v2 zu migrieren.

Unterstützung für drei neue Börsen in Version 1 hinzugefügt.

Neue Funktionen

v2

Im Folgenden finden Sie eine Liste der Änderungen zwischen v1 und v2:

• Die folgenden Methoden wurden in Version 2 hinzugefügt:

  Dienst	Methode(n)
  advertisers.lineItems	bulkEditAssignedTargetingOptions bulkListAssignedTargetingOptions bulkUpdate

• Die folgenden Methoden wurden in Version 2 entfernt:

  Dienst	Methode(n)
  advertisers.lineItems	bulkEditLineItemAssignedTargetingOptions bulkListLineItemAssignedTargetingOptions

• Die folgenden Methoden wurden in Version 2 umbenannt:

  Dienst	Alter Methodenname	Neuer Methodenname
  advertisers	bulkEditAdvertiserAssignedTargetingOptions bulkListAdvertiserAssignedTargetingOptions	editAssignedTargetingOptions listAssignedTargetingOptions
  advertisers.campaigns	bulkListCampaignAssignedTargetingOptions	listAssignedTargetingOptions
  advertisers.insertionOrders	bulkListInsertionOrderAssignedTargetingOptions	listAssignedTargetingOptions
  Partner	bulkEditPartnerAssignedTargetingOptions	editAssignedTargetingOptions

• Für AssignedTargetingOption-Ressourcen der folgenden Targeting-Typen werden in Version 2 Enums für die Targeting-Zuweisung verwendet. Das Feld assignedTargetingOptionId für AssignedTargetingOption-Ressourcen dieser Targeting-Typen wurde in Version 2 ebenfalls aktualisiert, sodass Stringversionen der Enum-Werte verwendet werden:

  Ausrichtungstyp	Enum-Typ
  TARGETING_TYPE_AGE_RANGE	AgeRange
  TARGETING_TYPE_CONTENT_INSTREAM_POSITION	ContentInstreamPosition
  TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION	ContentOutstreamPosition
  TARGETING_TYPE_DEVICE_TYPE	DeviceType
  TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION	ContentRatingTier
  TARGETING_TYPE_ENVIRONMENT	Umgebung
  TARGETING_TYPE_EXCHANGE	Anzeigenplattform
  TARGETING_TYPE_GENDER	Geschlecht
  TARGETING_TYPE_HOUSEHOLD_INCOME	HouseholdIncome
  TARGETING_TYPE_NATIVE_CONTENT_POSITION	NativeContentPosition
  TARGETING_TYPE_OMID	Omid
  TARGETING_TYPE_PARENTAL_STATUS	ParentalStatus
  TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION	SensitiveCategory
  TARGETING_TYPE_VIDEO_PLAYER_SIZE	VideoPlayerSize
  TARGETING_TYPE_VIEWABILITY	Sichtbarkeit

• In Version 2 wurden die folgenden Felder hinzugefügt:

  Ressource	Feld(er)
  CustomBiddingAlgorithm	modelDetails
  DeviceTypeAssignedTargetingOptionDetails	youtubeAndPartnersBidMultiplier
  DigitalContentLabelAssignedTargetingOptionDetails	excludedContentRatingTier
  ExchangeAssignedTargetingOptionDetails	exchange
  FrequencyCap	maxViews
  LineItem	youtubeAndPartnersSettings
  ProximityLocationListAssignedTargetingOptionDetails	proximityRadius proximityRadiusUnit
  SensitiveCategoryAssignedTargetingOptionDetails	excludedSensitiveCategory

• Die folgenden Felder wurden in Version 2 entfernt:

  Ressource	Feld(er)
  AgeRangeAssignedTargetingOptionDetails	targetingOptionId
  ContentInstreamPositionAssignedTargetingOptionDetails	targetingOptionId
  ContentOutstreamPositionAssignedTargetingOptionDetails	targetingOptionId
  CustomBiddingAlgorithm	customBiddingAlgorithmState
  DeviceTypeAssignedTargetingOptionDetails	targetingOptionId
  DigitalContentLabelAssignedTargetingOptionDetails	contentRatingTier excludedTargetingOptionId
  EnvironmentAssignedTargetingOptionDetails	targetingOptionId
  ExchangeAssignedTargetingOptionDetails	targetingOptionId
  GenderAssignedTargetingOptionDetails	targetingOptionId
  HouseholdIncomeAssignedTargetingOptionDetails	targetingOptionId
  LineItem	inventorySourceIds
  LineItemFlight	triggerId
  NativeContentPositionAssignedTargetingOptionDetails	targetingOptionId
  OmidAssignedTargetingOptionDetails	targetingOptionId
  ParentalStatusAssignedTargetingOptionDetails	targetingOptionId
  ProximityLocationListAssignedTargetingOptionDetails	proximityRadiusRange
  SensitiveCategoryAssignedTargetingOptionDetails	excludedTargetingOptionId sensitiveCategory
  VideoPlayerSizeAssignedTargetingOptionDetails	targetingOptionId
  ViewabilityAssignedTargetingOptionDetails	targetingOptionId

• Die folgenden Felder sind in Version 2 Pflichtfelder:

  Ressource	Feld(er)
  AgeRangeAssignedTargetingOptionDetails	ageRange
  ContentInstreamPositionAssignedTargetingOptionDetails	contentInstreamPosition
  ContentOutstreamPositionAssignedTargetingOptionDetails	contentOutstreamPosition
  DeviceTypeAssignedTargetingOptionDetails	deviceType
  DigitalContentLabelAssignedTargetingOptionDetails	excludedContentRatingTier
  EnvironmentAssignedTargetingOptionDetails	Umgebung
  ExchangeAssignedTargetingOptionDetails	exchange
  GenderAssignedTargetingOptionDetails	gender
  HouseholdIncomeAssignedTargetingOptionDetails	householdIncome
  NativeContentPositionAssignedTargetingOptionDetails	contentPosition
  OmidAssignedTargetingOptionDetails	omid
  ParentalStatusAssignedTargetingOptionDetails	parentalStatus
  SensitiveCategoryAssignedTargetingOptionDetails	excludedSensitiveCategory
  VideoPlayerSizeAssignedTargetingOptionDetails	videoPlayerSize
  ViewabilityAssignedTargetingOptionDetails	Sichtbarkeit

• In Version 2 wurden die folgenden Enum-Werte hinzugefügt:

  Enum	Wert(e)
  AgeRange	AGE_RANGE_18_20 AGE_RANGE_21_24 AGE_RANGE_25_29 AGE_RANGE_30_34 AGE_RANGE_35_39 AGE_RANGE_40_44 AGE_RANGE_45_49 AGE_RANGE_50_54 AGE_RANGE_55_59 AGE_RANGE_60_64
  ContentRatingTier	CONTENT_RATING_TIER_FAMILIES
  Anzeigenplattform	EXCHANGE_DAX EXCHANGE_FYBER EXCHANGE_VISTAR
  LineItemType	LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE
  ReservationType	RESERVATION_TYPE_INSTANT_RESERVE RESERVATION_TYPE_PETRA_VIRAL
  SensitiveCategory	SENSITIVE_CATEGORY_EMBEDDED_VIDEO SENSITIVE_CATEGORY_LIVE_STREAMING_VIDEO

• Die folgenden Enum-Werte wurden in Version 2 entfernt:

  Enum	Wert(e)
  LineItemFlightDateType	LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER
  LineItemWarningMessage	APP_INSTALL_NO_CONVERSION_PIXEL APP_INSTALL_NO_OPTIMAL_BIDDING_STRATEGY CREATIVE_SIZE_NOT_IN_USE_FOR_TARGETED_DEALS NO_CREATIVE_FOR_TARGETED_DEALS NO_POSITIVE_AUDIENCE_LIST_TARGETED TARGETING_DEPRECATED_GEO_TARGET TARGETING_REVOKED_OR_CLOSED_USER_LIST

v1

• Die folgenden Enum-Werte wurden in Version 1 hinzugefügt:

  Enum	Wert(e)
  Anzeigenplattform	EXCHANGE_DAX EXCHANGE_FYBER EXCHANGE_VISTAR

26. Mai 2022

Es wurde die Möglichkeit hinzugefügt, InventorySource-Ressourcen zu erstellen und GuaranteedOrder-Ressourcen über neue inventorySources-Dienstschreibmethoden und einen neuen guaranteedOrders-Dienst zu verwalten.

Das Feld modelReadiness wurde in der Ressource CustomBiddingAlgorithm eingeführt. In diesem Feld wird die Bereitschaft des Algorithmusmodells für jeden Werbetreibenden aufgeführt, der darauf zugreifen kann.

Es wurde eine neue Funktion für den filter-Abfrageparameter für die Methode advertisers.creatives.list aktiviert, mit der der Nutzer nur Creatives mit einem updateTime vor oder nach einem bestimmten Zeitstempel abrufen kann.

Unterstützung für die neueste SDF-Version v5.5 wurde durch Hinzufügen des Enum-Werts SdfVersion hinzugefügt.

Neue Funktionen

• Die folgenden Methoden wurden hinzugefügt:

  Dienst	Methode(n)
  guaranteedOrders	create editGuaranteedOrderReadAccessors get list patch
  inventorySources	create editInventorySourceReadWriteAccessors patch

• Die folgenden Felder wurden hinzugefügt:

  Ressource	Feld(er)
  CustomBiddingAlgorithm	modelReadiness
  InventorySource	inventorySourceProductType guaranteedOrderId readAdvertiserIds readPartnerIds readWriteAccessors

• Die folgenden Enum-Werte wurden hinzugefügt:

  Enum	Wert(e)
  SdfVersion	SDF_VERSION_5_5

• Die folgenden Listenmethoden können jetzt nach den folgenden Attributen gefiltert werden:

  Methode	Feld(er)
  advertisers.creatives.list	updateTime

31. März 2022

Unterstützung für das Abrufen und Festlegen von Targeting auf Inhaltsdauer, Streamtyp und Genre hinzugefügt.

Dem InsertionOrder-Objekt wurde das Feld billableOutcome hinzugefügt.

Das Feld raiseBidForDeals wurde dem MaximizeSpendBidStrategy-Objekt hinzugefügt. Damit können Nutzer festlegen, ob die Gebotsstrategie Mindestpreise des Werbetreibenden für ausgewählte Deals anwendet.

Neue Funktionen

• Die folgenden Felder wurden hinzugefügt:

  Ressource	Feld(er)
  AssignedTargetingOption	contentDurationDetails contentGenreDetails contentStreamTypeDetails
  InsertionOrder	billableOutcome
  MaximizeSpendBidStrategy	raiseBidForDeals
  TargetingOption	contentDurationDetails contentGenreDetails contentStreamTypeDetails

• Die folgenden Enum-Werte wurden hinzugefügt:

  Enum	Wert(e)
  TargetingType	TARGETING_TYPE_CONTENT_DURATION TARGETING_TYPE_CONTENT_GENRE TARGETING_TYPE_CONTENT_STREAM_TYPE

2. Februar 2022

Unterstützung für das Erstellen, Aktualisieren und Bearbeiten von Mitgliedern bestimmter Ressourcen vom Typ „Kundenabgleich“ FirstAndThirdPartyAudience wurde hinzugefügt. Auf der Seite Zielgruppen für den Kundenabgleich hochladen in unserem neuen Leitfaden Zielgruppen verwenden wird beschrieben, wie Sie diese neuen Funktionen nutzen können.

Wir haben ein neues Feld reservationType in den Ressourcen InsertionOrder und LineItem eingeführt, das angibt, ob eine Ressource Tag-Garantie, Programmatic Guaranteed oder keine Garantie hat.

Es wurde die Möglichkeit hinzugefügt, abzurufen und festzulegen, ob für eine Werbebuchung automatisch Targeting auf neuen Anzeigenplattformen erfolgt. Dazu wurde das neue Feld excludeNewExchanges eingeführt.

Zusätzlich zu den neuen Funktionen wurden die standardmäßigen Kontingentlimits verdoppelt.

Neue Funktionen

• Die folgenden Methoden wurden hinzugefügt:

  Dienst	Methode(n)
  firstAndThirdPartyAudiences	create editCustomerMatchMembers patch

• Die folgenden Felder wurden hinzugefügt:

  Ressource	Feld(er)
  FirstAndThirdPartyAudience	appId contactInfoList mobileDeviceIdList
  InsertionOrder	reservationType
  LineItem	excludeNewExchanges reservationType

8. Dezember 2021

Unter dem Targeting-Typ TARGETING_TYPE_AUDIO_CONTENT_TYPE wird jetzt auch das Targeting nach Audio-Inhaltstyp unterstützt.

Neue Funktionen

• Die folgenden Felder wurden hinzugefügt:

  Ressource	Feld(er)
  AssignedTargetingOption	audioContentTypeDetails
  TargetingOption	audioContentTypeDetails

• Die folgenden Enum-Werte wurden hinzugefügt:

  Enum	Wert(e)
  TargetingType	TARGETING_TYPE_AUDIO_CONTENT_TYPE

8. November 2021

Es wurde die vollständige Unterstützung für die Verwaltung von Algorithmen für benutzerdefinierte Gebote und deren Skripts hinzugefügt. Dazu zählen:

• Funktionen zum Erstellen neuer und zum Aktualisieren vorhandener customBiddingAlgorithms.
• Sie können Skripts hochladen, indem Sie zuerst einen verfügbaren Ressourcenstandort abrufen und dann die Datei an diesen Standort hochladen.
• Ein neuer customBiddingAlgorithms.scripts-Dienst zum Abrufen und Erstellen von customBiddingScripts.

Dem Leitfaden Werbebuchungen verwalten wurde die neue Seite Benutzerdefinierte Gebotseinstellung implementieren hinzugefügt. Dort wird beschrieben, wie Sie einen Algorithmus für die benutzerdefinierte Gebotseinstellung erstellen, ein Skript hochladen und den Algorithmus für die benutzerdefinierte Gebotseinstellung als Gebotsstrategie einer Werbebuchung zuweisen.

Unterstützung für die neueste SDF-Version, v5.4, durch Hinzufügen des Enum-Werts SdfVersion.

Neue Funktionen

• Die folgenden Methoden wurden hinzugefügt:

  Dienst	Methode(n)
  customBiddingAlgorithms	create patch uploadScript
  customBiddingAlgorithms.scripts	create get list
  media	upload

• Die folgenden Enum-Werte wurden hinzugefügt:

  Enum	Wert(e)
  SdfVersion	SDF_VERSION_5_4

14. September 2021

Unter den Targeting-Typen TARGETING_TYPE_BUSINESS_CHAIN und TARGETING_TYPE_POI wird jetzt auch das Umgebungs-Targeting unterstützt.

Es wurde die Möglichkeit hinzugefügt, mit targetingTypes.targetingOptions.search nach verfügbaren Targeting-Optionen für TARGETING_TYPE_BUSINESS_CHAIN und TARGETING_TYPE_POI zu suchen, da sie nicht über die Methoden targetingTypes.targetingOptions.get oder targetingTypes.targetingOptions.list abgerufen werden können.

Die Felder sharedAdvertiserIds und customBiddingAlgorithmState wurden der Ressource „Algorithmus für benutzerdefinierte Gebotseinstellung“ hinzugefügt. Außerdem wird jetzt der Typ GOAL_BUILDER_BASED für Algorithmen für benutzerdefinierte Gebotseinstellung unterstützt.

Der Enum Exchange wurden zwei neue Werte hinzugefügt.

Neue Funktionen

• Die folgenden Felder wurden hinzugefügt:

  Ressource	Feld(er)
  AssignedTargetingOption	businessChainDetails poiDetails
  CustomBiddingAlgorithm	customBiddingAlgorithmState sharedAdvertiserIds
  TargetingOption	businessChainDetails poiDetails
  Anfragetext für TargetingOptions.search	businessChainSearchTerms poiSearchTerms

• Die folgenden Enum-Werte wurden hinzugefügt:

  Enum	Wert(e)
  CustomBiddingAlgorithmType	GOAL_BUILDER_BASED
  Anzeigenplattform	EXCHANGE_RED_FOR_PUBLISHERS EXCHANGE_TAPJOY
  TargetingType	TARGETING_TYPE_BUSINESS_CHAIN TARGETING_TYPE_POI

• Die folgenden Listenmethoden können jetzt nach den folgenden Attributen gefiltert werden:

  Methode	Feld(er)
  customBiddingAlgorithms.list	customBiddingAlgorithmState

4. August 2021

Unter dem Targeting-Typ TARGETING_TYPE_OMID wird jetzt Targeting für Inventar mit Open Measurement unterstützt.

Die maximale Anzahl der zugewiesenen Targeting-Optionen, die auf einer einzelnen Seite verschiedener Methoden für Listen mit zugewiesenen Targeting-Optionen für Werbetreibende, Kampagnen, Anzeigenaufträge und Werbebuchungen zurückgegeben werden können, wurde mithilfe des Methodenparameters pageSize erhöht.

Neue Funktionen

• Die folgenden Felder wurden hinzugefügt:

  Ressource	Feld(er)
  AssignedTargetingOption	omidDetails
  TargetingOption	omidDetails

• Die folgenden Enum-Werte wurden hinzugefügt:

  Enum	Wert(e)
  TargetingType	TARGETING_TYPE_OMID

• Die maximale Seitengröße wurde für die folgenden Listenmethoden erhöht:

  Methode	Neue maximale Seitengröße
  advertisers.campaigns.targetingTypes.assignedTargetingOptions.list	5000
  advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.list	5000
  advertisers.lineItems.targetingTypes.assignedTargetingOptions.list	5000
  advertisers.targetingTypes.assignedTargetingOptions.list	5000

26. Mai 2021

Wir haben den Dienst advertisers.invoices eingeführt, mit dem Nutzer Folgendes tun können:

• Rechnungen abrufen, die einem Werbetreibenden in einem bestimmten Monat ausgestellt wurden.
• den Währungscode, der von einem Werbetreibenden in einem bestimmten Monat verwendet wurde.

Der Kampagnenressource wurde das Feld campaignBudgets hinzugefügt. Budgetsegmente für Anzeigenaufträge können mit einem Kampagnenbudget verknüpft werden. Dadurch wird das Gesamtbudget der zugehörigen Segmente auf den Gesamtbetrag des Kampagnenbudgets beschränkt.

Unter dem neuen Targeting-Typ TARGETING_TYPE_NATIVE_CONTENT_POSITION wird jetzt Targeting nach Position von nativen Inhalten unterstützt.

Der Werbetreibendenressource wurde das neue Feld prismaEnabled hinzugefügt, mit dem Nutzer die Integration mit dem Prisma-Tool von Mediaocean aktivieren können.

Unterstützung für den Enum-Wert ENTITY_STATUS_PAUSED für das Feld entityStatus des Werbetreibenden aktiviert.

Neue Funktionen

• Die folgenden Methoden wurden hinzugefügt:

  Dienst	Methode(n)
  advertisers.invoices	list lookupInvoiceCurrency

• Die folgenden Felder wurden hinzugefügt:

  Ressource	Feld(er)
  Werbetreibender	prismaEnabled
  AssignedTargetingOption	nativeContentPositionDetails
  Kampagne	campaignBudgets
  TargetingOption	nativeContentPositionDetails

• Die folgenden Enum-Werte wurden hinzugefügt:

  Enum	Wert(e)
  AssignedTargetingOption.Recency	RECENCY_45_DAYS
  Anzeigenplattform	EXCHANGE_MEDIANET
  TargetingType	TARGETING_TYPE_NATIVE_CONTENT_POSITION

• Die folgenden Enum-Werte sind jetzt für die folgenden Felder gültig:

  Ressource	Feld	Wert(e)
  Werbetreibender	entityStatus	ENTITY_STATUS_PAUSED

29. April 2021

Den Ressourcen Channel und Negative Keyword List wurden neue Felder hinzugefügt, die die Anzahl der Zeilenpositionen zurückgeben, in denen die Ressource für die Ausrichtung verwendet wird. Es wurden neue filter-Properties für die Methode „line item list“ aktiviert, mit denen der Nutzer nur Werbebuchungen abrufen kann, für deren Targeting bestimmte Channels oder Listen mit auszuschließenden Keywords verwendet werden.

Neue Funktionen

• Die folgenden Felder wurden hinzugefügt:

  Ressource	Feld(er)
  Kanal	negativelyTargetedLineItemCount positivelyTargetedLineItemCount
  NegativeKeywordList	targetedLineItemCount

• Die folgenden Listenmethoden können jetzt nach den folgenden Attributen gefiltert werden:

  Methode	Feld(er)
  advertisers.lineItems.list	targetedChannelId targetedNegativeKeywordListId

30. März 2021

Dem Line-Item-Dienst wurde eine neue Methode hinzugefügt, mit der ein Line-Item mit Standardkonfigurationen generiert wird. Diese Standardwerte basieren auf dem angegebenen Werbebuchungstyp sowie den Einstellungen und dem zugewiesenen Targeting des übergeordneten Anzeigenauftrags.

Der Abruf der Kampagnenausrichtung wurde über einen neuen Dienst für die Kampagnenausrichtung und eine zusätzliche Bulk-Listenmethode ermöglicht.

Die App-Ausrichtung wurde erweitert, sodass Apps auf mehr Plattformen ausgerichtet werden können.

Wir haben mehrere Änderungen an den Diensten advertisers.channels.sites, partners.channels.sites und advertisers.negativeKeywordLists.negativeKeywords vorgenommen, um die Verwaltung von Kanal- und Listeninhalten mit auszuschließenden Keywords zu vereinfachen. Dazu gehören:

• Die replace-Methoden wurden hinzugefügt. Damit kann ein Nutzer den vorhandenen Inhalt einer Channel- oder Negativkeyword-Liste vollständig überschreiben.
• Die Anforderung, dass keine vorhandenen Elemente in den Feldern createdSites oder createdNegativeKeywords von Bulk-Bearbeitungsanfragen enthalten sein dürfen, wurde entfernt.
• Die maximale Anzahl von Elementen, die auf einer einzelnen Seite einer list sites- oder list negative keywords-Antwort zurückgegeben werden können, wurde erhöht.

Neue Funktionen

• Die folgenden Methoden wurden hinzugefügt:

  Dienst	Methode(n)
  advertisers.campaigns	bulkListCampaignAssignedTargetingOptions
  advertisers.campaigns.targetingTypes.assignedTargetingOptions	get list
  advertisers.channels.sites	replace
  advertisers.lineItems	generateDefault
  advertisers.negativeKeywordLists.negativeKeywords	replace
  partners.channels.sites	replace

• Die folgenden Felder wurden hinzugefügt:

  Ressource	Feld(er)
  AssignedTargetingOption.AppAssignedTargetingOptionDetails	appPlatform

• Die maximale Seitengröße wurde für die folgenden Listenmethoden erhöht:

  Methode	Alte maximale Seitengröße	Neue maximale Seitengröße
  advertisers.channels.sites.list	100	10000
  advertisers.negativeKeywordLists.negativeKeywords.list	100	1000
  partners.channels.sites.list	100	10000

Verworfene Produkte/Funktionen

• Die folgenden Enum-Werte können neuen oder vorhandenen Ressourcen nicht mehr zugewiesen werden:

  Enum	Wert(e)
  PartnerRevenueModelMarkupType	PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP

24. Februar 2021

Es wurde ein neuer Targeting-Dienst für Anzeigenaufträge und eine zusätzliche Methode für Bulk-Listen eingeführt, mit der das Targeting abgerufen werden kann, das Anzeigenaufträgen zugewiesen ist. Die Creative-Ressource wurde erweitert und reine Ausgabefelder für Creatives für die Verwendung durch Audio-Creatives von Drittanbietern hinzugefügt. Es wurden neue Leistungstypen für Zielvorhaben für die Verwendung durch Anzeigenauftrags- und Kampagnen-Ressourcen hinzugefügt.

Neue Funktionen

• Die folgenden Methoden wurden hinzugefügt:

  Dienst	Methode(n)
  advertisers.insertionOrders	bulkListInsertionOrderAssignedTargetingOptions
  advertisers.insertionOrders.targetingTypes.assignedTargetingOptions	get list

• Die folgenden Felder wurden hinzugefügt:

  Ressource	Feld(er)
  Creative	mp3Audio oggAudio

• Die folgenden Enum-Werte wurden hinzugefügt:

  Enum	Wert(e)
  ContentInstreamPosition	CONTENT_INSTREAM_POSITION_UNKNOWN
  PerformanceGoalType	PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE PERFORMANCE_GOAL_TYPE_CLICK_CVR PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR PERFORMANCE_GOAL_TYPE_VCPM PERFORMANCE_GOAL_TYPE_VIDEO_COMPLETION_RATE PERFORMANCE_GOAL_TYPE_VTR

27. Januar 2021

Abruf und Verwaltung von TV-Anzeigenaufträgen und Over-the-Top-Werbebuchungen durch Einführung eines neuen InsertionOrderType-Felds und eines neuen LineItemType-Enum-Werts. Unterstützung für Werbebuchungen für mobile Apps über das Werbebuchungsfeld mobileApp hinzugefügt. Erweiterte Unterstützung für Exchange, Google-Zielgruppen und SDF durch zusätzliche Enumerationswerte. Es wurde die Möglichkeit eingeführt, advertisers.list-Werte nach der Uhrzeit der letzten Aktualisierung zu filtern und zu sortieren.

Neue Funktionen

• Die folgenden Felder wurden hinzugefügt:

  Ressource	Feld(er)
  InsertionOrder	insertionOrderType
  LineItem	mobileApp

• Die folgenden Enum-Werte wurden hinzugefügt:

  Enum	Wert(e)
  Anzeigenplattform	EXCHANGE_SHARETHROUGH EXCHANGE_SOUNDCAST
  GoogleAudienceType	GOOGLE_AUDIENCE_TYPE_EXTENDED_DEMOGRAPHIC GOOGLE_AUDIENCE_TYPE_LIFE_EVENT
  LineItemType	LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP
  SdfVersion	SDF_VERSION_5_3

• Die folgenden Listenmethoden können jetzt nach den folgenden Feldern sortiert und gefiltert werden:

  Methode	Feld(er)
  Werbetreibende	updateTime

4. Dezember 2020

Es ist jetzt möglich, nach geografischen Regionen zu suchen und die Ergebnisse der Methode „Mehrere Ressourcen auflisten“ nach dem Zeitpunkt der letzten Aktualisierung zu filtern. Es wurde eine neue LineItemWarningMessage eingeführt, um Nutzer darüber zu informieren, wenn in einer Werbebuchung das eingestellte geografische Targeting verwendet wird.

Neue Funktionen

• Die folgenden Methoden wurden hinzugefügt:

  Dienst	Methode(n)
  targetingTypes.targetingOptions	search

• Die folgenden Enum-Werte wurden hinzugefügt:

  Enum	Wert(e)
  Anzeigenplattform	EXCHANGE_SUPERSHIP
  LineItemWarningMessage	TARGETING_DEPRECATED_GEO_TARGET

• Die folgenden Listenmethoden können jetzt nach den folgenden Feldern sortiert und gefiltert werden:

  Methode	Feld(er)
  advertisers.campaigns.list	updateTime
  advertisers.insertionOrders.list	updateTime
  advertisers.lineItems.list	updateTime

5. November 2020

Es ist jetzt möglich, manuelle Trigger zu erstellen, zuzuweisen und zu aktivieren, die die Ausgaben der zugehörigen Werbebuchungen auslösen. Es wurden Optionen zur Ausweitung der Ausrichtung eingeführt, mit denen sich die Ausrichtung einer Werbebuchung auf Nutzer ausweiten lässt, die den Nutzern in den Zielgruppen ähneln. Felder für benutzerdefinierte Segment-IDs wurden an DoubleVerify- und Integral Ad Science-Objekte angehängt, die für das Targeting für die Überprüfung durch Drittanbieter verwendet werden.

Neue Funktionen

• Die folgenden Dienste wurden hinzugefügt:

  Dienst	Methode(n)
  advertisers.manualTriggers	Aktivieren create deactivate get list patch

• Die folgenden Felder wurden hinzugefügt:

  Ressource	Feld(er)
  AssignedTargetingOption.DoubleVerify	customSegmentId
  AssignedTargetingOption.IntegralAdScience	customSegmentId
  LineItem	targetingExpansion
  LineItemFlight	triggerId

• Die folgenden Enum-Werte wurden hinzugefügt:

  Enum	Wert(e)
  LineItemFlightDateType	LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER

• Die folgenden Listenmethoden können jetzt nach den folgenden Feldern gefiltert werden:

  Methode	Feld(er)
  advertisers.lineItems.list	filter.triggerId

12. Oktober 2020

Es wurden abrufbare Warnmeldungen für die Werbebuchungsressource und ein Leistungstyp für das Zielvorhaben für die Klickrate (Click-through-Rate, CTR) eingeführt. warningMessages wurde als filterbares Feld beim Auflisten von Werbebuchungen hinzugefügt.

Zusätzlich zu den neuen Funktionen gelten jetzt neue Kontingentlimits. Außerdem ist eine neue Dokumentation zur Verwendung von Batchanfragen verfügbar.

Neue Funktionen

• Die folgenden Felder wurden hinzugefügt:

  Ressource	Feld(er)
  LineItem	warningMessages

• Die folgenden Enum-Werte wurden hinzugefügt:

  Enum	Wert(e)
  PerformanceGoalType	PERFORMANCE_GOAL_TYPE_CTR

• Die folgenden Listenmethoden können jetzt nach den folgenden Feldern gefiltert werden:

  Methode	Feld(er)
  advertisers.lineItems.list	warningMessages

28. August 2020

Der Antwort der Methode zur Überprüfung von Werbetreibenden wurden neue Felder hinzugefügt. Außerdem wurden verschiedenen Listenmethoden neue filterbare Felder hinzugefügt.

Neue Funktionen

• Die folgenden Felder wurden hinzugefügt:

  Ressource	Feld(er)
  Advertisers.Audit Response Body	adGroupCriteriaCount campaignCriteriaCount channelsCount negativeKeywordListsCount negativelyTargetedChannelsCount

• Die folgenden Listenmethoden können jetzt nach den folgenden Feldern gefiltert werden:

  Methode	Feld(er)
  advertisers.list	advertiserId displayName
  advertisers.campaigns.list	campaignId displayName
  advertisers.insertionOrders.list	budget.budget_segments.date_range.end_date displayName
  advertisers.lineItems.list	displayName lineItemId
  targetingTypes.targetingOptions.list	carrierAndIspDetails.type geoRegionDetails.geo_region_type

4. August 2020

Wir haben neue Nutzerverwaltungs-, Partner- und Partner-Targeting-Dienste eingeführt. Wir haben Tools eingeführt, mit denen Nutzer proaktiv verhindern können, dass sie Kontoeinheitenlimits erreichen. Unterstützung für Audiowerbebuchungen und die Verwendung von Algorithmen für benutzerdefinierte Gebote in Werbebuchungs- und Anzeigenauftrags-Gebotsstrategien wurde hinzugefügt.

Neue Funktionen

• Die folgenden Dienste wurden hinzugefügt:

  Dienst	Methode(n)
  customBiddingAlgorithms	get list
  Partner	bulkEditPartnerAssignedTargetingOptions get list
  partners.targetingTypes.assignedTargetingOptions	create delete get list
  Nutzer	bulkEditAssignedUserRoles create delete get list patch

• Die folgenden Methoden wurden hinzugefügt:

  Dienst	Methode(n)
  Werbetreibende	audit

• Die folgenden Felder wurden hinzugefügt:

  Ressource	Feld(er)
  MaximizeSpendBidStrategy	customBiddingAlgorithmId
  PerformanceGoalBidStrategy	customBiddingAlgorithmId

• Die folgenden Enum-Werte wurden hinzugefügt:

  Enum	Wert(e)
  BiddingStrategyPerformanceGoalType	BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO
  LineItemType	LINE_ITEM_TYPE_AUDIO_DEFAULT

• Die folgenden Listenmethoden können jetzt nach den folgenden Feldern sortiert und gefiltert werden:

  Methode	Feld(er)
  advertisers.lineItems.list	flight.dateRange.endDate

• Die folgenden Bereiche wurden für die Verwendung mit den folgenden Diensten hinzugefügt:

  Umfang	Dienste
  https://www.googleapis.com/auth/display-video-user-management	Nutzer

24. Juni 2020

Wir haben ein kleines Update veröffentlicht, in dem eine Create-Methode für Partner- und Werbetreibenden-Channels, neue FirstAndThirdPartyAudience-Felder und zusätzliche exchange-Enum-Werte hinzugefügt wurden.

Neue Funktionen

• Die folgenden Dienste wurden hinzugefügt:

  Dienst	Methode(n)
  advertisers.channels	create
  partners.channels	create

• Die folgenden Felder wurden hinzugefügt:

  Ressource	Feld(er)
  FirstAndThirdPartyAudience	activeDisplayAudienceSize audienceSource audienceType description displayAudienceSize displayDesktopAudienceSize displayMobileAppAudienceSize displayMobileWebAudienceSize gmailAudienceSize membershipDurationDays youtubeAudienceSize

• Die folgenden Enum-Werte wurden hinzugefügt:

  Enum	Wert(e)
  Anzeigenplattform	EXCHANGE_OPEN8 EXCHANGE_TRITON EXCHANGE_UNRULYX

• Die folgenden Listenmethoden können jetzt nach den folgenden Feldern gefiltert werden:

  Methode	Feld(er)
  advertisers.creatives.list	creativeId

2. Juni 2020

Es wurde die Möglichkeit eingeführt, eine Teilmenge von targetierbaren Einheiten zu erstellen, zu patchen und zu füllen. Außerdem kann das Targeting auf Werbetreibendenebene für drei Targeting-Typen geändert werden: Channel, Ausschluss von Labels für digitale Inhalte und Ausschluss sensibler Kategorien.

Neue Funktionen

• Die folgenden Dienste wurden hinzugefügt:

  Dienst	Methode(n)
  advertisers.channels.sites	bulkEdit create delete list
  advertisers.locationLists.assignedLocations	bulkEdit create delete list
  advertisers.negativeKeywordLists.negativeKeywords	bulkEdit create delete list
  advertisers.targetingTypes.assignedTargetingOptions	create delete get list
  inventorySourceGroups.assignedInventorySources	bulkEdit create delete list
  partners.channels.sites	bulkEdit create delete list

• Die folgenden Methoden wurden hinzugefügt:

  Dienst	Methode(n)
  Werbetreibende	bulkEditAdvertiserAssignedTargetingOptions bulkListAdvertiserAssignedTargetingOptions
  advertisers.channels	patch
  advertisers.locationLists	create patch
  advertisers.negativeKeywordLists	create delete patch
  inventorySourceGroups	create delete patch
  partners.channels	patch

• Die folgenden Felder wurden hinzugefügt:

  Ressource	Feld(er)
  Werbetreibender	servingConfig
  Creative	lineItemIds
  insertionOrder.insertionOrderBudgetSegment	campaignBudgetId

27. April 2020

Wir haben eine große Reihe von Funktionen eingeführt, die den Umfang der API über SDF hinaus erweitern. Die Kernressourcenverwaltung wurde hinzugefügt. Damit können Sie Entitäten wie Werbetreibende, Kampagnen, Einfügungsaufträge, Werbebuchungen und Creatives erstellen, abrufen, aktualisieren und löschen. Dank neuer Funktionen lässt sich das Targeting auch auf Ebene der Werbebuchung bearbeiten.

Neue Funktionen

Die folgenden Dienste wurden hinzugefügt:

Dienst	Methode(n)
Werbetreibende	create delete get list patch
advertisers.assets	upload
advertisers.campaigns	create delete get list patch
advertisers.channels	get list
advertisers.creatives	create delete get list patch
advertisers.insertionOrders	create delete get list patch
advertisers.lineItems	bulkEditLineItemAssignedTargetingOptions bulkListLineItemAssignedTargetingOptions create delete get list patch
advertisers.lineItems.targetingTypes.assignedTargetingOptions	create delete get list
advertisers.locationLists	get list
advertisers.negativeKeywordLists	get list
combinedAudiences	get list
customLists	get list
firstAndThirdPartyAudiences	get list
floodlightGroups	get patch
googleAudiences	get list
inventorySourceGroups	get list
inventorySources	get list
partners.channels	get list
partners.channels	get list

9. März 2020

Display & Video 360 API v1 wurde eingeführt. Dies ist die erste Version der API.

Bekannte Probleme

Keine.