Questa pagina fornisce le note di rilascio dell'API Display & Video 360.
Versione API più recente: v3
22 ottobre 2024
Nuove funzionalità
È stato aggiunto il supporto per l'obiettivo di rendimento costo per visualizzazione.
È stata aggiunta la possibilità di impostare e recuperare il targeting dei dispositivi connessi.
Sono state aggiunte nuove impostazioni di sicurezza del brand di Adloox in Targeting per verificatori di terze parti.
È stato aggiunto il supporto per il download dei file di dati strutturati v8, attualmente in versione beta chiusa.
v3
Sono stati aggiunti i seguenti campi:
Oggetto Campo/i Adloox
crimeHarmfulActsIndividualsSocietyHumanRightsViolationsContent
deathInjuryMilitaryConflictContent
debatedSensitiveSocialIssueContent
hateSpeechActsAggressionContent
Sono stati aggiunti i seguenti valori enum:
Enum Valori DeviceType
DEVICE_TYPE_CONNECTED_DEVICE
PerformanceGoalType
PERFORMANCE_GOAL_TYPE_CPV
SdfVersion
SDF_VERSION_8
Valori deprecati
È stato rimosso il supporto per SDF 5.5 in seguito al suo ritiro il 3 ottobre 2024.
v3
I seguenti valori enumerati sono stati ritirati:
Enum Valori SdfVersion
SDF_VERSION_5_5
15 agosto 2024
Nuove funzionalità
È stato aggiunto il supporto per il tipo Netflix Exchange
.
v3
Sono stati aggiunti i seguenti valori enum:
Enum Valori Piattaforma di scambio pubblicitario EXCHANGE_NETFLIX
v2
Sono stati aggiunti i seguenti valori enum:
Enum Valori Piattaforma di scambio pubblicitario EXCHANGE_NETFLIX
15 luglio 2024
Nuove funzionalità
Nella versione 3 è stato aggiunto il supporto per il download dei file di dati strutturati di elementi pubblicitari e gruppi di annunci in formato QA.
v3
Sono stati aggiunti i seguenti campi:
Risorsa Campo/i IdFilter Sono stati aggiunti i seguenti valori enum:
Enum Valori FileType FILE_TYPE_AD_GROUP_QA
FILE_TYPE_LINE_ITEM_QA
17 giugno 2024
Nuove funzionalità
È stato aggiunto il supporto per la gestione del targeting per parole chiave assegnato a livello di inserzionista.
È stato aggiunto un nuovo campo optimizationObjective
alla risorsa ordine di inserzione. optimizationObjective
è disponibile solo per i clienti inclusi nella lista consentita.
v3
Sono stati aggiunti i seguenti campi:
Risorsa Campo/i InsertionOrder I seguenti metodi ora supportano i seguenti tipi di targeting:
Tipo di targeting Metodo o metodi TARGETING_TYPE_KEYWORD advertisers.editAssignedTargetingOptions
advertisers.listAssignedTargetingOptions
advertisers.targetingType.assignedTargetingOptions.create
advertisers.targetingType.assignedTargetingOptions.delete
v2
I seguenti metodi ora supportano i seguenti tipi di targeting:
Tipo di targeting Metodo o metodi TARGETING_TYPE_KEYWORD advertisers.editAssignedTargetingOptions
advertisers.listAssignedTargetingOptions
advertisers.targetingType.assignedTargetingOptions.create
advertisers.targetingType.assignedTargetingOptions.delete
30 maggio 2024
Nuove funzionalità
È stato aggiunto il supporto per la versione 7.1 dei file di dati strutturati (SDF).
v3
Sono stati aggiunti i seguenti valori enum:
Enum Valori SdfVersion SDF_VERSION_7_1
v2
Sono stati aggiunti i seguenti valori enum:
Enum Valori SdfVersion SDF_VERSION_7_1
23 aprile 2024
Nuove funzionalità
È stato aggiunto il supporto di nuovi tipi di KPI, piattaforme di scambio pubblicitario e piattaforme per app.
v3
Sono stati aggiunti i seguenti campi:
Risorsa Campo/i KPI Sono stati aggiunti i seguenti valori enum:
Enum Valori AppPlatform APP_PLATFORM_LG_TV
APP_PLATFORM_VIZIO_TV
Piattaforma di scambio pubblicitario 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
Sono stati aggiunti i seguenti valori enum:
Enum Valori AppPlatform APP_PLATFORM_LG_TV
APP_PLATFORM_VIZIO_TV
Piattaforma di scambio pubblicitario EXCHANGE_DRAX
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM
28 febbraio 2024
Nuove funzionalità
È stata aggiunta la possibilità di rimuovere esplicitamente i membri dai segmenti di pubblico Customer Match.
È stato aggiunto il supporto per il targeting di nuove piattaforme di scambio pubblicitario.
v3
Sono stati aggiunti i seguenti campi:
Risorsa Campo/i firstAndThirdPartyAudiences.editCustomerMatchMembers Sono stati aggiunti i seguenti valori enum:
Enum Valori Piattaforma di scambio pubblicitario EXCHANGE_ADMOST_GBID
EXCHANGE_APPLOVIN_GBID
EXCHANGE_CHARTBOOST_GBID
EXCHANGE_FYBER_GBID
EXCHANGE_TOPON_GBID
EXCHANGE_UNITY_GBID
v2
Sono stati aggiunti i seguenti campi:
Risorsa Campo/i firstAndThirdPartyAudiences.editCustomerMatchMembers Sono stati aggiunti i seguenti valori enum:
Enum Valori Piattaforma di scambio pubblicitario EXCHANGE_ADMOST_GBID
EXCHANGE_APPLOVIN_GBID
EXCHANGE_CHARTBOOST_GBID
EXCHANGE_FYBER_GBID
EXCHANGE_TOPON_GBID
EXCHANGE_UNITY_GBID
29 gennaio 2024
Nuove funzionalità
È stata aggiunta la possibilità di recuperare le attività Floodlight tramite un nuovo servizio
floodlightGroups.floodlightActivities
.
È stato aggiunto un nuovo campo che indica se un elemento pubblicitario YouTube e partner include l'inventario di Google TV nel targeting.
È stato aggiunto un nuovo campo per trasmettere l'ora dell'ultimo accesso di un utente Display & Video 360.
v3
Sono stati aggiunti i seguenti metodi:
Servizio Metodo o metodi floodlightGroups.floodlightActivities Sono stati aggiunti i seguenti campi:
Risorsa Campo/i Utente YoutubeAndPartnersInventorySourceConfig
v2
Sono stati aggiunti i seguenti metodi:
Servizio Metodo o metodi floodlightGroups.floodlightActivities Sono stati aggiunti i seguenti campi:
Risorsa Campo/i Utente YoutubeAndPartnersInventorySourceConfig
14 novembre 2023
Nuove funzionalità
È stato aggiunto il supporto per il trasferimento del consenso dell'utente finale durante il caricamento dei membri del segmento di pubblico di Customer Match in tutte le versioni pubblicate.
v3
Sono stati aggiunti i seguenti campi:
Risorsa Campo/i ContactInfoList MobileDeviceIdList
v2
Sono stati aggiunti i seguenti campi:
Risorsa Campo/i ContactInfoList MobileDeviceIdList
31 ottobre 2023
Nuove funzionalità
La versione 3 è stata spostata dalla versione beta pubblica alla disponibilità generale.
È stato rinominato un valore dell'enum AdGroupFormat
nella versione 3 per riflettere con maggiore precisione il formato pertinente.
È stato aggiunto il supporto per i file di dati strutturati 7 con l'aggiunta del valore enumerato SDF_VERSION_7
nelle versioni 2 e 3.
v3
I seguenti valori enum sono stati rimossi:
Enum Valori AdGroupFormat AD_GROUP_FORMAT_ACTION
Sono stati aggiunti i seguenti valori enum:
Enum Valori AdGroupFormat AD_GROUP_FORMAT_RESPONSIVE
SdfVersion SDF_VERSION_7
v2
Sono stati aggiunti i seguenti valori enum:
Enum Valori SdfVersion SDF_VERSION_7
2 ottobre 2023
Nuove funzionalità
È stata rilasciata la versione 3 in versione beta pubblica, che include le seguenti modifiche:
- La possibilità di gestire completamente gli elenchi di località di prossimità, consentendo l'utilizzo del servizio
advertisers.locationLists.assignedLocations
per creare ed eliminare le località assegnate alle risorseTARGETING_LOCATION_TYPE_PROXIMITY
LocationList
. - Un nuovo campo booleano
enableOptimizedTargeting
, che sostituisce il campotargetingExpansionLevel
nell'oggettoTargetingExpansionConfig
. - Il requisito del campo
billingConfig
nella risorsaAdvertiser
, che deve essere incluso quando si effettuano richiesteadvertisers.create
, e un nuovo campobillingConfig
nella risorsaPartner
. - Nuove risorse
AdGroup
eAdGroupAd
che sostituiscono le risorseYoutubeAdGroup
eYoutubeAdGroupAd
nella versione 2.
Segui i passaggi descritti nella nostra guida alla migrazione per eseguire la migrazione dalla versione 2 alla versione 3.
È stato aggiunto il supporto di tre nuovi valori LineItemType
, un nuovo
YoutubeAndPartnersBiddingStrategyType
e un nuovo
PartnerCostType
nelle versioni 2 e 3.
v3
Sono stati aggiunti i seguenti metodi:
Servizio Metodo o metodi advertisers.adGroupAds advertisers.adGroups advertisers.adGroups.targetingTypes.assignedTargetingOptions customBiddingAlgorithms customBiddingAlgorithms.rules I seguenti metodi sono stati rimossi:
Servizio Metodo o metodi advertisers.manualTriggers attiva
create
disattivare
get
list
patch
advertisers.youtubeAdGroupAds get
list
advertisers.youtubeAdGroups bulkListAdGroupAssignedTargetingOptions
get
list
advertiser.youtubeAdGroups.targetingTypes.assignedTargetingOptions get
list
Il comportamento del seguente metodo è cambiato:
Metodo Modifiche advertisers.locationLists.create Ora supporta la creazione di risorse TARGETING_LOCATION_TYPE_PROXIMITY
LocationList
.advertisers.locationLists.patch Ora supporta l'aggiornamento delle risorse TARGETING_LOCATION_TYPE_PROXIMITY
LocationList
.advertisers.locationLists.assignedLocations.bulkEdit Ora supporta la modifica collettiva delle risorse AssignedLocation
nelle risorseTARGETING_LOCATION_TYPE_PROXIMITY
LocationList
.advertisers.locationLists.assignedLocations.create Ora supporta la creazione di risorse AssignedLocation
nelle risorseTARGETING_LOCATION_TYPE_PROXIMITY
LocationList
.Sono stati aggiunti i seguenti parametri di query:
Metodo Parametro o parametri inventorySources.get I seguenti campi sono stati impostati come obbligatori:
Risorsa Campo/i Inserzionista Sono stati aggiunti i seguenti campi:
Risorsa Campo/i BiddingStrategy InsertionOrder Partner TargetingExpansionConfig YoutubeAndPartnersSettings YoutubeAndPartnersInventorySourceConfig I seguenti campi sono stati rimossi:
Risorsa Campo/i InsertionOrder performanceGoal
billableOutcome
TargetingExpansionConfig excludeFirstPartyAudience
targetingExpansionLevel
YoutubeAndPartnersSettings biddingStrategy
thirdPartyMeasurementSettings
YoutubeAndPartnersInventorySourceConfig includeYoutubeSearch
includeYoutubeVideos
Sono stati aggiunti i seguenti valori enum:
Enum Valori 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
I seguenti valori enum sono stati rimossi:
Enum Valori LineItemWarningMessage DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
v2
Sono stati aggiunti i seguenti valori enum:
Enum Valori 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 agosto 2023
Nuove funzionalità
È stato aggiunto il supporto di due piattaforme di scambio pubblicitario e di due nuovi tipi di strategie di offerta YouTube e partner.
È stato aggiunto un nuovo campo effectiveContentCategory
agli elementi pubblicitari YouTube e partner per visualizzare il valore YoutubeAndPartnersContentCategory
utilizzato dall'elemento pubblicitario quando vengono presi in considerazione i valori assegnati sia a livello di inserzionista che di elemento pubblicitario.
v2
Sono stati aggiunti i seguenti campi:
Risorsa Campo/i YoutubeAndPartnersSettings I seguenti campi sono stati rimossi:
Risorsa Campo/i InventorySource subSitePropertyId
Sono stati aggiunti i seguenti valori enum:
Enum Valori Piattaforma di scambio pubblicitario EXCHANGE_HIVESTACK
EXCHANGE_RESET_DIGITAL
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS
5 giugno 2023
Nuove funzionalità
È stato aggiunto un nuovo valore SdfVersion
per la versione 6 dei File di dati strutturati (SDF) nelle versioni 1 e 2.
v2
Sono stati aggiunti i seguenti valori enum:
Enum Valori SdfVersion SDF_VERSION_6
v1
Sono stati aggiunti i seguenti valori enum:
Enum Valori SdfVersion SDF_VERSION_6
9 marzo 2023
Nuove funzionalità
È stato aggiunto un nuovo valore LineItemWarningMessage
che verrà assegnato al campo warningMessages
di un elemento pubblicitario se il campo excludeFirstPartyAudience
deprecato è impostato su true
. Il campo excludeFirstPartyAudience
verrà ritirato
e impostato su false
dopo il 25 marzo 2023.
v2
Sono stati aggiunti i seguenti valori enum:
Enum Valori LineItemWarningMessage DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
v1
Sono stati aggiunti i seguenti valori enum:
Enum Valori LineItemWarningMessage DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
8 febbraio 2023
Nuove funzionalità
È stata aggiunta la possibilità di recuperare le risorse YouTubeAdGroup
e
YouTubeAdGroupAd
, nonché il targeting per risorsa del gruppo di annunci di YouTube. Inoltre, abbiamo aggiunto nuovi
tipi di targeting recuperabili utilizzati a livello di gruppi di annunci di YouTube. Per saperne di più, consulta la nuova pagina della guida sul recupero delle risorse di YouTube e partner.
È stato aggiunto il supporto di altri quattro piattaforme di scambio pubblicitario nelle versioni 1 e 2.
v2
Sono stati aggiunti i seguenti metodi:
Servizio Metodo o metodi advertisers.youtubeAdGroupAds advertisers.youtubeAdGroups advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions Sono stati aggiunti i seguenti campi:
Servizio Metodo o metodi AssignedTargetingOption YoutubeAndPartnersSettings Sono stati aggiunti i seguenti valori enum:
Enum Valori Piattaforma di scambio pubblicitario 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
Sono stati aggiunti i seguenti valori enum:
Enum Valori Piattaforma di scambio pubblicitario EXCHANGE_APPLOVIN
EXCHANGE_CONNATIX
EXCHANGE_JCD
EXCHANGE_PLACE_EXCHANGE
6 dicembre 2022
Nuove funzionalità
La versione 2 è stata spostata dalla versione beta pubblica alla disponibilità generale.
È stato aggiunto un nuovo campo assignedTargetingOptionIdAlias
alla risorsa
AssignedTargetingOption
, che può essere utilizzato al posto di
assignedTargetingOptionId
per recuperare ed eliminare il targeting.
Questo campo viene impostato solo per le opzioni di targeting assegnate dei tipi di targeting assegnati tramite enum. Il valore dell'alias è il valore dell'enum pertinente come stringa.
È stato aggiunto un nuovo campo billingConfig
alla risorsa
Advertiser
.
È stato aggiunto il supporto per il recupero degli elementi pubblicitari over-the-top di YouTube e partner, identificati da tre nuovi valori LineItemType
.
È stata aumentata la dimensione massima della pagina a 200 per numerosi metodi list
nelle versioni v1 e v2. Le
dimensioni della pagina predefinite rimangono invariate.
v2
Sono stati aggiunti i seguenti campi:
Risorsa Campo/i Inserzionista AssignedTargetingOption Sono stati aggiunti i seguenti valori enum:
Enum Valori 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
La dimensione massima della pagina è stata aumentata per i seguenti metodi di elenco:
v1
La dimensione massima della pagina è stata aumentata per i seguenti metodi di elenco:
Problemi noti
Questo aggiornamento risolve i seguenti problemi noti nella versione 2:
- Non è stato possibile rimuovere o recuperare le opzioni di targeting assegnate dei tipi di targeting assegnati utilizzando i valori enumerati nella versione 2 utilizzando il relativo
assignedTargetingOptionId
, ma si prevedeva che gli utenti utilizzassero il valore enumerato. Con questo aggiornamento, queste opzioni di targeting assegnate possono essere rimosse o recuperate utilizzandoassignedTargetingOptionId
o il valore dell'enum, identificato dal nuovo campoassignedTargetingOptionIdAlias
nella risorsaAssignedTargetingOption
. - La richiesta dell'elemento pubblicitario
bulkUpdate
non utilizzava correttamente il parametro di richiestaadvertisersId
, restituendo un errore. Con questo aggiornamento, il metodo è stato corretto e il parametro di richiesta è stato rinominato daadvertisersId
aadvertiserId
.
27 ottobre 2022
È stata aggiunta la possibilità di duplicare un elemento pubblicitario esistente all'interno dell'elemento principale
InsertionOrder
.
È stato introdotto il supporto della scrittura del targeting per gli ordini di inserzione parziali per un sottoinsieme di tipi di targeting con l'aggiunta dei metodi create
e delete
al servizio advertisers.insertionOrders.targetingTypes.assignedTargetingOptions
.
Nuove funzionalità
v2
Sono stati aggiunti i seguenti metodi:
Servizio Metodo o metodi advertisers.insertionOrders.targetingTypes.assignedTargetingOptions advertisers.lineItems
v1
Non sono state aggiunte nuove funzionalità alla versione 1.
20 settembre 2022
È stata rilasciata la versione 2 in versione beta pubblica, che include le seguenti modifiche:
- La possibilità di recuperare gli elementi pubblicitari YouTube e partner e le relative impostazioni di targeting utilizzando i metodi
get
elist
nei serviziadvertisers.lineItems
eadvertisers.lineItems.targetingTypes.assignedTargetingOptions
. - Due nuovi metodi di targeting collettivo nel servizio
advertisers.lineItems
che consentono di modificare e recuperare il targeting assegnato in più elementi pubblicitari con una sola richiesta. - Un nuovo metodo
bulkUpdate
che consente agli utenti di aggiornare ilentityStatus
di più elementi pubblicitari in una singola richiesta. - Nuova logica di targeting che richiede l'assegnazione e il recupero delle risorse
AssignedTargetingOption
di un sottoinsieme di tipi di targeting utilizzando i valori enum anziché gli ID opzione di targeting recuperati utilizzando il serviziotargetingTypes.targetingOptions
.
Segui i passaggi descritti nella nostra guida alla migrazione per eseguire la migrazione dalla versione 1 alla versione 2.
È stato aggiunto il supporto di tre nuovi marketplace nella versione 1.
Nuove funzionalità
v2
Di seguito è riportato un elenco delle modifiche tra la versione 1 e la versione 2:
Nella versione 2 sono stati aggiunti i seguenti metodi:
Servizio Metodo o metodi advertisers.lineItems bulkEditAssignedTargetingOptions
I seguenti metodi sono stati rimossi nella versione 2:
Servizio Metodo o metodi advertisers.lineItems bulkEditLineItemAssignedTargetingOptions
bulkListLineItemAssignedTargetingOptions
I seguenti metodi sono stati rinominati nella versione 2:
Servizio Vecchio nome metodo Nuovo nome metodo inserzionisti bulkEditAdvertiserAssignedTargetingOptions
bulkListAdvertiserAssignedTargetingOptions
advertisers.campaigns bulkListCampaignAssignedTargetingOptions listAssignedTargetingOptions advertisers.insertionOrders bulkListInsertionOrderAssignedTargetingOptions listAssignedTargetingOptions partner bulkEditPartnerAssignedTargetingOptions editAssignedTargetingOptions Le risorse
AssignedTargetingOption
dei seguenti tipi di targeting utilizzano gli enum per l'assegnazione del targeting nella versione 2. Anche il campoassignedTargetingOptionId
per le risorseAssignedTargetingOption
di questi tipi di targeting è stato aggiornato nella versione 2 per utilizzare le versioni di stringa dei valori enumerati:Tipo di targeting Tipo di enum 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 Ambiente TARGETING_TYPE_EXCHANGE Piattaforma di scambio pubblicitario TARGETING_TYPE_GENDER Genere 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 Visibilità Nella versione 2 sono stati aggiunti i seguenti campi:
I seguenti campi sono stati rimossi nella versione 2:
I seguenti campi sono stati impostati come obbligatori nella versione 2:
Nella versione 2 sono stati aggiunti i seguenti valori di enum:
Enum Valori 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
Piattaforma di scambio pubblicitario 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
I seguenti valori enum sono stati rimossi nella versione 2:
Enum Valori 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
Nella versione 1 sono stati aggiunti i seguenti valori enum:
Enum Valori Piattaforma di scambio pubblicitario EXCHANGE_DAX
EXCHANGE_FYBER
EXCHANGE_VISTAR
26 maggio 2022
È stata aggiunta la possibilità di creare risorse InventorySource
e gestire le risorse GuaranteedOrder
tramite nuovi metodi di scrittura del servizio inventorySources
e un nuovo servizio guaranteedOrders
.
È stato introdotto il campo modelReadiness
nella risorsa
CustomBiddingAlgorithm
. Questo campo elenca l'idoneità del
modello dell'algoritmo per ogni inserzionista che può accedervi.
È stata attivata la nuova funzionalità del parametro di query filter
per il metodo advertisers.creatives.list
che consente all'utente di recuperare solo le creatività con un updateTime
prima o dopo un determinato timestamp.
È stato aggiunto il supporto per la versione SDF più recente, v5.5, tramite l'aggiunta di un valore enum SdfVersion
.
Nuove funzionalità
Sono stati aggiunti i seguenti metodi:
Servizio Metodo o metodi guaranteedOrders inventorySources Sono stati aggiunti i seguenti campi:
Risorsa Campo/i CustomBiddingAlgorithm InventorySource Sono stati aggiunti i seguenti valori enum:
Enum Valori SdfVersion I seguenti metodi di elenco ora possono essere filtrati in base alle seguenti proprietà:
Metodo Campo/i advertisers.creatives.list
31 marzo 2022
È stato aggiunto il supporto per il recupero e l'impostazione del targeting in base a durata dei contenuti, tipo di stream e genere.
È stato aggiunto il campo billableOutcome
all'oggetto InsertionOrder
.
È stato introdotto il campo raiseBidForDeals
nell'oggetto MaximizeSpendBidStrategy
, che consente agli utenti di impostare se la strategia di offerta applica i prezzi minimi dell'inserzionista per i deal scelti come target.
Nuove funzionalità
Sono stati aggiunti i seguenti campi:
Risorsa Campo/i AssignedTargetingOption InsertionOrder MaximizeSpendBidStrategy TargetingOption Sono stati aggiunti i seguenti valori enum:
Enum Valori TargetingType
2 febbraio 2022
È stato aggiunto il supporto per la creazione, l'aggiornamento e la
modifica dei membri di determinate risorse Customer Match
FirstAndThirdPartyAudience
. La pagina
Carica segmenti di pubblico Customer Match della nostra nuova
guida all'utilizzo dei segmenti di pubblico illustra in dettaglio come utilizzare queste nuove funzionalità.
È stato introdotto un nuovo campo reservationType
nelle risorse
InsertionOrder
e LineItem
che indica se una risorsa è garantita da tag, programmaticamente garantita o non garantita.
È stata aggiunta la possibilità di recuperare e impostare se un elemento pubblicitario sceglie automaticamente come target nuove piattaforme di scambio pubblicitario tramite un nuovo campo excludeNewExchanges
.
Oltre alle nuove funzionalità, i limiti di quota predefiniti sono stati raddoppiati.
Nuove funzionalità
Sono stati aggiunti i seguenti metodi:
Servizio Metodo o metodi firstAndThirdPartyAudiences Sono stati aggiunti i seguenti campi:
Risorsa Campo/i FirstAndThirdPartyAudience InsertionOrder LineItem
8 dicembre 2021
È stato aggiunto il supporto per il targeting per tipo di contenuti audio nel tipo di targeting
TARGETING_TYPE_AUDIO_CONTENT_TYPE
.
Nuove funzionalità
Sono stati aggiunti i seguenti campi:
Risorsa Campo/i AssignedTargetingOption TargetingOption Sono stati aggiunti i seguenti valori enum:
Enum Valori TargetingType
8 novembre 2021
È stato aggiunto il supporto completo per la gestione degli algoritmi di offerta personalizzata e dei relativi script. È incluso quanto segue:
- Funzioni per create nuovi aggiornare esistenti
customBiddingAlgorithms
. - La possibilità di caricare gli script tramite il processo di recupero di una posizione della risorsa disponibile e poi caricamento del file in quella posizione.
- Un nuovo servizio
customBiddingAlgorithms.scripts
per recuperare e createcustomBiddingScripts
.
È stata aggiunta una nuova pagina Implementare le offerte personalizzate alla nostra guida Gestire gli elementi pubblicitari che descrive la procedura per creare un algoritmo di offerte personalizzate, caricare uno script e assegnare l'algoritmo di offerte personalizzate come strategia di offerta di un elemento pubblicitario.
È stato aggiunto il supporto per la versione SDF più recente, v5.4, tramite l'aggiunta di un valore enum SdfVersion
.
Nuove funzionalità
Sono stati aggiunti i seguenti metodi:
Servizio Metodo o metodi customBiddingAlgorithms customBiddingAlgorithms.scripts media Sono stati aggiunti i seguenti valori enum:
Enum Valori SdfVersion
14 settembre 2021
È stato aggiunto il supporto per il targeting di prossimità nei tipi di targeting
TARGETING_TYPE_BUSINESS_CHAIN
e
TARGETING_TYPE_POI
.
È stata aggiunta la possibilità di cercare le opzioni di targeting disponibili per TARGETING_TYPE_BUSINESS_CHAIN
e TARGETING_TYPE_POI
utilizzando targetingTypes.targetingOptions.search
, poiché non possono essere recuperate tramite i metodi targetingTypes.targetingOptions.get
o targetingTypes.targetingOptions.list
.
Sono stati introdotti nuovi campi sharedAdvertiserIds
e
customBiddingAlgorithmState
nella risorsa Algoritmo
delle offerte personalizzate e è stato aggiunto il supporto per il
tipo di algoritmo delle offerte personalizzate
GOAL_BUILDER_BASED
.
Sono stati aggiunti due nuovi valori all'enum Exchange
.
Nuove funzionalità
Sono stati aggiunti i seguenti campi:
Risorsa Campo/i AssignedTargetingOption CustomBiddingAlgorithm TargetingOption Corpo della richiesta TargetingOptions.search Sono stati aggiunti i seguenti valori enum:
Enum Valori CustomBiddingAlgorithmType Piattaforma di scambio pubblicitario TargetingType I seguenti metodi di elenco ora possono essere filtrati in base alle seguenti proprietà:
Metodo Campo/i customBiddingAlgorithms.list
4 agosto 2021
È stato aggiunto il supporto per il targeting dell'inventario abilitato per Open Measurement nel tipo di targeting
TARGETING_TYPE_OMID
.
È stato aumentato il numero massimo di opzioni di targeting assegnate che possono essere restituite
in una singola pagina di vari metodi di elenco di opzioni di targeting assegnate per inserzionista, campagna,
ordine di inserzione ed elemento pubblicitario utilizzando il parametro del metodo pageSize
.
Nuove funzionalità
Sono stati aggiunti i seguenti campi:
Risorsa Campo/i AssignedTargetingOption TargetingOption Sono stati aggiunti i seguenti valori enum:
Enum Valori TargetingType La dimensione massima della pagina è stata aumentata per i seguenti metodi di elenco:
Metodo Nuove dimensioni massime della pagina advertisers.campaigns.targetingTypes.assignedTargetingOptions.list 5000 advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.list 5000 advertisers.lineItems.targetingTypes.assignedTargetingOptions.list 5000 advertisers.targetingTypes.assignedTargetingOptions.list 5000
26 maggio 2021
È stato lanciato il servizio advertisers.invoices
, che consente agli utenti di:
- recuperare le fatture emesse a un inserzionista durante un determinato mese.
- Cerca il codice valuta utilizzato da un inserzionista in un determinato mese.
È stato aggiunto il campo campaignBudgets
alla risorsa della campagna. I segmenti di budget degli ordini di inserzione possono essere collegati a un budget della campagna, limitando la somma del budget dei segmenti associati all'importo totale del budget della campagna.
È stato aggiunto il supporto per il
targeting per posizione dei contenuti nativi nel nuovo
tipo di targeting TARGETING_TYPE_NATIVE_CONTENT_POSITION
.
È stato introdotto un nuovo campo prismaEnabled
nella risorsa dell'inserzionista, che consente agli utenti di attivare l'integrazione con lo strumento Prisma di Mediaocean.
È stato attivato il supporto del valore dell'enum ENTITY_STATUS_PAUSED
per il campo entityStatus
dell'inserzionista.
Nuove funzionalità
Sono stati aggiunti i seguenti metodi:
Servizio Metodo o metodi advertisers.invoices Sono stati aggiunti i seguenti campi:
Risorsa Campo/i Inserzionista AssignedTargetingOption TargetingOption Sono stati aggiunti i seguenti valori enum:
Enum Valori AssignedTargetingOption.Recency Piattaforma di scambio pubblicitario TargetingType I seguenti valori enum sono ora validi per i seguenti campi:
Risorsa Campo Valori Inserzionista entityStatus ENTITY_STATUS_PAUSED
29 aprile 2021
Sono stati aggiunti nuovi campi alle risorse Canale e Elenco di parole chiave escluse che restituiscono il conteggio degli elementi di riga che utilizzano la risorsa per il targeting. Sono state attivate nuove proprietà filter
per il metodo elenco di elementi pubblicitari che consentono all'utente di recuperare solo gli elementi pubblicitari che utilizzano canali o elenchi di parole chiave escluse specifici nel targeting.
Nuove funzionalità
Sono stati aggiunti i seguenti campi:
Risorsa Campo/i Canale I seguenti metodi di elenco ora possono essere filtrati in base alle seguenti proprietà:
Metodo Campo/i advertisers.lineItems.list targetedChannelId
targetedNegativeKeywordListId
30 marzo 2021
È stato aggiunto un nuovo metodo al servizio degli elementi pubblicitari che genera un elemento pubblicitario con configurazioni predefinite. Questi valori predefiniti si basano sul tipo di elemento pubblicitario specificato, nonché sulle impostazioni e sul targeting assegnati all'ordine di inserzione principale.
È stato attivato il recupero del targeting della campagna tramite un nuovo servizio di targeting della campagna e un metodo aggiuntivo per gli elenchi collettivi.
Targeting per app ampliato per consentire il targeting delle app su più piattaforme.
Sono state apportate diverse modifiche ai servizi advertisers.channels.sites
,
partners.channels.sites
e
advertisers.negativeKeywordLists.negativeKeywords
per
consentire una gestione più facile dei contenuti dei canali e degli elenchi di parole chiave escluse. Queste modifiche includono:
- L'aggiunta di metodi
replace
, che consente a un utente di sovrascrivere completamente i contenuti esistenti di un canale o di un elenco di parole chiave escluse. - La rimozione del requisito che nessun elemento esistente sia incluso nei campi
createdSites
ocreatedNegativeKeywords
delle richieste di modifica collettiva. - L'aumento del numero massimo di elementi che possono essere restituiti in una singola pagina di una risposta elenca siti o elenca parole chiave escluse.
Nuove funzionalità
Sono stati aggiunti i seguenti metodi:
Sono stati aggiunti i seguenti campi:
Risorsa Campo/i AssignedTargetingOption.AppAssignedTargetingOptionDetails La dimensione massima della pagina è stata aumentata per i seguenti metodi di elenco:
Metodo Dimensioni massime della pagina precedenti Nuove dimensioni massime della pagina advertisers.channels.sites.list 100 10000 advertisers.negativeKeywordLists.negativeKeywords.list 100 1000 partners.channels.sites.list 100 10000
Deprecazioni
I seguenti valori enumerati non possono più essere assegnati a risorse nuove o esistenti:
Enum Valori PartnerRevenueModelMarkupType PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP
24 febbraio 2021
È stato introdotto un nuovo servizio di targeting per gli ordini di inserzione e un metodo aggiuntivo per gli elenchi collettivi che consente di recuperare il targeting assegnato agli ordini di inserzione. È stata espansa la risorsa creatività, aggiungendo campi della creatività solo per l'output da utilizzare per le creatività audio di terze parti. Sono stati aggiunti nuovi tipi di obiettivi di rendimento per l'utilizzo da parte delle risorse ordine di inserzione e campagna.
Nuove funzionalità
Sono stati aggiunti i seguenti metodi:
Servizio Metodo o metodi advertisers.insertionOrders advertisers.insertionOrders.targetingTypes.assignedTargetingOptions Sono stati aggiunti i seguenti campi:
Risorsa Campo/i Creatività Sono stati aggiunti i seguenti valori enum:
Enum Valori ContentInstreamPosition PerformanceGoalType PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE
PERFORMANCE_GOAL_TYPE_CLICK_CVR
PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR
27 gennaio 2021
È stato attivato il recupero e la gestione degli ordini di inserzione TV e degli elementi pubblicitari over-the-top tramite l'introduzione di un nuovo campo InsertionOrderType e di un nuovo valore enumerato LineItemType. È stato aggiunto il supporto per gli elementi pubblicitari per app mobile tramite un campo elemento pubblicitario mobileApp
.
Supporto ampliato per piattaforme di scambio pubblicitario, segmenti di pubblico di Google e
SDF tramite valori enumerati aggiuntivi. È stata introdotta la possibilità di filtrare e ordinare i valori advertisers.list
in base all'ora dell'ultimo aggiornamento.
Nuove funzionalità
Sono stati aggiunti i seguenti campi:
Risorsa Campo/i InsertionOrder LineItem Sono stati aggiunti i seguenti valori enum:
Enum Valori Piattaforma di scambio pubblicitario GoogleAudienceType LineItemType SdfVersion I seguenti metodi di elenco ora possono essere ordinati e filtrati in base ai seguenti campi:
Metodo Campo/i inserzionisti
4 dicembre 2020
È stata aggiunta la possibilità di cercare opzioni di targeting per regione geografica e filtrare più risultati del metodo dell'elenco di risorse in base all'ora dell'ultimo aggiornamento. È stato introdotto un nuovo messaggio LineItemWarningMessage per informare gli utenti quando un elemento pubblicitario utilizza il targeting geografico deprecato.
Nuove funzionalità
Sono stati aggiunti i seguenti metodi:
Servizio Metodo o metodi targetingTypes.targetingOptions Sono stati aggiunti i seguenti valori enum:
Enum Valori Piattaforma di scambio pubblicitario LineItemWarningMessage I seguenti metodi di elenco ora possono essere ordinati e filtrati in base ai seguenti campi:
Metodo Campo/i advertisers.campaigns.list advertisers.insertionOrders.list advertisers.lineItems.list
5 novembre 2020
È stata aggiunta la possibilità di creare, assegnare e attivare attivatori manuali che avviano la spesa degli elementi pubblicitari associati. Sono state introdotte le opzioni di espansione del targeting che, se impostate, possono espandere il targeting di un elemento pubblicitario in modo da includere gli utenti simili a quelli dei segmenti di pubblico di destinazione. È stato aggiunto un campo ID segmento personalizzato agli oggetti DoubleVerify e Integral Ad Science utilizzati nel targeting per la verifica di terze parti.
Nuove funzionalità
Sono stati aggiunti i seguenti servizi:
Servizio Metodo o metodi advertisers.manualTriggers Sono stati aggiunti i seguenti campi:
Risorsa Campo/i AssignedTargetingOption.DoubleVerify AssignedTargetingOption.IntegralAdScience LineItem LineItemFlight Sono stati aggiunti i seguenti valori enum:
Enum Valori LineItemFlightDateType I seguenti metodi di elenco ora possono essere filtrati in base ai seguenti campi:
Metodo Campo/i advertisers.lineItems.list
12 ottobre 2020
Sono stati introdotti messaggi di avviso recuperabili nella risorsa elemento pubblicitario e un tipo di obiettivo di rendimento basato sulla percentuale di clic (CTR). È stato aggiunto
warningMessages
come campo filtrabile durante la visualizzazione degli elementi pubblicitari.
Oltre alle nuove funzionalità, sono ora in vigore nuovi limiti di quota ed è disponibile nuova documentazione sull'utilizzo delle richieste batch.
Nuove funzionalità
Sono stati aggiunti i seguenti campi:
Risorsa Campo/i LineItem Sono stati aggiunti i seguenti valori enum:
Enum Valori PerformanceGoalType I seguenti metodi di elenco sono ora filtrabili in base ai seguenti campi:
Metodo Campo/i advertisers.lineItems.list
28 agosto 2020
Sono stati aggiunti nuovi campi alla risposta del metodo di controllo dell'inserzionista e nuovi campi filtrabili a vari metodi di elenco.
Nuove funzionalità
Sono stati aggiunti i seguenti campi:
Risorsa Campo/i Corpo della risposta Advertisers.Audit I seguenti metodi di elenco ora possono essere filtrati in base ai seguenti campi:
Metodo Campo/i advertisers.list advertisers.campaigns.list advertisers.insertionOrders.list advertisers.lineItems.list targetingTypes.targetingOptions.list
4 agosto 2020
Sono stati lanciati nuovi servizi di gestione degli utenti, dei partner e di targeting per i partner. Sono stati introdotti strumenti per aiutare gli utenti a evitare in modo proattivo di raggiungere i limiti di entità dell'account. È stato aggiunto il supporto per gli elementi pubblicitari audio e l'utilizzo di algoritmi di offerta personalizzata nelle strategie di offerta degli elementi pubblicitari e degli ordini di inserzione.
Nuove funzionalità
Sono stati aggiunti i seguenti servizi:
Servizio Metodo o metodi customBiddingAlgorithms partner partners.targetingTypes.assignedTargetingOptions utenti Sono stati aggiunti i seguenti metodi:
Servizio Metodo o metodi inserzionisti Sono stati aggiunti i seguenti campi:
Risorsa Campo/i MaximizeSpendBidStrategy PerformanceGoalBidStrategy Sono stati aggiunti i seguenti valori enum:
Enum Valori BiddingStrategyPerformanceGoalType LineItemType I seguenti metodi di elenco ora possono essere ordinati e filtrati in base ai seguenti campi:
Metodo Campo/i advertisers.lineItems.list I seguenti ambiti sono stati aggiunti per l'utilizzo per i seguenti servizi:
Ambito Servizi https://www.googleapis.com/auth/display-video-user-management
24 giugno 2020
È stato lanciato un piccolo aggiornamento che aggiunge un metodo di creazione per i canali partner e inserzionista, nuovi campi FirstAndThirdPartyAudience e valori enumerati exchange aggiuntivi.
Nuove funzionalità
Sono stati aggiunti i seguenti servizi:
Servizio Metodo o metodi advertisers.channels partners.channels Sono stati aggiunti i seguenti campi:
Risorsa Campo/i FirstAndThirdPartyAudience Sono stati aggiunti i seguenti valori enum:
Enum Valori Piattaforma di scambio pubblicitario I seguenti metodi di elenco ora possono essere filtrati in base ai seguenti campi:
Metodo Campo/i advertisers.creatives.list
2 giugno 2020
È stata introdotta la possibilità di creare, correggere e compilare un sottoinsieme di entità selezionabili e di modificare il targeting a livello di inserzionista per tre tipi di targeting: canale, esclusione di etichette di contenuti digitali ed esclusione di categorie sensibili.
Nuove funzionalità
Sono stati aggiunti i seguenti servizi:
Sono stati aggiunti i seguenti metodi:
Servizio Metodo o metodi inserzionisti advertisers.channels advertisers.locationLists advertisers.negativeKeywordLists inventorySourceGroups partners.channels Sono stati aggiunti i seguenti campi:
Risorsa Campo/i inserzionista creatività insertionOrder.insertionOrderBudgetSegment
27 aprile 2020
È stato lanciato un ampio insieme di funzionalità, che ha ampliato l'ambito dell'API oltre SDF. È stata aggiunta la gestione delle risorse di base che consente di creare, recuperare, aggiornare ed eliminare entità come inserzionisti, campagne, ordini di inserzione, elementi pubblicitari e creatività. Le nuove funzionalità consentono anche di modificare il targeting a livello di elemento pubblicitario.
Nuove funzionalità
Sono stati aggiunti i seguenti servizi:
9 marzo 2020
È stata lanciata la versione 1 dell'API Display & Video 360. Questa è la versione iniziale dell'API.
Problemi noti
Nessuno.