Versionshinweise

Auf dieser Seite finden Sie Versionshinweise für die Display & Video 360 API.

Neueste API-Version: v3

22. Oktober 2024

Neue Funktionen

Das Leistungsziel „Cost-per-View“ wird jetzt unterstützt.

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

Unter Targeting mit Drittanbieter-Prüftool wurden neue Adloox-Einstellungen für die Markensicherheit hinzugefügt.

Es wurde eine Unterstützung für den Download von strukturierten Datendateien der Version 8 hinzugefügt. Diese Funktion befindet sich derzeit in der geschlossenen Betaphase.

v3

• Die folgenden Felder wurden hinzugefügt:

  Object

  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 erfolgt.

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 wird jetzt auch der Download von strukturierten Datendateien für Werbebuchungen und Werbegruppen im QA-Format unterstützt.

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

Unterstützung für die Verwaltung des Keyword-Targetings, das auf Werbetreibendenebene zugewiesen ist.

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 Targeting-Typen werden jetzt von den folgenden Methoden 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

• Die folgenden Targeting-Typen werden jetzt von den folgenden Methoden 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

Unterstützung für Version 7.1 der strukturierten Datendateien (SDF) 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 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 ist jetzt möglich, Floodlight-Aktivitäten über einen neuen floodlightGroups.floodlightActivities-Dienst abzurufen.

Es wurde ein neues Feld hinzugefügt, das angibt, ob das Targeting einer „YouTube und Partner“-Werbebuchung Google TV-Inventar umfasst.

Es wurde ein neues Feld hinzugefügt, um die Uhrzeit der letzten Anmeldung eines Display & Video 360-Nutzers zu übertragen.

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 wird jetzt unterstützt, die Einwilligung des Endnutzers beim Hochladen von Zielgruppenmitgliedern mit Kundenabgleich in allen Liveversionen zu übergeben.

v3

• Die folgenden Felder wurden hinzugefügt:

  Ressource	Feld(er)
  ContactInfoList	Einwilligung
  MobileDeviceIdList	consent

v2

• Die folgenden Felder wurden hinzugefügt:

  Ressource	Feld(er)
  ContactInfoList	Einwilligung
  MobileDeviceIdList	Einwilligung

31. Oktober 2023

Neue Funktionen

Version 3 ist nicht mehr in der öffentlichen Betaphase, sondern allgemein verfügbar.

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

Unterstützung für Dateien mit strukturierten Daten der Version 7 hinzugefügt. Der Enum-Wert SDF_VERSION_7 wurde in den Versionen 2 und 3 hinzugefügt.

v3

• Die folgenden Werte der Aufzählung 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 als öffentliche Betaversion veröffentlicht. Sie enthält die folgenden Änderungen:

• Die Möglichkeit, Listen mit Standorten in der Nähe vollständig zu verwalten, sodass mit dem Dienst advertisers.locationLists.assignedLocations Standorte erstellt und gelöscht werden können, die TARGETING_LOCATION_TYPE_PROXIMITY-Ressourcen LocationList zugewiesen sind.
• Ein neues boolesches Feld enableOptimizedTargeting, das das Feld targetingExpansionLevel im Objekt TargetingExpansionConfig ersetzt.
• Das Feld billingConfig in der Ressource Advertiser, das bei 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 vom Typ YoutubeAdGroup und YoutubeAdGroupAd in Version 2 ersetzen.

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

Unterstützung für drei neue LineItemType-Werte, einen neuen YoutubeAndPartnersBiddingStrategyType-Wert und einen neuen PartnerCostType-Wert in Version 2 und Version 3 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 Methoden hat sich geändert:

  Methode	Änderung(en)
  advertisers.locationLists.create	Es wird jetzt unterstützt, TARGETING_LOCATION_TYPE_PROXIMITY-LocationList-Ressourcen zu erstellen.
  advertisers.locationLists.patch	Es ist jetzt möglich, TARGETING_LOCATION_TYPE_PROXIMITY-LocationList-Ressourcen zu aktualisieren.
  advertisers.locationLists.assignedLocations.bulkEdit	Jetzt wird die Bulk-Bearbeitung der AssignedLocation-Ressourcen in TARGETING_LOCATION_TYPE_PROXIMITY-LocationList-Ressourcen unterstützt.
  advertisers.locationLists.assignedLocations.create	Es ist jetzt möglich, AssignedLocation-Ressourcen in TARGETING_LOCATION_TYPE_PROXIMITY-LocationList-Ressourcen zu erstellen.

• 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 Werte der Aufzählung 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 Arten von Gebotsstrategien für „YouTube und Partner“ hinzugefügt.

Den „YouTube und Partner“-Werbebuchungen wurde das neue Feld effectiveContentCategory hinzugefügt. Damit wird der YoutubeAndPartnersContentCategory angezeigt, der für die Werbebuchung verwendet wird, wenn Werte auf Werbetreibenden- und Werbebuchungsebene berücksichtigt werden.

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

