Note di rilascio archiviate

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

Visita la nostra pagina principale delle note di rilascio per visualizzare tutte le release delle versioni live.

4 dicembre 2024

Nuove funzionalità

Aggiunto il supporto per i valori Core e Tubi Exchange.

Aumento della 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 nella sezione targeting del verificatore di terze parti.

È stato aggiunto il supporto per il download dei file di dati strutturati v8, che 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 v5.5 in seguito al suo ritiro il 3 ottobre 2024.

v3

• I seguenti valori enum sono stati ritirati:

  Enum	Valori
  SdfVersion	SDF_VERSION_5_5

15 agosto 2024

Nuove funzionalità

È stato aggiunto il supporto per il tipo di proprietà Netflix Exchange.

v3

• Sono stati aggiunti i seguenti valori enum:

  Enum	Valore/i
  Exchange	EXCHANGE_NETFLIX

v2

• Sono stati aggiunti i seguenti valori enum:

  Enum	Valori
  Exchange	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 autorizzati.

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	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	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 per nuovi tipi di KPI, exchange e piattaforme di 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
  Exchange	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
  Exchange	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
  Exchange	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
  Exchange	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 Google TV nel targeting.

È stato aggiunto un nuovo campo per comunicare l'ultimo accesso di un utente Display & Video 360.

v3

• Sono stati aggiunti i seguenti metodi:

  Servizio	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	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 Customer Match in tutte le versioni live.

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 beta pubblica alla disponibilità generale.

È stato rinominato un valore enum AdGroupFormat nella v3 per riflettere in modo più accurato il formato pertinente.

È stato aggiunto il supporto per i file di dati strutturati v7 con l'aggiunta del valore enum SDF_VERSION_7 nelle versioni 2 e 3.

v3

• Sono stati rimossi i seguenti valori enum:

  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.

Aggiunto il supporto di tre nuovi valori LineItemType, un nuovo valore YoutubeAndPartnersBiddingStrategyType e un nuovo valore PartnerCostType nelle versioni 2 e 3.

v3

• Sono stati aggiunti i seguenti metodi:

  Servizio	Metodi
  advertisers.adGroupAds	get list
  advertisers.adGroups	bulkListAdGroupAssignedTargetingOptions get list
  advertisers.adGroups.targetingTypes.assignedTargetingOptions	get list
  customBiddingAlgorithms	uploadRules
  customBiddingAlgorithms.rules	create get list

• Sono stati rimossi i seguenti metodi:

  Servizio	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	Modifica/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/i
  inventorySources.get	advertiserId

• I seguenti campi sono stati resi 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

• Sono stati rimossi i seguenti campi:

  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

• Sono stati rimossi i seguenti valori enum:

  Enum	Valori
  LineItemWarningMessage	DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

v2

• Sono stati aggiunti i seguenti valori enum:

  Enum	Valore/i
  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 per due exchange e due nuovi tipi di strategia di offerta YouTube e partner.

È stato aggiunto un nuovo campo effectiveContentCategory agli elementi pubblicitari YouTube e partner per mostrare il 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

• Sono stati rimossi i seguenti campi:

  Risorsa	Campo/i
  InventorySource	subSitePropertyId

• Sono stati aggiunti i seguenti valori enum:

  Enum	Valori
  Exchange	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 i file di dati strutturati (SDF) v6 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 ritirato è 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 delle risorse del gruppo di annunci YouTube. Inoltre, abbiamo aggiunto nuovi tipi di targeting recuperabili utilizzati a livello di gruppi di annunci YouTube. Per saperne di più, consulta la nostra nuova pagina della guida sul recupero delle risorse YouTube e partner.

Aggiunto il supporto di quattro exchange aggiuntivi nelle versioni 1 e 2.

v2

• Sono stati aggiunti i seguenti metodi:

  Servizio	Metodi
  advertisers.youtubeAdGroupAds	get list
  advertisers.youtubeAdGroups	bulkListAdGroupAssignedTargetingOptions get list
  advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions	get list

• Sono stati aggiunti i seguenti campi:

  Servizio	Metodi
  AssignedTargetingOption	sessionPositionDetails youtubeChannelDetails youtubeVideoDetails
  YoutubeAndPartnersSettings	leadFormId linkedMerchantId relatedVideoIds targetFrequency videoAdSequenceSettings

• Sono stati aggiunti i seguenti valori enum:

  Enum	Valori
  Exchange	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
  Exchange	EXCHANGE_APPLOVIN EXCHANGE_CONNATIX EXCHANGE_JCD EXCHANGE_PLACE_EXCHANGE

