Note di rilascio

Questa pagina fornisce le note di rilascio dell'API Display & Video 360.

Versione API più recente: v3

4 dicembre 2024

Nuove funzionalità

È stato aggiunto il supporto per i valori Core e Tubi Exchange.

È stata aumentata la dimensione massima consentita della pagina per firstAndThirdPartyAudiences.list da 200 a 5000. Aggiorna il parametro pageSize delle richieste firstAndThirdPartyAudiences.list per ottimizzare ulteriormente l'utilizzo della quota.

v3

• Sono stati aggiunti i seguenti valori enum:

  Enum	Valori
  Exchange	EXCHANGE_CORE EXCHANGE_TUBI

• La dimensione massima della pagina è stata aumentata per i seguenti metodi di elenco:

  Metodo	Nuove dimensioni massime della pagina
  firstAndThirdPartyAudiences.list	5000

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

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

• 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à

È stato aggiunto il supporto per il download dei file di dati strutturati di elementi pubblicitari e gruppi di annunci in formato QA nella versione 3.

v3

• Sono stati aggiunti i seguenti campi:

  Risorsa	Campo/i
  IdFilter	adGroupQaIds lineItemQaIds

• 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	optimizationObjective

• 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 advertisers.targetingType.assignedTargetingOptions.get advertisers.targetingType.assignedTargetingOptions.list

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 advertisers.targetingType.assignedTargetingOptions.get advertisers.targetingType.assignedTargetingOptions.list

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	kpiAlgorithmId

• 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	removedContactInfoList removedMobileDeviceIdList

• 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	removedContactInfoList removedMobileDeviceIdList

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

• Sono stati aggiunti i seguenti campi:

  Risorsa	Campo/i
  Utente	lastLoginTime
  YoutubeAndPartnersInventorySourceConfig	includeGoogleTv

v2

• Sono stati aggiunti i seguenti metodi:

  Servizio	Metodo o metodi
  floodlightGroups.floodlightActivities	get list

• Sono stati aggiunti i seguenti campi:

  Risorsa	Campo/i
  Utente	lastLoginTime
  YoutubeAndPartnersInventorySourceConfig	includeGoogleTv

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	consenso
  MobileDeviceIdList	consenso

v2

• Sono stati aggiunti i seguenti campi:

  Risorsa	Campo/i
  ContactInfoList	consenso
  MobileDeviceIdList	consenso

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 risorse TARGETING_LOCATION_TYPE_PROXIMITY LocationList.
• Un nuovo campo booleano enableOptimizedTargeting, che sostituisce il campo targetingExpansionLevel nell'oggetto TargetingExpansionConfig.
• Il requisito del campo billingConfig nella risorsa Advertiser, che deve essere incluso quando si effettuano richieste advertisers.create, e un nuovo campo billingConfig nella risorsa Partner.
• Nuove risorse AdGroup e AdGroupAd che sostituiscono le risorse YoutubeAdGroup e YoutubeAdGroupAd 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	get list
  advertisers.adGroups	bulkListAdGroupAssignedTargetingOptions get list
  advertisers.adGroups.targetingTypes.assignedTargetingOptions	get list
  customBiddingAlgorithms	uploadRules
  customBiddingAlgorithms.rules	crea get list

• 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 risorse TARGETING_LOCATION_TYPE_PROXIMITY LocationList.
  advertisers.locationLists.assignedLocations.create	Ora supporta la creazione di risorse AssignedLocation nelle risorse TARGETING_LOCATION_TYPE_PROXIMITY LocationList.

• Sono stati aggiunti i seguenti parametri di query:

  Metodo	Parametro o parametri
  inventorySources.get	advertiserId

• I seguenti campi sono stati impostati come obbligatori:

  Risorsa	Campo/i
  Inserzionista	billingConfig

