Versionshinweise

Diese Seite enthält Versionshinweise zur Display & Video 360 API.

Neueste API-Version: v3

17. Juni 2024

Neue Funktionen

Die Verwaltung des Keyword-Targetings, das auf Werbetreibendenebene zugewiesen ist, wird jetzt unterstützt.

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

• Bei den folgenden Methoden werden jetzt die folgenden Ausrichtungstypen unterstützt:

  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

• Bei den folgenden Methoden werden jetzt die folgenden Ausrichtungstypen unterstützt:

  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

Die Unterstützung für strukturierte Datendateien (SDF-Version 7.1) wurde 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, Anzeigenplattformen 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 besteht jetzt die Möglichkeit, Mitglieder aus Zielgruppen zum Kundenabgleich zu entfernen.

Das Targeting auf neue Anzeigenplattformen wird jetzt unterstützt.

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 ist jetzt möglich, Floodlight-Aktivitäten über einen neuen floodlightGroups.floodlightActivities-Dienst abzurufen.

In einem neuen Feld wird angegeben, ob das Targeting einer "YouTube und Partner"-Werbebuchung Google TV-Inventar umfasst.

Es wurde ein neues Feld hinzugefügt, um die letzte Anmeldung eines Display & Video 360-Nutzers weiterzuleiten.

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

Unterstützung für die Übergabe der Endnutzereinwilligung beim Hochladen von Mitgliedern von Zielgruppen zum Kundenabgleich in allen Live-Versionen hinzugefügt.

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

v3 wurde aus der öffentlichen Betaphase und in die allgemeine Verfügbarkeit verschoben.

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

Durch die Hinzufügung des Enum-Werts SDF_VERSION_7 in v2 und v3 werden jetzt strukturierte Datendateien in Version 7 unterstützt.

v3

• Die folgenden enum-Werte 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

Veröffentlichung von v3 als öffentliche Betaversion mit den folgenden Änderungen:

• Listen mit Umgebungen können vollständig verwaltet werden, sodass mit dem Dienst advertisers.locationLists.assignedLocations Standorte erstellt und gelöscht werden können, die TARGETING_LOCATION_TYPE_PROXIMITY LocationList-Ressourcen zugewiesen sind.
• Ein neues boolesches enableOptimizedTargeting-Feld, das das Feld targetingExpansionLevel im TargetingExpansionConfig-Objekt ersetzt.
• Die Anforderung des Felds billingConfig in der Ressource Advertiser, das beim Senden von advertisers.create-Anfragen enthalten sein muss, und ein neues Feld billingConfig in der Ressource Partner.
• Neue Ressourcen vom Typ AdGroup und AdGroupAd, die die Ressourcen YoutubeAdGroup und YoutubeAdGroupAd in Version 2 ersetzen.

Führen Sie die Schritte in unserer Migrationsanleitung aus, um von v2 zu v3 zu migrieren.

Unterstützung für drei neue LineItemType-Werte, einen neuen YoutubeAndPartnersBiddingStrategyType und einen neuen PartnerCostType in v2 und v3.

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	erstellen get list

• Die folgenden Methoden wurden entfernt:

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

• Das folgende Methodenverhalten hat sich geändert:

  Methode	Änderung(en)
  advertisers.locationLists.create	Unterstützt jetzt das Erstellen von TARGETING_LOCATION_TYPE_PROXIMITY-LocationList-Ressourcen.
  advertisers.locationLists.patch	Unterstützt jetzt das Aktualisieren von TARGETING_LOCATION_TYPE_PROXIMITY-Ressourcen vom Typ „LocationList“.
  advertisers.locationLists.assignedLocations.bulkEdit	Unterstützt jetzt die Bulk-Bearbeitung der AssignedLocation-Ressourcen in TARGETING_LOCATION_TYPE_PROXIMITY-Ressourcen vom Typ LocationList.
  advertisers.locationLists.assignedLocations.create	Unterstützt jetzt das Erstellen von AssignedLocation-Ressourcen in TARGETING_LOCATION_TYPE_PROXIMITY-Ressourcen vom Typ LocationList.

