Note di rilascio

Questa pagina fornisce note di rilascio per l'API Display & Video 360.

Versione API più recente: v3

23 aprile 2024

Nuove funzionalità

Aggiunto il supporto per nuovi tipi di KPI, piattaforme di scambio e piattaforme app.

v3

• Sono stati aggiunti i seguenti campi:

  Risorsa	Campo/i
  KPI	kpiAlgorithmId

• Sono stati aggiunti i seguenti valori di 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 di 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.

Aggiunto il supporto per il targeting di nuove piattaforme di scambio.

v3

• Sono stati aggiunti i seguenti campi:

  Risorsa	Campo/i
  firstAndThirdPartyAudiences.editCustomerMatchMembers	removedContactInfoList removedMobileDeviceIdList

• Sono stati aggiunti i seguenti valori di 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 di 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 comunica se un elemento pubblicitario YouTube e partner include l'inventario di Google TV nel targeting.

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

v3

• Sono stati aggiunti i seguenti metodi:

  Servizio	Metodi
  floodlightGroups.floodlightActivities	recupero list

• Sono stati aggiunti i seguenti campi:

  Risorsa	Campo/i
  User	lastLoginTime
  YoutubeAndPartnersInventorySourceConfig	includeGoogleTv

v2

• Sono stati aggiunti i seguenti metodi:

  Servizio	Metodi
  floodlightGroups.floodlightActivities	recupero list

• Sono stati aggiunti i seguenti campi:

  Risorsa	Campo/i
  User	lastLoginTime
  YoutubeAndPartnersInventorySourceConfig	includeGoogleTv

14 novembre 2023

Nuove funzionalità

Aggiunto il supporto per trasmettere il consenso degli utenti finali durante il caricamento dei membri del segmento di pubblico 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 v3 è stata spostata dalla versione beta pubblica alla disponibilità generale.

È stato rinominato un valore di enumerazione AdGroupFormat nella versione 3 per riflettere in modo più accurato il formato pertinente.

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

• I seguenti valori enum sono stati rimossi:

  Enum	Valori
  AdGroupFormat	AD_GROUP_FORMAT_ACTION

• Sono stati aggiunti i seguenti valori di enum:

  Enum	Valori
  AdGroupFormat	AD_GROUP_FORMAT_RESPONSIVE
  SdfVersion	SDF_VERSION_7

v2

• Sono stati aggiunti i seguenti valori di enum:

  Enum	Valori
  SdfVersion	SDF_VERSION_7

2 ottobre 2023

Nuove funzionalità

Rilasciata la versione 3 in versione beta pubblica, che include le seguenti modifiche:

• La possibilità di gestire completamente gli elenchi di località di prossimità, che consente 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 la procedura indicata nella nostra guida alla migrazione per eseguire la migrazione dalla versione 2 alla versione 3.

Aggiunto il supporto per tre nuovi valori LineItemType, uno nuovo YoutubeAndPartnersBiddingStrategyType e uno nuovo PartnerCostType nelle versioni 2 e 3.

v3

• Sono stati aggiunti i seguenti metodi:

  Servizio	Metodi
  advertisers.adGroupAds	recupero list
  advertisers.adGroups	bulkListAdGroupAssignedTargetingOptions recupero list
  advertisers.adGroups.targetingTypes.assignedTargetingOptions	recupero list
  customBiddingAlgorithms	uploadRules
  customBiddingAlgorithms.rules	creazione recupero list

• Sono stati rimossi i seguenti metodi:

  Servizio	Metodi
  advertisers.manualTriggers	attiva crea disattivare get list patch
  advertisers.youtubeAdGroupAds	get list
  advertisers.youtubeAdGroups	bulkListAdGroupAssignedTargetingOptions get list
  advertiser.youtubeAdGroups.targetingTypes.assignedTargetingOptions	get list