• Sono stati aggiunti i seguenti campi:

  Risorsa	Campo/i
  BiddingStrategy	youtubeAndPartnersBid
  InsertionOrder	KPI
  Partner	billingConfig
  TargetingExpansionConfig	audienceExpansionLevel audienceExpansionSeedListExcluded enableOptimizedTargeting
  YoutubeAndPartnersSettings	thirdPartyMeasurementConfigs
  YoutubeAndPartnersInventorySourceConfig	includeYoutube

• 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	effectiveContentCategory

• 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	get list
  advertisers.youtubeAdGroups	bulkListAdGroupAssignedTargetingOptions get list
  advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions	get list

• Sono stati aggiunti i seguenti campi:

  Servizio	Metodo o metodi
  AssignedTargetingOption	sessionPositionDetails youtubeChannelDetails youtubeVideoDetails
  YoutubeAndPartnersSettings	leadFormId linkedMerchantId relatedVideoIds targetFrequency videoAdSequenceSettings

• 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	billingConfig
  AssignedTargetingOption	assignedTargetingOptionIdAlias

• 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:

  Metodo	Nuove dimensioni massime della pagina
  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

• La dimensione massima della pagina è stata aumentata per i seguenti metodi di elenco:

  Metodo	Nuove dimensioni massime della pagina
  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

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 utilizzando assignedTargetingOptionId o il valore dell'enum, identificato dal nuovo campo assignedTargetingOptionIdAlias nella risorsa AssignedTargetingOption.
• La richiesta dell'elemento pubblicitario bulkUpdate non utilizzava correttamente il parametro di richiesta advertisersId, restituendo un errore. Con questo aggiornamento, il metodo è stato corretto e il parametro di richiesta è stato rinominato da advertisersId a advertiserId.

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	crea elimina
  advertisers.lineItems	duplicate

v1

Alla versione 1 non sono state aggiunte nuove funzionalità.

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 e list nei servizi advertisers.lineItems e advertisers.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 il entityStatus 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 servizio targetingTypes.targetingOptions.

Segui i passaggi descritti nella nostra guida alla migrazione per eseguire la migrazione dalla versione 1 alla versione 2.

Nella versione 1 è stato aggiunto il supporto di tre nuovi marketplace.

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 bulkListAssignedTargetingOptions bulkUpdate

• 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	editAssignedTargetingOptions listAssignedTargetingOptions
  advertisers.campaigns	bulkListCampaignAssignedTargetingOptions	listAssignedTargetingOptions
  advertisers.insertionOrders	bulkListInsertionOrderAssignedTargetingOptions	listAssignedTargetingOptions
  partner	bulkEditPartnerAssignedTargetingOptions	editAssignedTargetingOptions

• Le risorse AssignedTargetingOption dei seguenti tipi di targeting utilizzano enum per l'assegnazione del targeting nella versione 2. Anche il campo assignedTargetingOptionId per le risorse AssignedTargetingOption 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:

  Risorsa	Campo/i
  CustomBiddingAlgorithm	modelDetails
  DeviceTypeAssignedTargetingOptionDetails	youtubeAndPartnersBidMultiplier
  DigitalContentLabelAssignedTargetingOptionDetails	excludedContentRatingTier
  ExchangeAssignedTargetingOptionDetails	scambio
  FrequencyCap	maxViews
  LineItem	youtubeAndPartnersSettings
  ProximityLocationListAssignedTargetingOptionDetails	proximityRadius proximityRadiusUnit
  SensitiveCategoryAssignedTargetingOptionDetails	excludedSensitiveCategory

• I seguenti campi sono stati rimossi nella versione 2:

  Risorsa	Campo/i
  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