• Die folgenden Abfrageparameter wurden hinzugefügt:

  Methode	Parameter
  inventorySources.get	advertiserId

• Die folgenden Felder sind 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 enum-Werte 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 Anzeigenplattformen und zwei neue YouTube und Partner-Gebotsstrategietypen hinzugefügt.

YouTube und Partner-Werbebuchungen wurde das neue Feld effectiveContentCategory hinzugefügt, um das YoutubeAndPartnersContentCategory-Objekt anzuzeigen, das von der Werbebuchung verwendet wird, wenn Werte berücksichtigt werden, die sowohl auf Werbetreibenden- als auch auf Werbebuchungsebene zugewiesen wurden.

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 v1 und v2 wurde für Structured Data Files (SDF) v6 ein neuer SdfVersion-Wert 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 einer Werbebuchung zugewiesen wird, wenn für das verworfene Feld excludeFirstPartyAudience der Wert true festgelegt ist. Das Feld excludeFirstPartyAudience wird nach dem 25. März 2023 eingestellt und 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 besteht jetzt die Möglichkeit, YouTubeAdGroup- und YouTubeAdGroupAd-Ressourcen abzurufen sowie das Ressourcen-Targeting für YouTube-Anzeigengruppen. Außerdem haben wir neue abrufbare Targeting-Typen hinzugefügt, die auf YouTube-Anzeigengruppenebene verwendet werden. Weitere Informationen findest du auf unserer neuen Anleitungsseite zum Abrufen von YouTube und Partner-Ressourcen.

Version 1 und Version 2 unterstützen vier zusätzliche Anzeigenplattformen.

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 wurde aus der öffentlichen Betaphase und in die allgemeine Verfügbarkeit verschoben.

Der Ressource AssignedTargetingOption wurde ein neues assignedTargetingOptionIdAlias-Feld hinzugefügt, das beim Abrufen und Löschen von Targeting anstelle von assignedTargetingOptionId verwendet werden kann. Dieses Feld wird nur für zugewiesene Targeting-Optionen von Targeting-Typen festgelegt, die über "enum" zugewiesen werden. Der Alias-Wert ist der relevante enum-Wert als String.

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

Unterstützung für das Abrufen von Over-the-Top-Werbebuchungen für YouTube und Partner (gekennzeichnet durch drei neue LineItemType-Werte) wurde hinzugefügt.

Die maximale Seitengröße für zahlreiche list-Methoden in v1 und v2 wurde 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

Dieses Update behebt die folgenden bekannten Probleme in Version 2:

• Zugewiesene Targeting-Optionen von Targeting-Typen, die in Version 2 mithilfe von Enum-Werten zugewiesen wurden, konnten nicht mit assignedTargetingOptionId entfernt oder abgerufen werden. Stattdessen wurde erwartet, dass Nutzer den enum-Wert verwenden. Nach diesem Update können die zugewiesenen Targeting-Optionen entweder mit dem assignedTargetingOptionId- oder dem Enum-Wert entfernt oder abgerufen werden, der durch das neue Feld assignedTargetingOptionIdAlias in der Ressource AssignedTargetingOption identifiziert wird.
• Die Anfrage bulkUpdate der Werbebuchung wurde nicht korrekt mit dem Anfrageparameter advertisersId verwendet, wodurch 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 besteht jetzt die Möglichkeit, eine vorhandene Werbebuchung im übergeordneten InsertionOrder zu duplizieren.

Einführung der teilweisen Schreibunterstützung für das Targeting von Anzeigenaufträgen für einen Teil der Targeting-Typen durch Hinzufügen der Methoden create und delete zum Dienst advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.

Neue Funktionen

v2

• Die folgenden Methoden wurden hinzugefügt:

  Dienst	Methode(n)
  advertisers.insertionOrders.targetingTypes.assignedTargetingOptions	erstellen delete
  advertisers.lineItems	Duplikat

v1