Es wurde ein neuer SdfVersion-Wert für Structured Data Files (SDF) Version 6 in Version 1 und Version 2 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 Wert LineItemWarningMessage hinzugefügt, der dem Feld warningMessages einer Werbebuchung zugewiesen wird, wenn für das in die Jahre gekommene 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 ist jetzt möglich, YouTubeAdGroup- und YouTubeAdGroupAd-Ressourcen sowie das Ressourcen-Targeting für YouTube-Anzeigengruppen abzurufen. Außerdem haben wir neue abrufbare Targeting-Typen hinzugefügt, die auf Ebene der YouTube-Anzeigengruppen verwendet werden. Weitere Informationen finden Sie auf unserer neuen Seite mit Informationen zum Abrufen von YouTube & Partner-Ressourcen.

Unterstützung für vier weitere Anzeigenplattformen 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 in der öffentlichen Betaphase, sondern allgemein verfügbar.

Der Ressource AssignedTargetingOption wurde das neue Feld assignedTargetingOptionIdAlias hinzugefügt. Es kann anstelle des Felds assignedTargetingOptionId zum Abrufen und Löschen von Ausrichtungen verwendet werden. Dieses Feld wird nur für zugewiesene Targeting-Optionen von Targeting-Typen festgelegt, die über ein Enum zugewiesen werden. Der Aliaswert ist der entsprechende enum-Wert als String.

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

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

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 in Version 2 mithilfe von Enum-Werten zugewiesen werden, konnten nicht über ihren assignedTargetingOptionId entfernt oder abgerufen werden. Stattdessen sollten Nutzer den Enum-Wert verwenden. Mit diesem Update können diese zugewiesenen Targeting-Optionen entweder über assignedTargetingOptionId oder über den Aufzählungstyp entfernt oder abgerufen werden, der durch das neue Feld assignedTargetingOptionIdAlias in der Ressource AssignedTargetingOption gekennzeichnet ist.
• Bei der Anfrage für die Werbebuchung bulkUpdate wurde der Anfrageparameter advertisersId nicht richtig verwendet. Daher wurde ein Fehler zurückgegeben. Mit diesem Update wurde die Methode korrigiert und der Anfrageparameter von advertisersId in advertiserId umbenannt.

27. Oktober 2022

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

Es wurde die Unterstützung für das Schreiben von Targeting-Beschreibungen für Teilinsertionsaufträge für eine Teilmenge von Targeting-Typen eingeführt. Dazu wurden die Methoden create und delete zum 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

Version 1 wurde keine neue Funktionen hinzugefügt.

20. September 2022

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

• Sie können YouTube- und Partnerwerbebuchungen und ihre Targeting-Einstellungen mithilfe der Methoden get und list in den Diensten advertisers.lineItems und advertisers.lineItems.targetingTypes.assignedTargetingOptions abrufen.
• Zwei neue Bulk-Targeting-Methoden im Dienst advertisers.lineItems, 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, bei der AssignedTargetingOption-Ressourcen einer Untergruppe von Ausrichtungstypen mithilfe von Enum-Werten zugewiesen und abgerufen werden müssen, anstatt mithilfe des Dienstes targetingTypes.targetingOptions die IDs der Ausrichtungsoptionen abzurufen.

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

In Version 1 wurde die Unterstützung für drei neue Anzeigenplattformen hinzugefügt.

Neue Funktionen

v2

Im Folgenden finden Sie eine Liste der Änderungen zwischen Version 1 und Version 2:

• In Version 2 wurden die folgenden Methoden 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

• Bei AssignedTargetingOption-Ressourcen der folgenden Targeting-Typen werden in Version 2 Enumerationen für die Targeting-Zuweisung verwendet. Das Feld assignedTargetingOptionId für AssignedTargetingOption-Ressourcen dieser Targeting-Typen wurde in Version 2 ebenfalls aktualisiert, um Stringversionen der Enumerationswerte zu verwenden:

  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	viewability

• 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 Werte der Aufzählung 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

• In Version 1 wurden die folgenden enum-Werte hinzugefügt:

  Enum	Wert(e)
  Anzeigenplattform	EXCHANGE_DAX EXCHANGE_FYBER EXCHANGE_VISTAR

26. Mai 2022

Es ist jetzt möglich, 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 Modells des Algorithmus für jeden Werbetreibenden aufgeführt, der darauf zugreifen kann.

Neue Funktion für den Abfrageparameter filter für die Methode advertisers.creatives.list aktiviert. Damit können Nutzer nur Creatives mit einem updateTime vor oder nach einem bestimmten Zeitstempel abrufen.

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

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 Eigenschaften gefiltert werden:

  Methode	Feld(er)
  advertisers.creatives.list	updateTime