• I seguenti campi sono stati impostati come obbligatori nella versione 2:

  Risorsa	Campo/i
  AgeRangeAssignedTargetingOptionDetails	ageRange
  ContentInstreamPositionAssignedTargetingOptionDetails	contentInstreamPosition
  ContentOutstreamPositionAssignedTargetingOptionDetails	contentOutstreamPosition
  DeviceTypeAssignedTargetingOptionDetails	deviceType
  DigitalContentLabelAssignedTargetingOptionDetails	excludedContentRatingTier
  EnvironmentAssignedTargetingOptionDetails	environment
  ExchangeAssignedTargetingOptionDetails	scambio
  GenderAssignedTargetingOptionDetails	gender
  HouseholdIncomeAssignedTargetingOptionDetails	householdIncome
  NativeContentPositionAssignedTargetingOptionDetails	contentPosition
  OmidAssignedTargetingOptionDetails	omid
  ParentalStatusAssignedTargetingOptionDetails	parentalStatus
  SensitiveCategoryAssignedTargetingOptionDetails	excludedSensitiveCategory
  VideoPlayerSizeAssignedTargetingOptionDetails	videoPlayerSize
  ViewabilityAssignedTargetingOptionDetails	viewability

• 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	crea editGuaranteedOrderReadAccessors get list patch
  inventorySources	crea editInventorySourceReadWriteAccessors patch

• Sono stati aggiunti i seguenti campi:

  Risorsa	Campo/i
  CustomBiddingAlgorithm	modelReadiness
  InventorySource	inventorySourceProductType guaranteedOrderId readAdvertiserIds readPartnerIds readWriteAccessors

• Sono stati aggiunti i seguenti valori enum:

  Enum	Valori
  SdfVersion	SDF_VERSION_5_5

• I seguenti metodi di elenco ora possono essere filtrati in base alle seguenti proprietà:

  Metodo	Campo/i
  advertisers.creatives.list	updateTime

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	contentDurationDetails contentGenreDetails contentStreamTypeDetails
  InsertionOrder	billableOutcome
  MaximizeSpendBidStrategy	raiseBidForDeals
  TargetingOption	contentDurationDetails contentGenreDetails contentStreamTypeDetails

• Sono stati aggiunti i seguenti valori enum:

  Enum	Valori
  TargetingType	TARGETING_TYPE_CONTENT_DURATION TARGETING_TYPE_CONTENT_GENRE TARGETING_TYPE_CONTENT_STREAM_TYPE

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 Utilizzare i 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	crea editCustomerMatchMembers patch

• Sono stati aggiunti i seguenti campi:

  Risorsa	Campo/i
  FirstAndThirdPartyAudience	appId contactInfoList mobileDeviceIdList
  InsertionOrder	reservationType
  LineItem	excludeNewExchanges reservationType

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	audioContentTypeDetails
  TargetingOption	audioContentTypeDetails

• Sono stati aggiunti i seguenti valori enum:

  Enum	Valori
  TargetingType	TARGETING_TYPE_AUDIO_CONTENT_TYPE

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 creare 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 creare customBiddingScripts.

È 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	crea patch uploadScript
  customBiddingAlgorithms.scripts	crea get list
  media	upload

• Sono stati aggiunti i seguenti valori enum:

  Enum	Valori
  SdfVersion	SDF_VERSION_5_4

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	businessChainDetails poiDetails
  CustomBiddingAlgorithm	customBiddingAlgorithmState sharedAdvertiserIds
  TargetingOption	businessChainDetails poiDetails
  Corpo della richiesta TargetingOptions.search	businessChainSearchTerms poiSearchTerms

• Sono stati aggiunti i seguenti valori enum:

  Enum	Valori
  CustomBiddingAlgorithmType	GOAL_BUILDER_BASED
  Piattaforma di scambio pubblicitario	EXCHANGE_RED_FOR_PUBLISHERS EXCHANGE_TAPJOY
  TargetingType	TARGETING_TYPE_BUSINESS_CHAIN TARGETING_TYPE_POI

• I seguenti metodi di elenco ora possono essere filtrati in base alle seguenti proprietà:

  Metodo	Campo/i
  customBiddingAlgorithms.list	customBiddingAlgorithmState

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	omidDetails
  TargetingOption	omidDetails

• Sono stati aggiunti i seguenti valori enum:

  Enum	Valori
  TargetingType	TARGETING_TYPE_OMID

• 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 il budget totale dei segmenti associati all'importo del budget totale 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	list lookupInvoiceCurrency