Version 1 wurden keine neuen Funktionen hinzugefügt.

20. September 2022

Veröffentlichung von v2 als öffentliche Betaversion mit den folgenden Änderungen:

• YouTube und Partner-Werbebuchungen und ihre Targeting-Einstellungen können mit den Methoden get und list in den Diensten advertisers.lineItems und advertisers.lineItems.targetingTypes.assignedTargetingOptions abgerufen werden.
• Zwei neue Bulk-Targeting-Methoden im advertisers.lineItems-Dienst, die das Bearbeiten und Abrufen von zugewiesenen Targeting für mehrere Werbebuchungen mit einer einzigen Anfrage ermöglichen
• Eine neue bulkUpdate-Methode, mit der Nutzer den entityStatus mehrerer Werbebuchungen in einer einzelnen Anfrage aktualisieren können.
• Neue Targeting-Logik, bei der AssignedTargetingOption-Ressourcen einer Teilmenge von Targeting-Typen mithilfe von Enum-Werten zugewiesen und abgerufen werden müssen, anstatt über den targetingTypes.targetingOptions-Dienst abzurufende Targeting-Options-IDs.

Führen Sie die Schritte in unserer Migrationsanleitung aus, um von v1 zu v2 zu migrieren.

In Version 1 werden drei neue Anzeigenplattformen unterstützt.

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 v2 umbenannt:

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

• AssignedTargetingOption Ressourcen der folgenden Targeting-Typen verwenden Enums für die Targeting-Zuweisung in Version 2. Das Feld assignedTargetingOptionId für AssignedTargetingOption Ressourcen dieser Targeting-Typen wurde in Version 2 ebenfalls aktualisiert, sodass jetzt Stringversionen der Aufzählungswerte 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

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

  Ressource	Feld(er)
  CustomBiddingAlgorithm	modelDetails
  DeviceTypeAssignedTargetingOptionDetails	youtubeAndPartnersBidMultiplier
  DigitalContentLabelAssignedTargetingOptionDetails	excludedContentRatingTier
  ExchangeAssignedTargetingOptionDetails	Anzeigenplattform
  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 wurden in Version 2 zu Pflichtfeldern:

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

• Die folgenden Werte für Aufzählungen wurden in Version 2 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 v1 hinzugefügt:

  Enum	Wert(e)
  Anzeigenplattform	EXCHANGE_DAX EXCHANGE_FYBER EXCHANGE_VISTAR

26. Mai 2022

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

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

Für die Methode advertisers.creatives.list wurde eine neue Funktion für den Abfrageparameter filter hinzugefügt, mit der Nutzer nur Creatives mit einem updateTime vor oder nach einem bestimmten Zeitstempel abrufen können.

Die neueste Version von SDF (v5.5) wird durch den Enum-Wert SdfVersion unterstützt.

Neue Funktionen

• Die folgenden Methoden wurden hinzugefügt:

  Dienst	Methode(n)
  guaranteedOrders	erstellen editGuaranteedOrderReadAccessors get list patch
  inventorySources	erstellen 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 Eigenschaften gefiltert werden:

  Methode	Feld(er)
  advertisers.creatives.list	updateTime

31. März 2022

Das Abrufen und Festlegen des Targetings auf Inhaltsdauer, Streamtyp und Genre wurde hinzugefügt.

Dem Objekt InsertionOrder wurde das Feld billableOutcome hinzugefügt.

Im MaximizeSpendBidStrategy-Objekt wurde das Feld raiseBidForDeals eingeführt. Damit können Nutzer festlegen, ob über die Gebotsstrategie Mindestpreise von Werbetreibenden auf ausgewählte Deals angewendet werden sollen.

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 zum Erstellen, Aktualisieren und Bearbeiten von Mitgliedern bestimmter FirstAndThirdPartyAudience-Ressourcen für den Kundenabgleich wurde hinzugefügt. In unserem neuen Leitfaden Zielgruppen verwenden finden Sie auf der Seite Zielgruppen zum Kundenabgleich hochladen Informationen zur Verwendung dieser neuen Funktionen.