31. März 2022

Es wird jetzt unterstützt, Targeting auf Dauer des Inhalts, Streamtyp und Genre abzurufen und festzulegen.

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

Es wurde Unterstützung für das Erstellen, Aktualisieren und Bearbeiten von Mitgliedern bestimmter Customer Match-Ressourcen vom Typ FirstAndThirdPartyAudience hinzugefügt. Auf der Seite Zielgruppen mit Kundenabgleich hochladen in unserem neuen Leitfaden Zielgruppen verwenden finden Sie eine ausführliche Anleitung zur Verwendung dieser neuen Funktionen.

In InsertionOrder- und LineItem-Ressourcen wurde das neue Feld reservationType eingeführt, das angibt, ob eine Ressource eine Tag-Garantie, eine programmatische Garantie oder keine Garantie hat.

Es kann jetzt über ein neues Feld vom Typ excludeNewExchanges abgerufen und festgelegt werden, ob eine Werbebuchung automatisch auf neue Anzeigenplattformen ausgerichtet wird.

Neben den neuen Funktionen wurden auch 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

Unterstützung für das Targeting nach Audioinhaltstyp unter dem Targeting-Typ TARGETING_TYPE_AUDIO_CONTENT_TYPE hinzugefügt.

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 von Algorithmen für benutzerdefinierte Gebote und ihrer Scripts. Dazu zählen:

• Funktionen zum create neuer und Aktualisieren vorhandener customBiddingAlgorithms.
• Die Möglichkeit, Scripts hochzuladen, indem ein verfügbarer Ressourcenspeicherort abgerufen und dann die Datei an diesen Speicherort hochgeladen wird.
• Ein neuer customBiddingAlgorithms.scripts-Dienst zum Abrufen und create von customBiddingScripts.

Dem Leitfaden Werbebuchungen verwalten wurde die 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 als Gebotsstrategie einer Werbebuchung zuweisen.

Durch das Hinzufügen des Enum-Werts SdfVersion wird die Unterstützung der neuesten SDF-Version v5.4 hinzugefügt.

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

Unterstützung für das Umgebungs-Targeting unter den Targeting-Typen TARGETING_TYPE_BUSINESS_CHAIN und TARGETING_TYPE_POI

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 sie nicht über die Methoden targetingTypes.targetingOptions.get oder targetingTypes.targetingOptions.list abgerufen werden können.

Die neuen Felder sharedAdvertiserIds und customBiddingAlgorithmState wurden in die Ressource „Algorithmus für die benutzerdefinierte Gebotseinstellung“ aufgenommen. Außerdem wird jetzt der Algorithmustyp GOAL_BUILDER_BASED unterstützt.

Der Enumeration 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
  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

Unterstützung für das Inventar-Targeting mit aktiviertem Open Measurement unter dem Targeting-Typ TARGETING_TYPE_OMID

Die maximale Anzahl der zugewiesenen Targeting-Optionen, die auf einer einzigen Seite zurückgegeben werden können, wurde für verschiedene Methoden zur Zuweisung von Targeting-Optionenlisten für Werbetreibende, Kampagnen, Anzeigenaufträge und Werbebuchen 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

Einführung des Dienstes advertisers.invoices, mit dem Nutzer Folgendes tun können:

• Sie können damit Rechnungen abrufen, die einem Werbetreibenden in einem bestimmten Monat ausgestellt wurden.
• den Währungscode abrufen, den ein Werbetreibender in einem bestimmten Monat verwendet hat.

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

Unterstützung für das Targeting auf die Position von nativen Inhalten wurde unter dem neuen Targeting-Typ TARGETING_TYPE_NATIVE_CONTENT_POSITION hinzugefügt.

In der Werbetreibendenressource wurde das neue Feld prismaEnabled eingeführt, mit dem Nutzer die Integration mit dem Prisma-Tool von Mediaocean aktivieren können.

Der Enum-Wert ENTITY_STATUS_PAUSED wird jetzt für das 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
  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 Liste mit auszuschließenden Keywords wurden neue Felder hinzugefügt, die die Anzahl der Zeilenelemente zurückgeben, für die die jeweilige Ressource für das Targeting verwendet wird. Es wurden neue filter-Properties für die Methode „Liste mit Werbebuchungen“ aktiviert, mit denen Nutzer nur Werbebuchungen abrufen können, bei denen bestimmte Channels oder Listen mit auszuschließenden Keywords für das Targeting 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

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

Es ist jetzt möglich, das Kampagnen-Targeting über einen neuen Kampagnen-Targeting-Dienst und eine zusätzliche Bulk-Listenmethode abzurufen.

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

