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 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
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
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 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 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 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 Die folgenden Felder wurden hinzugefügt:
Ressource Feld(er) Nutzer YoutubeAndPartnersInventorySourceConfig
v2
Die folgenden Methoden wurden hinzugefügt:
Dienst Methode(n) floodlightGroups.floodlightActivities Die folgenden Felder wurden hinzugefügt:
Ressource Feld(er) Nutzer YoutubeAndPartnersInventorySourceConfig
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 MobileDeviceIdList
v2
Die folgenden Felder wurden hinzugefügt:
Ressource Feld(er) ContactInfoList MobileDeviceIdList
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, dieTARGETING_LOCATION_TYPE_PROXIMITY
LocationList
-Ressourcen zugewiesen sind. - Ein neues boolesches
enableOptimizedTargeting
-Feld, das das FeldtargetingExpansionLevel
imTargetingExpansionConfig
-Objekt ersetzt. - Die Anforderung des Felds
billingConfig
in der RessourceAdvertiser
, das beim Senden vonadvertisers.create
-Anfragen enthalten sein muss, und ein neues FeldbillingConfig
in der RessourcePartner
. - Neue Ressourcen vom Typ
AdGroup
undAdGroupAd
, die die RessourcenYoutubeAdGroup
undYoutubeAdGroupAd
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 advertisers.adGroups advertisers.adGroups.targetingTypes.assignedTargetingOptions customBiddingAlgorithms customBiddingAlgorithms.rules 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 inTARGETING_LOCATION_TYPE_PROXIMITY
-Ressourcen vom TypLocationList
.advertisers.locationLists.assignedLocations.create Unterstützt jetzt das Erstellen von AssignedLocation
-Ressourcen inTARGETING_LOCATION_TYPE_PROXIMITY
-Ressourcen vom TypLocationList
.Die folgenden Abfrageparameter wurden hinzugefügt:
Methode Parameter inventorySources.get Die folgenden Felder sind Pflichtfelder:
Ressource Feld(er) Werbetreibender Die folgenden Felder wurden hinzugefügt:
Ressource Feld(er) BiddingStrategy InsertionOrder Partner TargetingExpansionConfig YoutubeAndPartnersSettings YoutubeAndPartnersInventorySourceConfig 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 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 advertisers.youtubeAdGroups advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions Die folgenden Felder wurden hinzugefügt:
Dienst Methode(n) AssignedTargetingOption YoutubeAndPartnersSettings 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 AssignedTargetingOption 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:
v1
Die maximale Seitengröße wurde für die folgenden Listenmethoden erhöht:
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 demassignedTargetingOptionId
- oder dem Enum-Wert entfernt oder abgerufen werden, der durch das neue FeldassignedTargetingOptionIdAlias
in der RessourceAssignedTargetingOption
identifiziert wird. - Die Anfrage
bulkUpdate
der Werbebuchung wurde nicht korrekt mit dem AnfrageparameteradvertisersId
verwendet, wodurch ein Fehler zurückgegeben wurde. Mit diesem Update wurde die Methode korrigiert und der Anfrageparameter wurde vonadvertisersId
inadvertiserId
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 advertisers.lineItems
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
undlist
in den Dienstenadvertisers.lineItems
undadvertisers.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 denentityStatus
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 dentargetingTypes.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
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
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 FeldassignedTargetingOptionId
fürAssignedTargetingOption
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:
Die folgenden Felder wurden in Version 2 entfernt:
Die folgenden Felder wurden in Version 2 zu Pflichtfeldern:
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 inventorySources Die folgenden Felder wurden hinzugefügt:
Ressource Feld(er) CustomBiddingAlgorithm InventorySource Die folgenden enum-Werte wurden hinzugefügt:
Enum Wert(e) SdfVersion Die folgenden Listenmethoden können jetzt nach den folgenden Eigenschaften gefiltert werden:
Methode Feld(er) advertisers.creatives.list
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 InsertionOrder MaximizeSpendBidStrategy TargetingOption Die folgenden enum-Werte wurden hinzugefügt:
Enum Wert(e) TargetingType
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 Die folgenden Felder wurden hinzugefügt:
Ressource Feld(er) FirstAndThirdPartyAudience InsertionOrder LineItem
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 TargetingOption Die folgenden enum-Werte wurden hinzugefügt:
Enum Wert(e) TargetingType
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 ErstellencustomBiddingScripts
.
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 customBiddingAlgorithms.scripts Medien Die folgenden enum-Werte wurden hinzugefügt:
Enum Wert(e) SdfVersion
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 CustomBiddingAlgorithm TargetingOption TargetingOptions.search-Anfragetext Die folgenden enum-Werte wurden hinzugefügt:
Enum Wert(e) CustomBiddingAlgorithmType Anzeigenplattform TargetingType Die folgenden Listenmethoden können jetzt nach den folgenden Eigenschaften gefiltert werden:
Methode Feld(er) customBiddingAlgorithms.list
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 TargetingOption Die folgenden enum-Werte wurden hinzugefügt:
Enum Wert(e) TargetingType Die maximale Seitengröße wurde für die folgenden Listenmethoden erhöht:
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 Die folgenden Felder wurden hinzugefügt:
Ressource Feld(er) Werbetreibender AssignedTargetingOption TargetingOption Die folgenden enum-Werte wurden hinzugefügt:
Enum Wert(e) AssignedTargetingOption.Recency Austauschen TargetingType 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 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
odercreatedNegativeKeywords
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:
Die folgenden Felder wurden hinzugefügt:
Ressource Feld(er) AssignedTargetingOption.AppAssignedTargetingOptionDetails 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 advertisers.insertionOrders.targetingTypes.assignedTargetingOptions Die folgenden Felder wurden hinzugefügt:
Ressource Feld(er) Creative Die folgenden enum-Werte wurden hinzugefügt:
Enum Wert(e) ContentInstreamPosition PerformanceGoalType PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE
PERFORMANCE_GOAL_TYPE_CLICK_CVR
PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR
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 LineItem Die folgenden enum-Werte wurden hinzugefügt:
Enum Wert(e) Austauschen GoogleAudienceType LineItemType SdfVersion Die folgenden Listenmethoden können jetzt nach den folgenden Feldern sortiert und gefiltert werden:
Methode Feld(er) Werbetreibende
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 Die folgenden enum-Werte wurden hinzugefügt:
Enum Wert(e) Austauschen LineItemWarningMessage Die folgenden Listenmethoden können jetzt nach den folgenden Feldern sortiert und gefiltert werden:
Methode Feld(er) advertisers.campaigns.list advertisers.insertionOrders.list advertisers.lineItems.list
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 Die folgenden Felder wurden hinzugefügt:
Ressource Feld(er) AssignedTargetingOption.DoubleVerify AssignedTargetingOption.IntegralAdScience LineItem LineItemFlight Die folgenden enum-Werte wurden hinzugefügt:
Enum Wert(e) LineItemFlightDateType Die folgenden Listenmethoden können jetzt nach den folgenden Feldern gefiltert werden:
Methode Feld(er) advertisers.lineItems.list
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 Die folgenden enum-Werte wurden hinzugefügt:
Enum Wert(e) PerformanceGoalType Die folgenden Listenmethoden können jetzt nach den folgenden Feldern gefiltert werden:
Methode Feld(er) advertisers.lineItems.list
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 Die folgenden Listenmethoden können jetzt nach den folgenden Feldern gefiltert werden:
Methode Feld(er) advertisers.list advertisers.campaigns.list advertisers.insertionOrders.list advertisers.lineItems.list targetingTypes.targetingOptions.list
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 Partner partners.targetingTypes.assignedTargetingOptions Nutzer Die folgenden Methoden wurden hinzugefügt:
Dienst Methode(n) Werbetreibende Die folgenden Felder wurden hinzugefügt:
Ressource Feld(er) MaximizeSpendBidStrategy PerformanceGoalBidStrategy Die folgenden enum-Werte wurden hinzugefügt:
Enum Wert(e) BiddingStrategyPerformanceGoalType LineItemType Die folgenden Listenmethoden können jetzt nach den folgenden Feldern sortiert und gefiltert werden:
Methode Feld(er) advertisers.lineItems.list Die folgenden Bereiche wurden zur Verwendung für die folgenden Dienste hinzugefügt:
Bereich Dienste https://www.googleapis.com/auth/display-video-user-management
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 partners.channels Die folgenden Felder wurden hinzugefügt:
Ressource Feld(er) FirstAndThirdPartyAudience Die folgenden enum-Werte wurden hinzugefügt:
Enum Wert(e) Austauschen Die folgenden Listenmethoden können jetzt nach den folgenden Feldern gefiltert werden:
Methode Feld(er) advertisers.creatives.list
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:
Die folgenden Methoden wurden hinzugefügt:
Dienst Methode(n) Werbetreibende advertisers.channels advertisers.locationLists advertisers.negativeKeywordLists inventorySourceGroups partners.channels Die folgenden Felder wurden hinzugefügt:
Ressource Feld(er) Werbetreibender Creative insertionOrder.insertionOrderBudgetSegment
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:
9. März 2020
Einführung von Version 1 der Display & Video 360 API Dies ist die erste Version der API.
Bekannte Probleme
Keine.