In den Ressourcen InsertionOrder und LineItem wurde ein neues reservationType-Feld eingeführt, das angibt, ob eine Ressource mit Tag-Garantie, programmatisch garantiert oder nicht garantiert ist.

Es wurde die Möglichkeit hinzugefügt, über das neue Feld excludeNewExchanges abzurufen und festzulegen, ob eine Werbebuchung automatisch auf neue Anzeigenplattformen ausgerichtet wird.

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

Neue Funktionen

• Die folgenden Methoden wurden hinzugefügt:

  Dienst	Methode(n)
  firstAndThirdPartyAudiences	erstellen editCustomerMatchMembers patch

• Die folgenden Felder wurden hinzugefügt:

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

8. Dezember 2021

Das Targeting auf Audiocontent-Typen unter dem Targeting-Typ TARGETING_TYPE_AUDIO_CONTENT_TYPE wird jetzt 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

Vollständige Unterstützung für die Verwaltung der Algorithmen für die benutzerdefinierte Gebotseinstellung und der zugehörigen Skripts. Dies ist z. B. in folgenden Situationen der Fall:

• Funktionen zum Erstellen und Aktualisieren vorhandener customBiddingAlgorithms.
• Möglichkeit zum Hochladen von Skripts durch den Prozess des Abrufens eines verfügbaren Ressourcenstandorts und des anschließenden Hochladens der Datei in diesen Speicherort.
• Einen neuen customBiddingAlgorithms.scripts-Dienst zum Abrufen und Erstellen customBiddingScripts.

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

Die neueste Version von SDF (v5.4) wird durch den Enum-Wert SdfVersion unterstützt.

Neue Funktionen

• Die folgenden Methoden wurden hinzugefügt:

  Dienst	Methode(n)
  customBiddingAlgorithms	erstellen patch uploadScript
  customBiddingAlgorithms.scripts	erstellen get list
  Medien	hochladen

• Die folgenden enum-Werte wurden hinzugefügt:

  Enum	Wert(e)
  SdfVersion	SDF_VERSION_5_4

14. September 2021

Die Unterstützung für das Umgebungs-Targeting unter den Targeting-Typen TARGETING_TYPE_BUSINESS_CHAIN und TARGETING_TYPE_POI wurde hinzugefügt.

Es ist jetzt möglich, mit targetingTypes.targetingOptions.search nach verfügbaren Targeting-Optionen für TARGETING_TYPE_BUSINESS_CHAIN und TARGETING_TYPE_POI zu suchen, da diese nicht mit den Methoden targetingTypes.targetingOptions.get oder targetingTypes.targetingOptions.list abgerufen werden können.

Die Ressource für den Algorithmus für die benutzerdefinierte Gebotseinstellung enthält neue Felder sharedAdvertiserIds und customBiddingAlgorithmState. Außerdem wird der Algorithmustyp GOAL_BUILDER_BASED für die benutzerdefinierte Gebotseinstellung unterstützt.

Zwei neue Werte wurden zur Aufzählung Exchange hinzugefügt.

Neue Funktionen

• Die folgenden Felder wurden hinzugefügt:

  Ressource	Feld(er)
  AssignedTargetingOption	businessChainDetails poiDetails
  CustomBiddingAlgorithm	customBiddingAlgorithmState sharedAdvertiserIds
  TargetingOption	businessChainDetails poiDetails
  TargetingOptions.search-Anfragetext	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 Eigenschaften gefiltert werden:

  Methode	Feld(er)
  customBiddingAlgorithms.list	customBiddingAlgorithmState

4. August 2021

Die für Open Measurement aktivierte Inventar-Targeting-Option unter dem Targeting-Typ TARGETING_TYPE_OMID wird jetzt unterstützt.