• Sono stati aggiunti i seguenti campi:

  Risorsa	Campo/i
  Inserzionista	prismaEnabled
  AssignedTargetingOption	nativeContentPositionDetails
  Campagna	campaignBudgets
  TargetingOption	nativeContentPositionDetails

• Sono stati aggiunti i seguenti valori enum:

  Enum	Valori
  AssignedTargetingOption.Recency	RECENCY_45_DAYS
  Piattaforma di scambio pubblicitario	EXCHANGE_MEDIANET
  TargetingType	TARGETING_TYPE_NATIVE_CONTENT_POSITION

• 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	negativelyTargetedLineItemCount positivelyTargetedLineItemCount
  NegativeKeywordList	targetedLineItemCount

• 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 o createdNegativeKeywords 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:

  Servizio	Metodo o metodi
  advertisers.campaigns	bulkListCampaignAssignedTargetingOptions
  advertisers.campaigns.targetingTypes.assignedTargetingOptions	get list
  advertisers.channels.sites	replace
  advertisers.lineItems	generateDefault
  advertisers.negativeKeywordLists.negativeKeywords	replace
  partners.channels.sites	replace

• Sono stati aggiunti i seguenti campi:

  Risorsa	Campo/i
  AssignedTargetingOption.AppAssignedTargetingOptionDetails	appPlatform

• 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 ampliata 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	bulkListInsertionOrderAssignedTargetingOptions
  advertisers.insertionOrders.targetingTypes.assignedTargetingOptions	get elenco

• Sono stati aggiunti i seguenti campi:

  Risorsa	Campo/i
  Creatività	mp3Audio oggAudio

• Sono stati aggiunti i seguenti valori enum:

  Enum	Valori
  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 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	insertionOrderType
  LineItem	mobileApp

• Sono stati aggiunti i seguenti valori enum:

  Enum	Valori
  Piattaforma di scambio pubblicitario	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

• I seguenti metodi di elenco ora possono essere ordinati e filtrati in base ai seguenti campi:

  Metodo	Campo/i
  inserzionisti	updateTime

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	ricerca

• Sono stati aggiunti i seguenti valori enum:

  Enum	Valori
  Piattaforma di scambio pubblicitario	EXCHANGE_SUPERSHIP
  LineItemWarningMessage	TARGETING_DEPRECATED_GEO_TARGET

• I seguenti metodi di elenco ora possono essere ordinati e filtrati in base ai seguenti campi:

  Metodo	Campo/i
  advertisers.campaigns.list	updateTime
  advertisers.insertionOrders.list	updateTime
  advertisers.lineItems.list	updateTime

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	attiva create deactivate get elenco patch

• Sono stati aggiunti i seguenti campi:

  Risorsa	Campo/i
  AssignedTargetingOption.DoubleVerify	customSegmentId
  AssignedTargetingOption.IntegralAdScience	customSegmentId
  LineItem	targetingExpansion
  LineItemFlight	triggerId

• Sono stati aggiunti i seguenti valori enum:

  Enum	Valori
  LineItemFlightDateType	LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER

• I seguenti metodi di elenco ora possono essere filtrati in base ai seguenti campi:

  Metodo	Campo/i
  advertisers.lineItems.list	filter.triggerId

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	warningMessages

• Sono stati aggiunti i seguenti valori enum:

  Enum	Valori
  PerformanceGoalType	PERFORMANCE_GOAL_TYPE_CTR

• I seguenti metodi di elenco ora possono essere filtrati in base ai seguenti campi:

  Metodo	Campo/i
  advertisers.lineItems.list	warningMessages

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	adGroupCriteriaCount campaignCriteriaCount channelsCount negativeKeywordListsCount negativelyTargetedChannelsCount

• I seguenti metodi di elenco ora possono essere filtrati in base ai seguenti campi:

  Metodo	Campo/i
  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 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	get elenco
  partner	bulkEditPartnerAssignedTargetingOptions get elenco
  partners.targetingTypes.assignedTargetingOptions	create elimina get elenco
  utenti	bulkEditAssignedUserRoles create elimina get elenco patch