• Il seguente comportamento del metodo è cambiato:

  Metodo	Modifiche
  advertisers.locationLists.create	Ora supporta la creazione di TARGETING_LOCATION_TYPE_PROXIMITY risorse LocationList.
  advertisers.locationLists.patch	Ora supporta l'aggiornamento di TARGETING_LOCATION_TYPE_PROXIMITY risorse LocationList.
  advertisers.locationLists.assignedLocations.bulkEdit	Ora supporta la modifica collettiva delle risorse AssignedLocation in TARGETING_LOCATION_TYPE_PROXIMITY risorse LocationList.
  advertisers.locationLists.assignedLocations.create	Ora supporta la creazione di risorse AssignedLocation in TARGETING_LOCATION_TYPE_PROXIMITY risorse LocationList.

• Sono stati aggiunti i seguenti parametri di query:

  Metodo	Parametri
  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 di 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 di 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à

Aggiunto il supporto per due piattaforme di scambio e due nuovi tipi di strategie di offerta YouTube e partner.

È stato aggiunto un nuovo campo effectiveContentCategory agli elementi pubblicitari YouTube & Partners per mostrare l'elemento YoutubeAndPartnersContentCategory utilizzato dall'elemento pubblicitario quando consideri i valori assegnati sia a livello di inserzionista che a livello 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 di 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 File di dati strutturati (SDF) v6 nelle versioni 1 e 2.

v2

• Sono stati aggiunti i seguenti valori di enum:

  Enum	Valori
  SdfVersion	SDF_VERSION_6

v1

• Sono stati aggiunti i seguenti valori di 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 deprecato excludeFirstPartyAudience è impostato sutrue. Il campo excludeFirstPartyAudience verrà ritirato e impostato su false dopo il 25 marzo 2023.

v2

• Sono stati aggiunti i seguenti valori di enum:

  Enum	Valori
  LineItemWarningMessage	DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

v1

• Sono stati aggiunti i seguenti valori di 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 risorse dei gruppi di annunci di YouTube. Abbiamo anche aggiunto nuovi tipi di targeting recuperabili utilizzati a livello di gruppi di annunci di YouTube. Per ulteriori informazioni, leggi la nostra nuova pagina della guida al recupero delle risorse di YouTube e partner.

Aggiunto il supporto per altre quattro piattaforme di scambio nelle versioni 1 e 2.

v2

• Sono stati aggiunti i seguenti metodi:

  Servizio	Metodi
  advertisers.youtubeAdGroupAds	recupero list
  advertisers.youtubeAdGroups	bulkListAdGroupAssignedTargetingOptions recupero list
  advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions	recupero 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 di 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 di enum:

  Enum	Valori
  Piattaforma di scambio pubblicitario	EXCHANGE_APPLOVIN EXCHANGE_CONNATIX EXCHANGE_JCD EXCHANGE_PLACE_EXCHANGE

6 dicembre 2022

Nuove funzionalità

v2 passata dalla versione 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 è impostato solo per le opzioni di targeting assegnate dei tipi di targeting assegnati tramite enum. Il valore alias è il valore enum pertinente come stringa.

È stato aggiunto un nuovo campo billingConfig alla risorsa Advertiser.

Aggiunto il supporto per il recupero degli elementi pubblicitari over-the-top YouTube e partner, identificati da tre nuovi valori LineItemType.

Dimensioni massime della pagina aumentate a 200 per numerosi metodi list nelle versioni 1 e 2. Le dimensioni predefinite della pagina rimangono invariate.

v2

• Sono stati aggiunti i seguenti campi:

  Risorsa	Campo/i
  Inserzionista	billingConfig
  AssignedTargetingOption	assignedTargetingOptionIdAlias

• Sono stati aggiunti i seguenti valori di 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	Nuova dimensione massima 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	Nuova dimensione massima 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 della versione 2:

• Le opzioni di targeting assegnate dei tipi di targeting assegnati mediante valori enum nella versione v2 non sono state rimosse o recuperate utilizzando assignedTargetingOptionId e prevedevano invece che gli utenti utilizzino il valore enum. Con questo aggiornamento, le opzioni di targeting assegnate possono essere rimosse o recuperate utilizzando il valore assignedTargetingOptionId o il valore enum, identificati dal nuovo campo assignedTargetingOptionIdAlias nella risorsa AssignedTargetingOption.
• La richiesta bulkUpdate di elemento pubblicitario non utilizzava correttamente il parametro di richiesta advertisersId, perciò è stato restituito 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 pubblicitario principale InsertionOrder.

È stato introdotto il supporto della scrittura del targeting degli ordini di inserzione parziale 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	creazione elimina
  advertisers.lineItems	duplicato

v1

Non sono state aggiunte nuove funzionalità alla v1.

20 settembre 2022

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 la modifica e il recupero del targeting assegnato in più elementi pubblicitari con una singola richiesta.
• Un nuovo metodo bulkUpdate che consente agli utenti di aggiornare entityStatus di più elementi pubblicitari in una singola richiesta.
• La nuova logica di targeting richiede l'assegnazione e il recupero delle risorse AssignedTargetingOption di un sottoinsieme di tipi di targeting utilizzando valori di enum al posto degli ID opzioni di targeting recuperati utilizzando il servizio targetingTypes.targetingOptions.

Segui la procedura nella nostra guida alla migrazione per eseguire la migrazione dalla versione 1 alla versione 2.

Aggiunto il supporto per tre nuove piattaforme di scambio nella versione 1.

Nuove funzionalità

v2

Di seguito è riportato un elenco delle modifiche tra le versioni 1 e 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	Nome nuovo metodo
  inserzionisti	bulkEditAdvertiserAssignedTargetingOptions bulkListAdvertiserAssignedTargetingOptions	editAssignedTargetingOptions listAssignedTargetingOptions
  advertisers.campaigns	bulkListCampaignAssignedTargetingOptions	listAssignedTargetingOptions
  advertisers.insertionOrders	bulkListInsertionOrderAssignedTargetingOptions	listAssignedTargetingOptions
  partners	bulkEditPartnerAssignedTargetingOptions	editAssignedTargetingOptions

• Le risorse AssignedTargetingOption dei seguenti tipi di targeting utilizzano le enum per l'assegnazione del targeting nella versione 2. Anche il campo assignedTargetingOptionId per AssignedTargetingOption risorse di questi tipi di targeting è stato aggiornato nella versione 2 per utilizzare versioni in formato stringa dei valori enum:

  Tipo di targeting	Tipo 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	piattaforma di scambio pubblicitario
  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 resi obbligatori nella versione 2:

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

• I seguenti valori di enum sono stati aggiunti nella versione 2:

  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

• I seguenti valori di enum sono stati aggiunti nella versione 1:

  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à dei parametri di query filter per il metodo advertisers.creatives.list che consente all'utente di recuperare solo le creatività con un elemento updateTime precedente o successivo a un determinato timestamp.

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	creazione editGuaranteedOrderReadAccessors recupero list cerotto
  inventorySources	creazione editInventorySourceReadWriteAccessors cerotto

• Sono stati aggiunti i seguenti campi:

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

• Sono stati aggiunti i seguenti valori di enum:

  Enum	Valori
  SdfVersion	SDF_VERSION_5_5

• I seguenti metodi dell'elenco sono ora filtrabili in base alle seguenti proprietà:

  Metodo	Campo/i
  advertisers.creatives.list	updateTime

31 marzo 2022

Aggiunto il supporto per il recupero e l'impostazione del targeting per durata dei contenuti, tipo di stream e genere.

Aggiunto il campo billableOutcome all'oggetto InsertionOrder.