Die maximale Anzahl der zugewiesenen Targeting-Optionen, die auf einer einzelnen Seite mit verschiedenen Methoden der Liste der Targeting-Optionen für Werbetreibende, Kampagnen, Anzeigenaufträge und Werbebuchungen mithilfe des Methodenparameters pageSize zurückgegeben werden können, wurde 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	5.000
  advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.list	5.000
  advertisers.lineItems.targetingTypes.assignedTargetingOptions.list	5.000
  advertisers.targetingTypes.assignedTargetingOptions.list	5.000

26. Mai 2021

Der Dienst advertisers.invoices wurde eingeführt, mit dem Nutzer:

• Rechnungen abrufen, die einem Werbetreibenden in einem bestimmten Monat ausgestellt wurden.
• Sie können den Währungscode suchen, 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 das Gesamtbudget der Kampagne beschränkt.

Das Targeting auf native Inhaltspositionen wird unter dem neuen Targeting-Typ TARGETING_TYPE_NATIVE_CONTENT_POSITION unterstützt.

In der Ressource für Werbetreibende wurde ein neues prismaEnabled-Feld eingeführt, mit dem Nutzer die Integration in das Prisma-Tool von Mediaocean aktivieren können.

Der Aufzählungswert ENTITY_STATUS_PAUSED wird im Feld entityStatus des Werbetreibenden unterstützt.

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
  Campaign	campaignBudgets
  TargetingOption	nativeContentPositionDetails

• Die folgenden enum-Werte wurden hinzugefügt:

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

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

  Ressource	Field	Wert(e)
  Werbetreibender	entityStatus	ENTITY_STATUS_PAUSED

29. April 2021

Den Ressourcen Channel und Liste mit auszuschließenden Keywords wurden neue Felder hinzugefügt, die die Anzahl der Werbebuchungen zurückgeben, die die Ressource für das Targeting verwenden. Für die Methode für die Werbebuchungsliste wurden neue filter-Eigenschaften hinzugefügt, mit denen der Nutzer nur Werbebuchungen abrufen kann, für die im 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 Eigenschaften gefiltert werden:

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

30. März 2021

Wir haben dem Werbebuchungsdienst eine neue Methode hinzugefügt, die eine Werbebuchung mit Standardkonfigurationen generiert. Diese Standardwerte basieren auf dem angegebenen Werbebuchungstyp sowie auf den Einstellungen und dem zugewiesenen Targeting des übergeordneten Anzeigenauftrags.

Die Kampagnenausrichtung wurde über einen neuen Dienst für die Ausrichtung von Kampagnen und eine zusätzliche Methode für Bulk-Listen abgerufen.

Das App-Targeting wurde erweitert, damit Sie Apps auf mehr Plattformen ausrichten können.

An den Diensten advertisers.channels.sites, partners.channels.sites und advertisers.negativeKeywordLists.negativeKeywords wurden mehrere Änderungen vorgenommen, um die Verwaltung von Inhalten für Kanäle und Listen mit auszuschließenden Keywords zu vereinfachen. Zu diesen Änderungen gehören:

• Hinzufügen von replace-Methoden, mit denen Nutzer die vorhandenen Inhalte eines Kanals oder einer Liste mit auszuschließenden Keywords vollständig überschreiben können.
• Die Anforderung, dass keine vorhandenen Elemente in den Feldern createdSites oder createdNegativeKeywords von Bulk-Bearbeitungsanfragen enthalten sein dürfen, wurde entfernt.
• Die Erhöhung der maximalen Anzahl von Elementen, die auf einer einzelnen Seite einer Antwort vom Typ Websites auflisten oder auszuschließende Keywords auflisten zurückgegeben werden können.

Neue Funktionen

• Die folgenden Methoden wurden hinzugefügt:

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

• 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

Einstellung von Produkten und Funktionen

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

  Enum	Wert(e)
  PartnerRevenueModelMarkupType	PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP

24. Februar 2021