Es wurden mehrere Änderungen an den Diensten advertisers.channels.sites, partners.channels.sites und advertisers.negativeKeywordLists.negativeKeywords vorgenommen, um die Verwaltung von Kanalinhalten und Listen mit auszuschließenden Keywords zu vereinfachen. Zu diesen Änderungen gehören:

• Es wurden replace-Methoden hinzugefügt, mit denen Nutzer den vorhandenen Inhalt eines Kanals oder einer Liste mit auszuschließenden Keywords vollständig überschreiben können.
• Die Anforderung, dass in den Feldern createdSites oder createdNegativeKeywords von Bulk-Änderungsanfragen keine vorhandenen Elemente enthalten sein dürfen, wurde aufgehoben.
• Die maximale Anzahl von Elementen, die auf einer einzelnen Seite einer Antwort auf Websites auflisten oder auszuschließende Keywords auflisten, 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 Aufzählungswerte 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

Einführung eines neuen Targeting-Dienstes für Anzeigenaufträge und einer zusätzlichen Bulk-Listenmethode, mit der das Targeting abgerufen werden kann, das Anzeigenaufträgen zugewiesen ist. Die Creative-Ressource wurde erweitert. Es wurden reine Ausgabefelder für Creatives hinzugefügt, die für Audio-Creatives von Drittanbietern verwendet werden können. Es wurden neue Arten von Leistungszielvorhaben hinzugefügt, die 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 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

Durch die Einführung eines neuen Felds „InsertionOrderType“ und eines neuen enum-Werts „LineItemType“ können TV-Anzeigenaufträge und Over-the-Top-Werbebuchungen abgerufen und verwaltet werden. Unterstützung für Werbebuchungen für mobile Apps über ein Werbebuchungsfeld vom Typ mobileApp Erweiterte Unterstützung für Anzeigenplattformen, Google-Zielgruppen und SDF durch zusätzliche Enum-Werte. Es ist jetzt möglich, advertisers.list-Werte nach dem Datum und 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 Targeting-Optionen für geografische Regionen zu suchen und mehrere Ergebnisse der Ressourcenlistenmethode nach dem Datum der letzten Aktualisierung zu filtern. Es wurde die neue LineItemWarningMessage eingeführt, um Nutzer darüber zu informieren, wenn für eine Werbebuchung das eingestellte geografische Targeting verwendet wird.

Neue Funktionen

• Die folgenden Methoden wurden hinzugefügt:

  Dienst	Methode(n)
  targetingTypes.targetingOptions	Suche

• 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 initiieren. Einführung von Optionen für die Ausrichtungserweiterung, mit denen das Targeting einer Werbebuchung auf Nutzer ausgeweitet werden kann, die den Nutzern in den Zielgruppen ähneln. Es wurden benutzerdefinierte Segment-ID-Felder an DoubleVerify- und Integral Ad Science-Objekte angehängt, die für das Targeting mit Drittanbieterüberprüfung verwendet werden.

Neue Funktionen

• Die folgenden Dienste wurden hinzugefügt:

  Dienst	Methode(n)
  advertisers.manualTriggers	activate 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 Warnungen für die Werbebuchungsressource und ein Leistungsziel vom Typ „Klickrate“ (Click-through-Rate, CTR) eingeführt. warningMessages wurde als filterbares Feld zum Auflisten von Werbebuchungen hinzugefügt.

Neben den neuen Funktionen gelten jetzt auch neue Kontingentlimits und es gibt eine neue Dokumentation zur Nutzung von Batchanfragen.

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-Antworttext	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 Nutzerverwaltungs-, Partner- und Partner-Targeting-Dienste. Einführung von Tools, mit denen Nutzer proaktiv verhindern können, dass sie die Grenzwerte für Kontoentitäten erreichen. Unterstützung für Audiowerbebuchungen und die Verwendung von Algorithmen für benutzerdefinierte Gebote in Werbebuchungen und Anzeigenauftrags-Gebotsstrategien

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 folgenden Dienste hinzugefügt:

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

24. Juni 2020

Wir haben ein kleines Update veröffentlicht, mit dem eine Erstellungsmethode für Partner- und Werbetreibenden-Channels, neue Felder vom Typ FirstAndThirdPartyAudience und zusätzliche Anzeigenplattform-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 Beschreibung 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 ist jetzt möglich, eine Teilmenge der anvisierbaren Entitäten zu erstellen, zu korrigieren und zu befüllen. Außerdem können Sie das Targeting auf Werbetreibendenebene für drei Targeting-Typen ändern: Kanal, Ausschluss von Inhalten mit Labeln für digitale Inhalte und Ausschluss von sensiblen 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

Einführung einer großen Anzahl von Funktionen, wodurch der Umfang der API über SDF hinaus erweitert wurde. Es wurde eine grundlegende Ressourcenverwaltung 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 können Sie das Targeting auch auf Werbebuchungsebene 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

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

Bekannte Probleme

Keine.