È stato introdotto il campo raiseBidForDeals all'oggetto MaximizeSpendBidStrategy, che consente agli utenti di impostare se la strategia di offerta deve applicare 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 di enum:

  Enum	Valori
  TargetingType	TARGETING_TYPE_CONTENT_DURATION TARGETING_TYPE_CONTENT_GENRE TARGETING_TYPE_CONTENT_STREAM_TYPE

2 febbraio 2022

Aggiunto il supporto per creare, aggiornare e modificare i membri di determinate risorse Customer Match FirstAndThirdPartyAudience. La pagina Carica i segmenti di pubblico Customer Match nella nuova guida Usa segmenti di pubblico contiene informazioni dettagliate su come usare queste nuove funzionalità.

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

È stata aggiunta la possibilità di recuperare e impostare se un elemento pubblicitario abbia come target automaticamente le 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	Metodi
  firstAndThirdPartyAudiences	creazione editCustomerMatchMembers cerotto

• Sono stati aggiunti i seguenti campi:

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

8 dicembre 2021

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 di enum:

  Enum	Valori
  TargetingType	TARGETING_TYPE_AUDIO_CONTENT_TYPE

8 novembre 2021

Aggiunto il supporto completo per la gestione degli algoritmi di offerte personalizzate e dei relativi script. Include:

• Funzioni per creare nuove e aggiornare esistenti customBiddingAlgorithms.
• La possibilità di caricare script tramite il processo di recupero di una località delle risorse disponibile per poi caricare il file in quella posizione.
• Un nuovo servizio customBiddingAlgorithms.scripts da recuperare e creare customBiddingScripts.

Alla guida Gestione degli elementi pubblicitari è stata aggiunta una nuova pagina Implementare le offerte personalizzate che descrive la procedura per creare un algoritmo di offerte personalizzate, caricare uno script e assegnare l'algoritmo delle offerte personalizzate come strategia di offerta di un elemento pubblicitario.

Aggiunto il supporto per la versione più recente di SDF, v5.4, tramite l'aggiunta di un valore di enumerazione SdfVersion.

Nuove funzionalità

• Sono stati aggiunti i seguenti metodi:

  Servizio	Metodi
  customBiddingAlgorithms	creazione cerotto uploadScript
  customBiddingAlgorithms.scripts	creazione recupero list
  contenuti multimediali	carica

• Sono stati aggiunti i seguenti valori di enum:

  Enum	Valori
  SdfVersion	SDF_VERSION_5_4

14 settembre 2021

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 di TARGETING_TYPE_BUSINESS_CHAIN e TARGETING_TYPE_POI disponibili utilizzando targetingTypes.targetingOptions.search, in quanto non è possibile recuperarle con i metodi targetingTypes.targetingOptions.get o targetingTypes.targetingOptions.list.

Sono stati introdotti nuovi campi sharedAdvertiserIds e customBiddingAlgorithmState nella risorsa dell'algoritmo di offerte personalizzate e aggiunto il supporto per il tipo di algoritmo delle offerte personalizzate 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 di 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 dell'elenco sono ora filtrabili in base alle seguenti proprietà:

  Metodo	Campo/i
  customBiddingAlgorithms.list	customBiddingAlgorithmState

4 agosto 2021

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 delle opzioni di targeting di inserzionista, campagna, ordine di inserzione ed elemento pubblicitario assegnati 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 di enum:

  Enum	Valori
  TargetingType	TARGETING_TYPE_OMID

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

  Metodo	Nuova dimensione massima 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

Lanciato il servizio advertisers.invoices, che consente agli utenti di:

• recuperare le fatture emesse a un inserzionista nel corso di un determinato mese.
• cercare il codice valuta utilizzato da un inserzionista durante un determinato mese.

Aggiunto il campo campaignBudgets alla risorsa della campagna. I segmenti di budget degli ordini di inserzione possono essere collegati a un budget della campagna, limitando la somma del budget dei segmenti associati all'importo totale del budget della campagna.