Es wurden ein neuer Dienst für das Targeting von Anzeigenaufträgen und eine zusätzliche Bulk-Listenmethode eingeführt, mit denen das Targeting abgerufen werden kann, das Anzeigenaufträgen zugewiesen ist. Die Creative-Ressource wurde erweitert und Nur-Ausgabe-Creative-Felder hinzugefügt, die für Audio-Creatives von Drittanbietern verwendet werden können. Es wurden neue Arten von Leistungsziel hinzugefügt, die für Ressourcen für Anzeigenaufträge und Kampagnen verwendet werden können.

Neue Funktionen

• Die folgenden Methoden wurden hinzugefügt:

  Dienst	Methode(n)
  advertisers.insertionOrders	bulkListInsertionOrderAssignedTargetingOptions
  advertisers.insertionOrders.targetingTypes.assignedTargetingOptions	Get Liste

• 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

Das Abrufen und Verwalten von TV-Anzeigenaufträgen und Over-the-Top-Werbebuchungen wurde durch die Einführung eines neuen Felds „Anzeigenauftragstyp“ und eines neuen Aufzählungswerts „LineItemType“ ermöglicht. Werbebuchungen für mobile Apps werden jetzt über das Werbebuchungsfeld mobileApp unterstützt. Erweiterte Anzeigenplattform-, Google-Zielgruppen- und SDF-Unterstützung durch zusätzliche enum-Werte. Es wurde die Möglichkeit eingeführt, advertisers.list-Werte nach 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)
  Austauschen	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-Targeting-Optionen zu suchen und die Ergebnisse mehrerer Ressourcenlistenmethoden nach der letzten Aktualisierung zu filtern. Eine neue LineItemWarningMessage wurde eingeführt, um Nutzer darüber zu informieren, wenn eine Werbebuchung nicht mehr unterstützte geografisches Targeting verwendet.

Neue Funktionen

• Die folgenden Methoden wurden hinzugefügt:

  Dienst	Methode(n)
  targetingTypes.targetingOptions	Suchen

• Die folgenden enum-Werte wurden hinzugefügt:

  Enum	Wert(e)
  Austauschen	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 wurde die Möglichkeit hinzugefügt, manuelle Trigger zu erstellen, zuzuweisen und zu aktivieren, die die Ausgaben der zugehörigen Werbebuchungen initiieren. Optionen für die Erweiterung des Targetings wurden eingeführt. Wenn diese festgelegt sind, kann das Targeting einer Werbebuchung auf Nutzer ausgeweitet werden, die denen in Zielgruppen ähneln. Angehängte benutzerdefinierte Segment-ID-Felder an DoubleVerify und Integral Ad Science-Objekte, die beim Verifikations-Targeting von Drittanbietern verwendet werden.

Neue Funktionen

• Die folgenden Dienste wurden hinzugefügt:

  Dienst	Methode(n)
  advertisers.manualTriggers	Aktivieren Erstellen Deaktivieren Get Liste 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

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

Zusätzlich zu den neuen Funktionen gibt es jetzt neue Kontingentlimits und eine neue Dokumentation zur Nutzung von Batchanfragen ist 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

Es wurden neue Felder zur Antwort der Prüfungsmethode für Werbetreibende und neue filterbare Felder für verschiedene Listenmethoden hinzugefügt.

Neue Funktionen

• Die folgenden Felder wurden hinzugefügt:

  Ressource	Feld(er)
  Antworttext von Werbetreibenden.Audit	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

Einführung neuer Dienste für die Nutzerverwaltung, Partner und Ausrichtung auf Partner. Einführung von Tools, mit denen Nutzer das Erreichen von Limits für Kontoentitäten proaktiv vermeiden können. Audiowerbebuchungen und Algorithmen für die benutzerdefinierte Gebotseinstellung werden in Gebotsstrategien für Werbebuchungen und Anzeigenaufträge unterstützt.

Neue Funktionen

• Die folgenden Dienste wurden hinzugefügt:

  Dienst	Methode(n)
  customBiddingAlgorithms	Get Liste
  Partner	bulkEditPartnerAssignedTargetingOptions Get Liste
  partners.targetingTypes.assignedTargetingOptions	Erstellen Löschen Get Liste
  Nutzer	bulkEditAssignedUserRoles Erstellen Löschen Get Liste 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 zur Verwendung für die folgenden Dienste hinzugefügt:

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