6 dicembre 2022

Nuove funzionalità

La versione 2 è stata spostata dalla beta pubblica alla disponibilità generale.

È stato aggiunto un nuovo campo assignedTargetingOptionIdAlias alla risorsa AssignedTargetingOption, che può essere utilizzato al posto di assignedTargetingOptionId durante il recupero e l'eliminazione del targeting. Questo campo viene impostato solo per le opzioni di targeting assegnate dei tipi di targeting che vengono assegnate tramite enumerazione. Il valore dell'alias è il valore 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 YouTube e partner, identificati da tre nuovi valori LineItemType.

È stato aumentato a 200 il numero massimo di pagine per numerosi metodi list nelle versioni 1 e 2. Le dimensioni della pagina predefinita non vengono modificate.

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 corregge i seguenti problemi noti nella versione 2:

• Le opzioni di targeting assegnate dei tipi di targeting assegnati utilizzando i valori enum nella v2 non potevano essere rimosse o recuperate utilizzando il relativo assignedTargetingOptionId e invece gli utenti dovevano utilizzare il valore enum. Con questo aggiornamento, queste opzioni di targeting assegnate possono essere rimosse o recuperate utilizzando assignedTargetingOptionId o il valore 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 della richiesta è stato rinominato da advertisersId a advertiserId.

27 ottobre 2022

È stata aggiunta la possibilità di duplicare un elemento pubblicitario esistente all'interno dell'InsertionOrder principale.

È stato introdotto il supporto della scrittura del targeting parziale dell'ordine di inserzione 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	Metodi
  advertisers.insertionOrders.targetingTypes.assignedTargetingOptions	create elimina
  advertisers.lineItems	duplicate

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 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 a più elementi pubblicitari con una singola richiesta.
• Un nuovo metodo bulkUpdate che consente agli utenti di aggiornare la entityStatus di più elementi pubblicitari in un'unica richiesta.
• Nuova logica di targeting che richiede che le risorse AssignedTargetingOption di un sottoinsieme di tipi di targeting vengano assegnate e recuperate utilizzando valori enum anziché ID opzioni 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.

È stato aggiunto il supporto di tre nuovi exchange nella v1.

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	Metodi
  advertisers.lineItems	bulkEditAssignedTargetingOptions bulkListAssignedTargetingOptions bulkUpdate

• I seguenti metodi sono stati rimossi nella versione 2:

  Servizio	Metodi
  advertisers.lineItems	bulkEditLineItemAssignedTargetingOptions bulkListLineItemAssignedTargetingOptions

• I seguenti metodi sono stati rinominati nella versione 2:

  Servizio	Nome metodo precedente	Nuovo nome del 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 enumerazioni per l'assegnazione del targeting nella v2. Anche il campo assignedTargetingOptionId per le risorse AssignedTargetingOption di questi tipi di targeting è stato aggiornato nella v2 per utilizzare le versioni stringa dei valori enum:

  Tipo di targeting	Tipo di enumerazione
  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	Exchange
  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	exchange
  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 diventati obbligatori nella v2:

  Risorsa	Campo/i
  AgeRangeAssignedTargetingOptionDetails	ageRange
  ContentInstreamPositionAssignedTargetingOptionDetails	contentInstreamPosition
  ContentOutstreamPositionAssignedTargetingOptionDetails	contentOutstreamPosition
  DeviceTypeAssignedTargetingOptionDetails	deviceType
  DigitalContentLabelAssignedTargetingOptionDetails	excludedContentRatingTier
  EnvironmentAssignedTargetingOptionDetails	environment
  ExchangeAssignedTargetingOptionDetails	exchange
  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 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
  Exchange	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	Valore/i
  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
  Exchange	EXCHANGE_DAX EXCHANGE_FYBER EXCHANGE_VISTAR

26 maggio 2022

È stata aggiunta la possibilità di creare risorse InventorySource e gestire 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 più recente di SDF, v5.5, tramite l'aggiunta di un valore enum SdfVersion.

Nuove funzionalità

• Sono stati aggiunti i seguenti metodi:

  Servizio	Metodi
  guaranteedOrders	create editGuaranteedOrderReadAccessors get list patch
  inventorySources	create 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	Valore/i
  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 FirstAndThirdPartyAudience Customer Match. La pagina Carica segmenti di pubblico Customer Match della nostra nuova guida Utilizzare i segmenti di pubblico descrive in dettaglio come utilizzare queste nuove funzionalità.

È stato introdotto un nuovo campo reservationType nelle risorse InsertionOrder e LineItem che identifica se una risorsa è garantita da tag, garantita in modalità programmatica o non garantita.