Aggiunto il supporto per il targeting della posizione dei contenuti nativi nel nuovo tipo di targeting TARGETING_TYPE_NATIVE_CONTENT_POSITION.

È stato introdotto un nuovo campo prismaEnabled alla risorsa dell'inserzionista, che consente agli utenti di abilitare l'integrazione con lo strumento Prisma di Mediaocean.

È stato attivato il supporto del 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 di enum:

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

• I seguenti valori di enum sono ora validi per i seguenti campi:

  Risorsa	Tecnico	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 degli elementi pubblicitari utilizzando la risorsa per il targeting. Le nuove proprietà filter abilitate per il metodo dell'elenco di elementi pubblicitari consentono all'utente di recuperare solo gli elementi pubblicitari che utilizzano canali specifici o elenchi di parole chiave escluse nel targeting.

Nuove funzionalità

• Sono stati aggiunti i seguenti campi:

  Risorsa	Campo/i
  Canale	negativelyTargetedLineItemCount positivelyTargetedLineItemCount
  NegativeKeywordList	targetedLineItemCount

• I seguenti metodi dell'elenco sono ora filtrabili in base alle seguenti proprietà:

  Metodo	Campo/i
  advertisers.lineItems.list	targetedChannelId targetedNegativeKeywordListId

30 marzo 2021

È stato aggiunto un nuovo metodo al servizio dell'elemento pubblicitario che genera un elemento pubblicitario con configurazioni predefinite. Questi valori predefiniti si basano sul tipo di elemento pubblicitario specificato, sulle impostazioni e sul targeting assegnato dell'ordine di inserzione principale.

Abilitazione del recupero del targeting delle campagne tramite un nuovo servizio di targeting delle campagne e un metodo aggiuntivo per gli elenchi collettivi.

È stato esteso il targeting per app per consentire il targeting delle app su più piattaforme.

Apportate più modifiche ai servizi advertisers.channels.sites, partners.channels.sites e advertisers.negativeKeywordLists.negativeKeywords per semplificare la gestione dei contenuti del canale 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 impone 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 su una singola pagina di una risposta di elenco di siti o di elenco di parole chiave escluse.

Nuove funzionalità

• Sono stati aggiunti i seguenti metodi:

  Servizio	Metodi
  advertisers.campaigns	bulkListCampaignAssignedTargetingOptions
  advertisers.campaigns.targetingTypes.assignedTargetingOptions	recupero 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	Nuova dimensione massima della pagina
  advertisers.channels.sites.list	100	10000
  advertisers.negativeKeywordLists.negativeKeywords.list	100	1000
  partners.channels.sites.list	100	10000

Deprecazioni

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

  Enum	Valori
  PartnerRevenueModelMarkupType	PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP

24 febbraio 2021

Sono stati introdotti un nuovo servizio di targeting per gli ordini di inserzione e un metodo aggiuntivo per gli elenchi collettivi che consentono di recuperare il targeting assegnato agli ordini di inserzione. È stata espansa la risorsa della creatività, aggiungendo campi creatività solo di output da utilizzare da creatività audio di terze parti. Sono stati aggiunti nuovi tipi di obiettivi di rendimento che possono essere utilizzati da risorse di ordine di inserzione e campagna.

Nuove funzionalità

• Sono stati aggiunti i seguenti metodi:

  Servizio	Metodi
  advertisers.insertionOrders	bulkListInsertionOrderAssignedTargetingOptions
  advertisers.insertionOrders.targetingTypes.assignedTargetingOptions	ricevi elenco

• Sono stati aggiunti i seguenti campi:

  Risorsa	Campo/i
  Creatività	mp3Audio oggAudio