24. Juni 2020

Es wurde ein kleines Update eingeführt, mit dem eine Erstellungsmethode für Partner- und Werbetreibenden-Channels, neue FirstAndThirdPartyAudience-Felder und zusätzliche Aufzählungswerte für die Anzeigenplattform hinzugefügt wurden.

Neue Funktionen

• Die folgenden Dienste wurden hinzugefügt:

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

• Die folgenden Felder wurden hinzugefügt:

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

• Die folgenden enum-Werte wurden hinzugefügt:

  Enum	Wert(e)
  Austauschen	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, einen Teil der für das Targeting verfügbaren Entitäten zu erstellen, zu patchen und auszufüllen. Außerdem kann das Targeting auf Werbetreibendenebene für drei Targeting-Typen geändert werden: Channel, Ausschluss von Labels für digitalen Content und Ausschließen von sensiblen Kategorien.

Neue Funktionen

• Die folgenden Dienste wurden hinzugefügt:

  Dienst	Methode(n)
  advertisers.channels.sites	bulkEdit Erstellen Löschen Liste
  advertisers.locationLists.assignedLocations	bulkEdit Erstellen Löschen Liste
  advertisers.negativeKeywordLists.negativeKeywords	bulkEdit Erstellen Löschen Liste
  advertisers.targetingTypes.assignedTargetingOptions	Erstellen Löschen Get Liste
  inventorySourceGroups.assignedInventorySources	bulkEdit Erstellen Löschen Liste
  partners.channels.sites	bulkEdit Erstellen Löschen Liste

• Die folgenden Methoden wurden hinzugefügt:

  Dienst	Methode(n)
  Werbetreibende	bulkEditAdvertiserAssignedTargetingOptions bulkListAdvertiserAssignedTargetingOptions
  advertisers.channels	Patch
  advertisers.locationLists	Erstellen Patch
  advertisers.negativeKeywordLists	Erstellen Löschen Patch
  inventorySourceGroups	Erstellen Löschen Patch
  partners.channels	Patch

• Die folgenden Felder wurden hinzugefügt:

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

27. April 2020

Einführung eines umfangreichen Funktionssatzes, wodurch der Anwendungsbereich der API über SDF hinaus ausgeweitet wurde. Es wurde eine Kernressourcenverwaltung hinzugefügt, mit der Sie Entitäten wie Werbetreibende, Kampagnen, Anzeigenaufträge, Werbebuchungen und Creatives erstellen, abrufen, aktualisieren und löschen können. Mit den neuen Funktionen kann das Targeting auch auf Werbebuchungsebene bearbeitet werden.

Neue Funktionen

Die folgenden Dienste wurden hinzugefügt:

Dienst	Methode(n)
Werbetreibende	Erstellen Löschen Get Liste Patch
advertisers.assets	Hochladen
advertisers.campaigns	Erstellen Löschen Get Liste Patch
advertisers.channels	Get Liste
advertisers.creatives	Erstellen Löschen Get Liste Patch
advertisers.insertionOrders	Erstellen Löschen Get Liste Patch
advertisers.lineItems	bulkEditLineItemAssignedTargetingOptions bulkListLineItemAssignedTargetingOptions Erstellen Löschen Get Liste Patch
advertisers.lineItems.targetingTypes.assignedTargetingOptions	Erstellen Löschen Get Liste
advertisers.locationLists	Get Liste
advertisers.negativeKeywordLists	Get Liste
combinedAudiences	Get Liste
customLists	Get Liste
firstAndThirdPartyAudiences	Get Liste
floodlightGroups	Get Patch
googleAudiences	Get Liste
inventorySourceGroups	Get Liste
inventorySources	Get Liste
partners.channels	Get Liste
partners.channels	Get Liste

9. März 2020

Einführung von Version 1 der Display & Video 360 API Dies ist die erste Version der API.

Bekannte Probleme

Keine.