È stata aggiunta la possibilità di recuperare e impostare se un elemento pubblicitario sceglie automaticamente come target nuove piattaforme di scambio 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	Metodi
  firstAndThirdPartyAudiences	create 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 aggiornamenti esistenti customBiddingAlgorithms.
• La possibilità di caricare script tramite la procedura di recupero di una posizione di risorsa disponibile e poi caricamento del file in quella posizione.
• Un nuovo servizio customBiddingAlgorithms.scripts per recuperare e creare customBiddingScripts.

Alla nostra guida Gestione degli elementi pubblicitari è stata aggiunta una nuova pagina Implementare le offerte personalizzate che descrive la procedura di creazione di un algoritmo di offerte personalizzate, caricamento di uno script e assegnazione dell'algoritmo di offerte personalizzate come strategia di offerta di un elemento pubblicitario.

È stato aggiunto il supporto per la versione più recente di SDF, v5.4, tramite l'aggiunta di un valore enum SdfVersion.

Nuove funzionalità

• Sono stati aggiunti i seguenti metodi:

  Servizio	Metodi
  customBiddingAlgorithms	create patch uploadScript
  customBiddingAlgorithms.scripts	create 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 TARGETING_TYPE_BUSINESS_CHAIN e TARGETING_TYPE_POI disponibili utilizzando targetingTypes.targetingOptions.search, in quanto 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 di offerta personalizzata ed è stato aggiunto il supporto per il tipo di algoritmo di offerta personalizzata GOAL_BUILDER_BASED.

Sono stati aggiunti due nuovi valori all'enumerazione 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
  Exchange	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 inserzionisti, campagne, ordini di inserzione ed elementi pubblicitari 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.
• cercare il codice valuta utilizzato da un inserzionista in un determinato mese.

È stato aggiunto il campo campaignBudgets alla risorsa campagna. I segmenti di budget dell'ordine di inserzione possono essere collegati a un budget della campagna, limitando il budget totale 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 inserzionista, che consente agli utenti di attivare l'integrazione con lo strumento Prisma di Mediaocean.

È stato attivato il supporto per il valore enum ENTITY_STATUS_PAUSED nel campo entityStatus dell'inserzionista.

Nuove funzionalità

• Sono stati aggiunti i seguenti metodi:

  Servizio	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
  Exchange	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 ed Elenco di parole chiave escluse che restituiscono il conteggio delle voci di linea che utilizzano la risorsa per il targeting. Sono state attivate nuove proprietà filter per il metodo di elenco degli 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 assegnato dell'ordine di inserzione principale.

È stato attivato il recupero del targeting delle campagne tramite un nuovo servizio di targeting delle campagne e un metodo di elenco collettivo aggiuntivo.

Targeting delle 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ù semplice dei contenuti degli elenchi di canali e 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 prevede che nessun elemento esistente venga 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 list sites o list negative keywords.

Nuove funzionalità

• Sono stati aggiunti i seguenti metodi:

  Servizio	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

Ritiri

• I seguenti valori enum non possono più essere assegnati a risorse nuove o esistenti:

  Enum	Valore/i
  PartnerRevenueModelMarkupType	PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP

24 febbraio 2021

È stato introdotto un nuovo servizio di targeting degli ordini di inserzione e un metodo di elenco collettivo aggiuntivo che consente il recupero del targeting assegnato agli ordini di inserzione. È stata espansa la risorsa della creatività, aggiungendo campi della creatività di sola uscita da utilizzare con creatività audio di terze parti. Sono stati aggiunti nuovi tipi di obiettivi di rendimento da utilizzare per le risorse di ordini di inserzione e campagne.

Nuove funzionalità

• Sono stati aggiunti i seguenti metodi:

  Servizio	Metodi
  advertisers.insertionOrders	bulkListInsertionOrderAssignedTargetingOptions
  advertisers.insertionOrders.targetingTypes.assignedTargetingOptions	get list

• Sono stati aggiunti i seguenti campi:

  Risorsa	Campo/i
  Creatività	mp3Audio oggAudio

• Sono stati aggiunti i seguenti valori enum:

  Enum	Valore/i
  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 di enumerazione LineItemType. È stato aggiunto il supporto per gli elementi pubblicitari delle app mobile tramite un campo dell'elemento pubblicitario mobileApp. Supporto esteso per exchange, segmenti di pubblico Google e SDF tramite valori enum aggiuntivi. È stata introdotta la possibilità di filtrare e ordinare i valori di 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
  Exchange	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 le opzioni di targeting per regione geografica e filtrare più risultati del metodo di elenco delle risorse in base all'ora dell'ultimo aggiornamento. È stato introdotto un nuovo LineItemWarningMessage per informare gli utenti quando un elemento pubblicitario utilizza il targeting geografico ritirato.