• Sono stati aggiunti i seguenti valori di 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 abilitato il recupero e la gestione di ordini di inserzione TV ed elementi pubblicitari over-the-top tramite l'introduzione di un nuovo campo SelectionOrderType e di un nuovo valore di enum LineItemType. Aggiunto il supporto per gli elementi pubblicitari di app mobile tramite un campo elemento pubblicitario mobileApp. Supporto esteso per piattaforme di scambio, segmenti di pubblico Google e SDF tramite valori di enumerazione aggiuntivi. È stata introdotta la funzionalità di filtrare e ordinare i valori di advertisers.list in base all'orario dell'ultimo aggiornamento.

Nuove funzionalità

• Sono stati aggiunti i seguenti campi:

  Risorsa	Campo/i
  InsertionOrder	insertionOrderType
  LineItem	mobileApp

• Sono stati aggiunti i seguenti valori di 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 per l'elenco possono ora essere ordinati e filtrati in base ai campi seguenti:

  Metodo	Campo/i
  inserzionisti	updateTime

4 dicembre 2020

È stata aggiunta la possibilità di cercare le opzioni di targeting per regioni geografiche e di filtrare più risultati dei metodi di elenco di risorse in base all'ultimo aggiornamento. È stato introdotto un nuovo LineItemNoticeMessage per informare gli utenti quando un elemento pubblicitario utilizza il targeting geografico deprecato.

Nuove funzionalità

• Sono stati aggiunti i seguenti metodi:

  Servizio	Metodi
  targetingTypes.targetingOptions	cerca

• Sono stati aggiunti i seguenti valori di enum:

  Enum	Valori
  Piattaforma di scambio pubblicitario	EXCHANGE_SUPERSHIP
  LineItemWarningMessage	TARGETING_DEPRECATED_GEO_TARGET

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

  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 opzioni di espansione del targeting che, se impostate, possono espandere il targeting di un elemento pubblicitario in modo da includere utenti simili a quelli nei segmenti di pubblico di destinazione. Sono stati aggiunti campi ID segmento personalizzati 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	Metodi
  advertisers.manualTriggers	attiva crea disattiva ricevi 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 di enum:

  Enum	Valori
  LineItemFlightDateType	LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER

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

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

12 ottobre 2020

Sono stati introdotti messaggi di avviso recuperabili nella risorsa dell'elemento pubblicitario e un tipo di obiettivo di rendimento della percentuale di clic (CTR). warningMessages aggiunto come campo filtrabile durante l'elenco 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 di enum:

  Enum	Valori
  PerformanceGoalType	PERFORMANCE_GOAL_TYPE_CTR

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

  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
  Inserzionisti.Corpo della risposta di audit	adGroupCriteriaCount campaignCriteriaCount channelsCount negativeKeywordListsCount negativelyTargetedChannelsCount

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

  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

Lanciati nuovi servizi di gestione utenti e di targeting per partner e partner. Introduzione di strumenti per aiutare gli utenti a evitare proattivamente il raggiungimento dei limiti relativi alle entità dell'account. Aggiunto il supporto per gli elementi pubblicitari audio e l'utilizzo di algoritmi di offerte personalizzate nelle strategie di offerta relative agli elementi pubblicitari e all'ordine di inserzione.

Nuove funzionalità

• Sono stati aggiunti i seguenti servizi:

  Servizio	Metodi
  customBiddingAlgorithms	ricevi elenco
  partner	bulkEditPartnerAssignedTargetingOptions ricevi elenco
  partners.targetingTypes.assignedTargetingOptions	crea elimina ricevi elenco
  utenti	bulkEditAssignedUserRoles crea elimina ricevi elenco patch

• Sono stati aggiunti i seguenti metodi:

  Servizio	Metodi
  inserzionisti	controllo

• Sono stati aggiunti i seguenti campi:

  Risorsa	Campo/i
  MaximizeSpendBidStrategy	customBiddingAlgorithmId
  PerformanceGoalBidStrategy	customBiddingAlgorithmId

• Sono stati aggiunti i seguenti valori di enum:

  Enum	Valori
  BiddingStrategyPerformanceGoalType	BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO
  LineItemType	LINE_ITEM_TYPE_AUDIO_DEFAULT

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

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