• Sono stati aggiunti i seguenti metodi:

  Servizio	Metodo o metodi
  inserzionisti	controllo

• Sono stati aggiunti i seguenti campi:

  Risorsa	Campo/i
  MaximizeSpendBidStrategy	customBiddingAlgorithmId
  PerformanceGoalBidStrategy	customBiddingAlgorithmId

• Sono stati aggiunti i seguenti valori enum:

  Enum	Valori
  BiddingStrategyPerformanceGoalType	BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO
  LineItemType	LINE_ITEM_TYPE_AUDIO_DEFAULT

• I seguenti metodi di elenco ora possono essere ordinati e filtrati in base ai seguenti campi:

  Metodo	Campo/i
  advertisers.lineItems.list	flight.dateRange.endDate

• I seguenti ambiti sono stati aggiunti per l'utilizzo per i seguenti servizi:

  Ambito	Servizi
  https://www.googleapis.com/auth/display-video-user-management	utenti

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	create
  partners.channels	create

• Sono stati aggiunti i seguenti campi:

  Risorsa	Campo/i
  FirstAndThirdPartyAudience	activeDisplayAudienceSize audienceSource audienceType descrizione displayAudienceSize displayDesktopAudienceSize displayMobileAppAudienceSize displayMobileWebAudienceSize gmailAudienceSize membershipDurationDays youtubeAudienceSize

• Sono stati aggiunti i seguenti valori enum:

  Enum	Valori
  Piattaforma di scambio pubblicitario	EXCHANGE_OPEN8 EXCHANGE_TRITON EXCHANGE_UNRULYX

• I seguenti metodi di elenco sono ora filtrabili in base ai seguenti campi:

  Metodo	Campo/i
  advertisers.creatives.list	creativeId

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:

  Servizio	Metodo o metodi
  advertisers.channels.sites	bulkEdit create elimina elenco
  advertisers.locationLists.assignedLocations	bulkEdit create elimina elenco
  advertisers.negativeKeywordLists.negativeKeywords	bulkEdit create elimina elenco
  advertisers.targetingTypes.assignedTargetingOptions	create elimina get elenco
  inventorySourceGroups.assignedInventorySources	bulkEdit create elimina elenco
  partners.channels.sites	bulkEdit create elimina elenco

• Sono stati aggiunti i seguenti metodi:

  Servizio	Metodo o metodi
  inserzionisti	bulkEditAdvertiserAssignedTargetingOptions bulkListAdvertiserAssignedTargetingOptions
  advertisers.channels	patch
  advertisers.locationLists	create patch
  advertisers.negativeKeywordLists	create elimina patch
  inventorySourceGroups	create elimina patch
  partners.channels	patch

• Sono stati aggiunti i seguenti campi:

  Risorsa	Campo/i
  inserzionista	servingConfig
  creatività	lineItemIds
  insertionOrder.insertionOrderBudgetSegment	campaignBudgetId

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:

Servizio	Metodo o metodi
inserzionisti	create elimina get elenco patch
advertisers.assets	carica
advertisers.campaigns	create elimina get elenco patch
advertisers.channels	get elenco
advertisers.creatives	create elimina get elenco patch
advertisers.insertionOrders	create elimina get Elenco patch
advertisers.lineItems	bulkEditLineItemAssignedTargetingOptions bulkListLineItemAssignedTargetingOptions create elimina get Elenco patch
advertisers.lineItems.targetingTypes.assignedTargetingOptions	create elimina get elenco
advertisers.locationLists	get elenco
advertisers.negativeKeywordLists	get elenco
combinedAudiences	get elenco
customLists	get elenco
firstAndThirdPartyAudiences	get Elenco
floodlightGroups	get patch
googleAudiences	get Elenco
inventorySourceGroups	get Elenco
inventorySources	get Elenco
partners.channels	get Elenco
partners.channels	get Elenco

9 marzo 2020

È stata lanciata la versione 1 dell'API Display & Video 360. Questa è la versione iniziale dell'API.

Problemi noti

Nessuno.