Nuove funzionalità

• Sono stati aggiunti i seguenti metodi:

  Servizio	Metodi
  targetingTypes.targetingOptions	search

• Sono stati aggiunti i seguenti valori enum:

  Enum	Valori
  Exchange	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 utenti simili a quelli dei segmenti di pubblico scelti come target. Campi ID segmento personalizzato aggiunti agli oggetti DoubleVerify e Integral Ad Science utilizzati nel targeting della verifica di terze parti.

Nuove funzionalità

• Sono stati aggiunti i seguenti servizi:

  Servizio	Metodi
  advertisers.manualTriggers	activate create deactivate get list 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 della percentuale di clic (CTR). Aggiunta di warningMessages come campo filtrabile durante l'elenco degli elementi pubblicitari.

Oltre alle nuove funzionalità, sono ora in vigore nuovi limiti di quota ed è disponibile una 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
  Advertisers.Audit Response Body	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 utenti, partner e targeting dei partner. Sono stati introdotti strumenti per aiutare gli utenti a evitare in modo proattivo di raggiungere i limiti delle entità dell'account. È stato aggiunto il supporto per gli elementi pubblicitari audio e l'utilizzo di algoritmi di offerta personalizzata nelle strategie di offerta per elementi pubblicitari e ordini di inserzione.

Nuove funzionalità

• Sono stati aggiunti i seguenti servizi:

  Servizio	Metodi
  customBiddingAlgorithms	get list
  partner	bulkEditPartnerAssignedTargetingOptions get list
  partners.targetingTypes.assignedTargetingOptions	create elimina get list
  utenti	bulkEditAssignedUserRoles create elimina get list patch

• Sono stati aggiunti i seguenti metodi:

  Servizio	Metodi
  inserzionisti	audit

• 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

• Sono stati aggiunti i seguenti ambiti da utilizzare per i seguenti servizi:

  Ambito	Servizio/i
  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 di enumerazione exchange aggiuntivi.

Nuove funzionalità

• Sono stati aggiunti i seguenti servizi:

  Servizio	Metodi
  advertisers.channels	create
  partners.channels	create

• Sono stati aggiunti i seguenti campi:

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

• Sono stati aggiunti i seguenti valori enum:

  Enum	Valori
  Exchange	EXCHANGE_OPEN8 EXCHANGE_TRITON EXCHANGE_UNRULYX

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

  Metodo	Campo/i
  advertisers.creatives.list	creativeId

2 giugno 2020

È stata introdotta la possibilità di creare, applicare patch e compilare un sottoinsieme di entità a cui è possibile applicare il targeting ed è stata aggiunta la possibilità 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	Metodi
  advertisers.channels.sites	bulkEdit create elimina list
  advertisers.locationLists.assignedLocations	bulkEdit create elimina list
  advertisers.negativeKeywordLists.negativeKeywords	bulkEdit create elimina list
  advertisers.targetingTypes.assignedTargetingOptions	create elimina get list
  inventorySourceGroups.assignedInventorySources	bulkEdit create elimina list
  partners.channels.sites	bulkEdit create elimina list

• Sono stati aggiunti i seguenti metodi:

  Servizio	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
  creative	lineItemIds
  insertionOrder.insertionOrderBudgetSegment	campaignBudgetId

27 aprile 2020

È stato lanciato un ampio set di funzionalità, ampliando l'ambito dell'API oltre l'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	Metodi
inserzionisti	create elimina get list patch
advertisers.assets	upload
advertisers.campaigns	create elimina get list patch
advertisers.channels	get list
advertisers.creatives	create elimina get list patch
advertisers.insertionOrders	create elimina get list patch
advertisers.lineItems	bulkEditLineItemAssignedTargetingOptions bulkListLineItemAssignedTargetingOptions create elimina get list patch
advertisers.lineItems.targetingTypes.assignedTargetingOptions	create elimina get list
advertisers.locationLists	get list
advertisers.negativeKeywordLists	get list
combinedAudiences	get list
customLists	get list
firstAndThirdPartyAudiences	get list
floodlightGroups	get patch
googleAudiences	get list
inventorySourceGroups	get list
inventorySources	get list
partners.channels	get list
partners.channels	get list

9 marzo 2020

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

Problemi noti

Nessuno.