• I seguenti ambiti sono stati aggiunti da utilizzare per i seguenti servizi:

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

24 giugno 2020

Lanciato un piccolo aggiornamento aggiungendo un metodo di creazione per i canali di partner e inserzionisti, nuovi campi FirstAndThirdPartyAudience e altri valori di enumerazione della piattaforma.

Nuove funzionalità

• Sono stati aggiunti i seguenti servizi:

  Servizio	Metodi
  advertisers.channels	crea
  partners.channels	crea

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

  Enum	Valori
  Piattaforma di scambio pubblicitario	EXCHANGE_OPEN8 EXCHANGE_TRITON EXCHANGE_UNRULYX

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

  Metodo	Campo/i
  advertisers.creatives.list	creativeId

2 giugno 2020

È stata introdotta la possibilità di creare, applicare patch e compilare un sottoinsieme di entità disponibili per il targeting nonché modificare il targeting a livello di inserzionista per tre tipi di targeting: canale, esclusione di etichette contenuti digitali ed esclusione di categorie sensibili.

Nuove funzionalità

• Sono stati aggiunti i seguenti servizi:

  Servizio	Metodi
  advertisers.channels.sites	bulkEdit crea elimina elenco
  advertisers.locationLists.assignedLocations	bulkEdit crea elimina elenco
  advertisers.negativeKeywordLists.negativeKeywords	bulkEdit crea elimina elenco
  advertisers.targetingTypes.assignedTargetingOptions	crea elimina ricevi elenco
  inventorySourceGroups.assignedInventorySources	bulkEdit crea elimina elenco
  partners.channels.sites	bulkEdit crea elimina elenco

• Sono stati aggiunti i seguenti metodi:

  Servizio	Metodi
  inserzionisti	bulkEditAdvertiserAssignedTargetingOptions bulkListAdvertiserAssignedTargetingOptions
  advertisers.channels	patch
  advertisers.locationLists	crea patch
  advertisers.negativeKeywordLists	crea elimina patch
  inventorySourceGroups	crea elimina patch
  partners.channels	patch

• Sono stati aggiunti i seguenti campi:

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

27 aprile 2020

Lanciato un ampio set di funzionalità, ampliando l'ambito dell'API oltre SDF. Aggiunta la gestione di base delle risorse che consente di creare, recuperare, aggiornare ed eliminare entità come inserzionisti, campagne, ordini di inserzione, elementi pubblicitari e creatività. Le nuove funzionalità consentono inoltre di modificare il targeting a livello di elemento pubblicitario.

Nuove funzionalità

Sono stati aggiunti i seguenti servizi:

Servizio	Metodi
inserzionisti	crea elimina ricevi elenco patch
advertisers.assets	carica
advertisers.campaigns	crea elimina ricevi elenco patch
advertisers.channels	ricevi elenco
advertisers.creatives	crea elimina ricevi elenco patch
advertisers.insertionOrders	crea elimina ricevi elenco patch
advertisers.lineItems	bulkEditLineItemAssignedTargetingOptions bulkListLineItemAssignedTargetingOptions crea elimina ricevi elenco patch
advertisers.lineItems.targetingTypes.assignedTargetingOptions	crea elimina ricevi elenco
advertisers.locationLists	ricevi elenco
advertisers.negativeKeywordLists	ricevi elenco
combinedAudiences	ricevi elenco
customLists	ricevi elenco
firstAndThirdPartyAudiences	ricevi elenco
floodlightGroups	ricevi patch
googleAudiences	ricevi elenco
inventorySourceGroups	ricevi elenco
inventorySources	ricevi elenco
partners.channels	ricevi elenco
partners.channels	ricevi elenco

9 marzo 2020

Lanciata l'API Display & Video 360 v1. Questa è la versione iniziale dell'API.

Problemi noti

Nessuna.