In questa pagina sono disponibili le note di rilascio per le campagne display e l'API Video 360.
Versione API più recente: v3
15 agosto 2024
Nuove funzionalità
Aggiunto il supporto per il tipo di Netflix Exchange
.
v3
Sono stati aggiunti i seguenti valori enum:
Enum Valori Piattaforma EXCHANGE_NETFLIX
v2
Sono stati aggiunti i seguenti valori enum:
Enum Valori Piattaforma EXCHANGE_NETFLIX
15 luglio 2024
Nuove funzionalità
È stato aggiunto il supporto per il download dei file di dati strutturati degli elementi pubblicitari e dei gruppi di annunci in Formato QA nella versione 3.
v3
Sono stati aggiunti i seguenti campi:
Risorsa Campo/i IdFilter Sono stati aggiunti i seguenti valori enum:
Enum Valori FileType FILE_TYPE_AD_GROUP_QA
FILE_TYPE_LINE_ITEM_QA
17 giugno 2024
Nuove funzionalità
È stato aggiunto il supporto per la gestione del targeting per parole chiave assegnato a livello di inserzionista.
È stato aggiunto un nuovo campo optimizationObjective
all'ordine di inserzione
risorsa. optimizationObjective
è disponibile solo per i clienti inclusi nella lista consentita.
v3
Sono stati aggiunti i seguenti campi:
Risorsa Campo/i InsertionOrder I seguenti metodi ora supportano i seguenti tipi di targeting:
Tipo di targeting Metodi TARGETING_TYPE_KEYWORD advertisers.editAssignedTargetingOptions
advertisers.listAssignedTargetingOptions
advertisers.targetingType.assignedTargetingOptions.create
advertisers.targetingType.assignedTargetingOptions.delete
v2
I seguenti metodi ora supportano i seguenti tipi di targeting:
Tipo di targeting Metodi TARGETING_TYPE_KEYWORD advertisers.editAssignedTargetingOptions
advertisers.listAssignedTargetingOptions
advertisers.targetingType.assignedTargetingOptions.create
advertisers.targetingType.assignedTargetingOptions.delete
30 maggio 2024
Nuove funzionalità
È stato aggiunto il supporto per i file di dati strutturati (SDF) versione 7.1.
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à
Aggiunto il supporto per nuovi tipi di KPI, piattaforme di scambio e piattaforme di app.
v3
Sono stati aggiunti i seguenti campi:
Risorsa Campo/i KPI Sono stati aggiunti i seguenti valori enum:
Enum Valori AppPlatform APP_PLATFORM_LG_TV
APP_PLATFORM_VIZIO_TV
Piattaforma EXCHANGE_DRAX
KpiType KPI_TYPE_CPCL
KPI_TYPE_CPCV
KPI_TYPE_CPV
KPI_TYPE_CUSTOM_IMPRESSION_VALUE_OVER_COST
KPI_TYPE_MAXIMIZE_PACING
KPI_TYPE_TOS10
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM
v2
Sono stati aggiunti i seguenti valori enum:
Enum Valori AppPlatform APP_PLATFORM_LG_TV
APP_PLATFORM_VIZIO_TV
Piattaforma 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.
v3
Sono stati aggiunti i seguenti campi:
Risorsa Campo/i firstAndThirdPartyAudiences.editCustomerMatchMembers Sono stati aggiunti i seguenti valori enum:
Enum Valori Piattaforma EXCHANGE_ADMOST_GBID
EXCHANGE_APPLOVIN_GBID
EXCHANGE_CHARTBOOST_GBID
EXCHANGE_FYBER_GBID
EXCHANGE_TOPON_GBID
EXCHANGE_UNITY_GBID
v2
Sono stati aggiunti i seguenti campi:
Risorsa Campo/i firstAndThirdPartyAudiences.editCustomerMatchMembers Sono stati aggiunti i seguenti valori enum:
Enum Valori Piattaforma 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 una nuova
Servizio floodlightGroups.floodlightActivities
.
È stato aggiunto un nuovo campo che indica se YouTube e Elemento pubblicitario partner include l'inventario di Google TV nel targeting.
È stato aggiunto un nuovo campo per inoltrare l'ora dell'ultimo accesso per un Display & Video a 360° utente.
v3
Sono stati aggiunti i seguenti metodi:
Servizio Metodi floodlightGroups.floodlightActivities Sono stati aggiunti i seguenti campi:
Risorsa Campo/i Utente YoutubeAndPartnersInventorySourceConfig
v2
Sono stati aggiunti i seguenti metodi:
Servizio Metodi floodlightGroups.floodlightActivities Sono stati aggiunti i seguenti campi:
Risorsa Campo/i Utente YoutubeAndPartnersInventorySourceConfig
14 novembre 2023
Nuove funzionalità
È stato aggiunto il supporto per trasmettere il consenso degli utenti finali durante il caricamento di Customer Match membri del pubblico in tutte le versioni live.
v3
Sono stati aggiunti i seguenti campi:
Risorsa Campo/i ContactInfoList MobileDeviceIdList
v2
Sono stati aggiunti i seguenti campi:
Risorsa Campo/i ContactInfoList MobileDeviceIdList
31 ottobre 2023
Nuove funzionalità
La versione 3 è stata spostata dalla versione beta pubblica alla disponibilità generale.
Nella versione 3 è stato rinominato un valore enum AdGroupFormat
in modo più accurato
in modo che riflettano il formato pertinente.
È stato aggiunto il supporto per i file di dati strutturati v7 con l'aggiunta del parametro
Valore enum SDF_VERSION_7
in v2 e v3.
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'uso del
advertisers.locationLists.assignedLocations
servizio da creare ed elimina le località assegnate aTARGETING_LOCATION_TYPE_PROXIMITY
Risorse diLocationList
. - Un nuovo campo booleano
enableOptimizedTargeting
, che sostituisce il campotargetingExpansionLevel
nelTargetingExpansionConfig
. - Il requisito del campo
billingConfig
nellaAdvertiser
, che deve essere inclusa quando creiadvertisers.create
e una nuovabillingConfig
nel campoPartner
risorsa. - Nuove risorse
AdGroup
eAdGroupAd
che sostituiscono le risorseYoutubeAdGroup
eYoutubeAdGroupAd
nella v2.
Per eseguire la migrazione dalla versione 2 alla versione 2, segui i passaggi indicati nella guida alla migrazione. v3.
È stato aggiunto il supporto di tre nuovi valori LineItemType
, uno nuovo
YoutubeAndPartnersBiddingStrategyType
e una nuova
PartnerCostType
nelle versioni v2 e v3.
v3
Sono stati aggiunti i seguenti metodi:
Servizio Metodi advertisers.adGroupAds advertisers.adGroups advertisers.adGroups.targetingTypes.assignedTargetingOptions customBiddingAlgorithms customBiddingAlgorithms.rules 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 seguente comportamento del metodo è cambiato:
Metodo Modifiche advertisers.locationLists.create Ora è supportata la creazione di TARGETING_LOCATION_TYPE_PROXIMITY
risorseLocationList
.advertisers.locationLists.patch Ora è supportato l'aggiornamento di TARGETING_LOCATION_TYPE_PROXIMITY
risorseLocationList
.advertisers.locationLists.assignedLocations.bulkEdit Ora è supportata la modifica collettiva delle risorse AssignedLocation
inTARGETING_LOCATION_TYPE_PROXIMITY
LocationList
risorse.advertisers.locationLists.assignedLocations.create Ora è supportata la creazione di risorse AssignedLocation
inTARGETING_LOCATION_TYPE_PROXIMITY
risorseLocationList
.Sono stati aggiunti i seguenti parametri di query:
Metodo Parametri inventorySources.get I seguenti campi sono stati resi obbligatori:
Risorsa Campo/i Inserzionista Sono stati aggiunti i seguenti campi:
Risorsa Campo/i BiddingStrategy InsertionOrder Partner TargetingExpansionConfig YoutubeAndPartnersSettings YoutubeAndPartnersInventorySourceConfig I seguenti campi sono stati rimossi:
Risorsa Campo/i InsertionOrder performanceGoal
billableOutcome
TargetingExpansionConfig excludeFirstPartyAudience
targetingExpansionLevel
YoutubeAndPartnersSettings biddingStrategy
thirdPartyMeasurementSettings
YoutubeAndPartnersInventorySourceConfig includeYoutubeSearch
includeYoutubeVideos
Sono stati aggiunti i seguenti valori enum:
Enum Valori CustomBiddingAlgorithmType RULE_BASED
LineItemType LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME
LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW
PartnerCostType PARTNER_COST_TYPE_SCIBIDS_FEE
ReadinessState READINESS_STATE_EVALUATION_FAILURE
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV
Sono stati rimossi i seguenti valori enum:
Enum Valori LineItemWarningMessage DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
v2
Sono stati aggiunti i seguenti valori enum:
Enum Valori LineItemType LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME
LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW
PartnerCostType PARTNER_COST_TYPE_SCIBIDS_FEE
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV
25 agosto 2023
Nuove funzionalità
Aggiunto il supporto per due piattaforme e due nuove piattaforme di scambio pubblicitario Partner tipi di strategia di offerta.
È stato aggiunto un nuovo campo effectiveContentCategory
a YouTube e
di Google Partners per mostrare
YoutubeAndPartnersContentCategory
utilizzata dall'elemento pubblicitario quando
prendendo in considerazione 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 I seguenti campi sono stati rimossi:
Risorsa Campo/i InventorySource subSitePropertyId
Sono stati aggiunti i seguenti valori enum:
Enum Valori Piattaforma 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 in v1 e v2.
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à
assegnate al campo warningMessages
di un elemento pubblicitario, se presenta
il campo excludeFirstPartyAudience
deprecato è impostato su
true
. Il campo excludeFirstPartyAudience
verrà ritirato
e impostato su false
dopo il 25 marzo 2023.
v2
Sono stati aggiunti i seguenti valori enum:
Enum Valori LineItemWarningMessage DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
v1
Sono stati aggiunti i seguenti valori enum:
Enum Valori LineItemWarningMessage DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
8 febbraio 2023
Nuove funzionalità
Aggiunta la possibilità di recuperare YouTubeAdGroup
e
YouTubeAdGroupAd
e il gruppo di annunci di YouTube
il targeting per risorse. Inoltre, abbiamo anche aggiunto nuove
Tipi di targeting recuperabili utilizzati nei gruppi di annunci di YouTube
livello. Leggi la nuova pagina della guida sul recupero di YouTube e Partner
Google Cloud per ulteriori informazioni.
Nelle versioni 1 e 2 è stato aggiunto il supporto di altre piattaforme di scambio.
v2
Sono stati aggiunti i seguenti metodi:
Servizio Metodi advertisers.youtubeAdGroupAds advertisers.youtubeAdGroups advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions Sono stati aggiunti i seguenti campi:
Servizio Metodi AssignedTargetingOption YoutubeAndPartnersSettings Sono stati aggiunti i seguenti valori enum:
Enum Valori Piattaforma EXCHANGE_APPLOVIN
EXCHANGE_CONNATIX
EXCHANGE_JCD
EXCHANGE_PLACE_EXCHANGE
LineItemType LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY
TargetingType TARGETING_TYPE_SESSION_POSITION
TARGETING_TYPE_YOUTUBE_CHANNEL
TARGETING_TYPE_YOUTUBE_VIDEO
v1
Sono stati aggiunti i seguenti valori enum:
Enum Valori Piattaforma EXCHANGE_APPLOVIN
EXCHANGE_CONNATIX
EXCHANGE_JCD
EXCHANGE_PLACE_EXCHANGE
6 dicembre 2022
Nuove funzionalità
La versione 2 è stata spostata dalla versione beta pubblica alla disponibilità generale.
È stato aggiunto un nuovo campo assignedTargetingOptionIdAlias
alla
AssignedTargetingOption
, che può essere utilizzata al posto della
assignedTargetingOptionId
durante il recupero e l'eliminazione del targeting.
Questo campo è impostato solo per le opzioni di targeting assegnate ai tipi di targeting che
vengono assegnati tramite enum. Il valore alias è il valore enum pertinente come stringa.
È stato aggiunto un nuovo campo billingConfig
alla
Advertiser
.
Aggiunto il supporto per il recupero di YouTube e gli elementi pubblicitari over-the-top del partner,
identificati da tre nuovi valori LineItemType
.
La dimensione massima della pagina è stata aumentata a 200 per numerosi metodi list
nelle v1 e v2. La
le dimensioni di pagina predefinite rimangono invariate.
v2
Sono stati aggiunti i seguenti campi:
Risorsa Campo/i Inserzionista AssignedTargetingOption Sono stati aggiunti i seguenti valori enum:
Enum Valori LineItemType LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP
La dimensione massima della pagina è stata aumentata per i seguenti metodi di elenco:
v1
La dimensione massima della pagina è stata aumentata per i seguenti metodi di elenco:
Problemi noti
Questo aggiornamento corregge i seguenti problemi noti nella versione 2:
- Opzioni di targeting assegnate dei tipi di targeting assegnate tramite enum
Impossibile rimuovere o recuperare i valori nella versione 2
usando
assignedTargetingOptionId
e si aspettava agli utenti di utilizzare il valore enum. Con questo aggiornamento, i criteri di targeting possono essere rimosse o recuperate utilizzandoassignedTargetingOptionId
o il valore enum, identificato da il nuovo campoassignedTargetingOptionIdAlias
nellaAssignedTargetingOption
. - La richiesta dell'elemento pubblicitario
bulkUpdate
non è stata utilizzata correttamente il parametro di richiestaadvertisersId
, restituendo un errore. Con questo aggiornamento, il metodo è stato corretto e il parametro di richiesta è stato rinominatoadvertisersId
peradvertiserId
.
27 ottobre 2022
Aggiunta la possibilità di duplicare un elemento pubblicitario esistente all'interno di quello principale
InsertionOrder
Introduzione del supporto in scrittura per il targeting per ordine di inserzione parziale per un sottoinsieme di
tipi di targeting con l'aggiunta di create
e
delete
alla
advertisers.insertionOrders.targetingTypes.assignedTargetingOptions
completamente gestito di Google Cloud.
Nuove funzionalità
v2
Sono stati aggiunti i seguenti metodi:
Servizio Metodi advertisers.insertionOrders.targetingTypes.assignedTargetingOptions advertisers.lineItems
v1
Non sono state aggiunte nuove funzionalità alla versione 1.
20 settembre 2022
È stata rilasciata la versione 2 in versione beta pubblica, che include le seguenti modifiche:
- È possibile recuperare i dati di YouTube e Elementi pubblicitari dei partner e relativo targeting
le impostazioni utilizzando i metodi
get
elist
nellaadvertisers.lineItems
eadvertisers.lineItems.targetingTypes.assignedTargetingOptions
servizi. - Due nuovi metodi di targeting collettivo nel servizio
advertisers.lineItems
che consentono la modifica e il recupero targeting assegnato a più elementi pubblicitari con un una singola richiesta. - Un nuovo metodo
bulkUpdate
che consente agli utenti di aggiornareentityStatus
di più elementi pubblicitari in un'unica richiesta. - Nuova logica di targeting che richiede
AssignedTargetingOption
le risorse di un sottoinsieme di tipi di targeting Assegnati e recuperati utilizzando valori enum anziché ID opzione di targeting recuperate utilizzando il serviziotargetingTypes.targetingOptions
.
Per eseguire la migrazione dalla versione 1 alla versione 1, segui i passaggi indicati nella guida alla migrazione v2.
Nella versione 1 è stato aggiunto il supporto di tre nuove piattaforme.
Nuove funzionalità
v2
Di seguito è riportato un elenco delle modifiche dalla v1 alla v2:
Nella versione 2 sono stati aggiunti i seguenti metodi:
Servizio Metodi advertisers.lineItems bulkEditAssignedTargetingOptions
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 metodo inserzionisti bulkEditAdvertiserAssignedTargetingOptions
bulkListAdvertiserAssignedTargetingOptions
advertisers.campaigns bulkListCampaignAssignedTargetingOptions listAssignedTargetingOptions advertisers.insertionOrders bulkListInsertionOrderAssignedTargetingOptions listAssignedTargetingOptions partner bulkEditPartnerAssignedTargetingOptions editAssignedTargetingOptions Le risorse
AssignedTargetingOption
dei seguenti tipi di targeting utilizzano le enum per l'assegnazione del targeting nella versione 2. Anche il campoassignedTargetingOptionId
per le risorseAssignedTargetingOption
di questi tipi di targeting è stato aggiornato nella versione 2 in modo da utilizzare versioni stringa dei valori enum:Tipo di targeting Tipo di enum TARGETING_TYPE_AGE_RANGE AgeRange TARGETING_TYPE_CONTENT_INSTREAM_POSITION ContentInstreamPosition TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION ContentOutstreamPosition TARGETING_TYPE_DEVICE_TYPE DeviceType TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION ContentRatingTier TARGETING_TYPE_ENVIRONMENT Ambiente TARGETING_TYPE_EXCHANGE Piattaforma 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 campi seguenti:
I seguenti campi sono stati rimossi nella versione 2:
I seguenti campi sono stati resi obbligatori nella versione 2:
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
Piattaforma EXCHANGE_DAX
EXCHANGE_FYBER
EXCHANGE_VISTAR
LineItemType LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE
ReservationType RESERVATION_TYPE_INSTANT_RESERVE
RESERVATION_TYPE_PETRA_VIRAL
SensitiveCategory SENSITIVE_CATEGORY_EMBEDDED_VIDEO
SENSITIVE_CATEGORY_LIVE_STREAMING_VIDEO
I seguenti valori enum sono stati rimossi nella versione 2:
Enum Valori LineItemFlightDateType LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER
LineItemWarningMessage APP_INSTALL_NO_CONVERSION_PIXEL
APP_INSTALL_NO_OPTIMAL_BIDDING_STRATEGY
CREATIVE_SIZE_NOT_IN_USE_FOR_TARGETED_DEALS
NO_CREATIVE_FOR_TARGETED_DEALS
NO_POSITIVE_AUDIENCE_LIST_TARGETED
TARGETING_DEPRECATED_GEO_TARGET
TARGETING_REVOKED_OR_CLOSED_USER_LIST
v1
Nella versione 1 sono stati aggiunti i seguenti valori enum:
Enum Valori Piattaforma EXCHANGE_DAX
EXCHANGE_FYBER
EXCHANGE_VISTAR
26 maggio 2022
È stata aggiunta la possibilità di creare risorse InventorySource
e
e gestire le risorse GuaranteedOrder
tramite
i metodi di scrittura del servizio inventorySources
e un nuovo
guaranteedOrders
.
È stato introdotto il campo modelReadiness
nella sezione
CustomBiddingAlgorithm
. Questo campo elenca l'idoneità
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
per recuperare solo le creatività con un updateTime
prima o dopo un determinato timestamp.
È stato aggiunto il supporto della versione più recente dell'SDF, v5.5, tramite la
aggiunta di un valore enum SdfVersion
.
Nuove funzionalità
Sono stati aggiunti i seguenti metodi:
Servizio Metodi guaranteedOrders inventorySources Sono stati aggiunti i seguenti campi:
Risorsa Campo/i CustomBiddingAlgorithm InventorySource Sono stati aggiunti i seguenti valori enum:
Enum Valori SdfVersion I seguenti metodi per gli elenchi sono ora filtrabili in base alle seguenti proprietà:
Metodo Campo/i advertisers.creatives.list
31 marzo 2022
Aggiunto il supporto per il recupero e l'impostazione del targeting su durata dei contenuti, tipo di stream, e gender.
È stato aggiunto il campo billableOutcome
a InsertionOrder
.
Ha introdotto il campo raiseBidForDeals
nella
MaximizeSpendBidStrategy
, che consente agli utenti di impostare se l'offerta
applica i prezzi minimi dell'inserzionista per i deal scelti come target.
Nuove funzionalità
Sono stati aggiunti i seguenti campi:
Risorsa Campo/i AssignedTargetingOption InsertionOrder MaximizeSpendBidStrategy TargetingOption Sono stati aggiunti i seguenti valori enum:
Enum Valori TargetingType
2 febbraio 2022
Aggiunto il supporto per creazione, aggiornamento e
modificare i membri di determinati Customer Match
FirstAndThirdPartyAudience
di risorse. La
Carica i segmenti di pubblico Customer Match nella nostra nuova
La guida all'utilizzo dei segmenti di pubblico spiega in dettaglio come usare queste nuove funzionalità.
Nuovo campo reservationType
introdotto in
InsertionOrder
e LineItem
Risorse che identificano se una risorsa è pubblicità programmatica garantita da tag
Garantiti o non garantiti.
Aggiunta la possibilità di recuperare e impostare se un elemento pubblicitario sceglie automaticamente come target
nuove piattaforme di scambio pubblicitario tramite un nuovo excludeNewExchanges
.
Oltre alle nuove funzionalità, i limiti di quota predefiniti sono stati raddoppiati.
Nuove funzionalità
Sono stati aggiunti i seguenti metodi:
Servizio Metodi firstAndThirdPartyAudiences Sono stati aggiunti i seguenti campi:
Risorsa Campo/i FirstAndThirdPartyAudience InsertionOrder LineItem
8 dicembre 2021
Aggiunto il supporto del targeting per tipo di contenuto audio nel tipo di targeting
TARGETING_TYPE_AUDIO_CONTENT_TYPE
Nuove funzionalità
Sono stati aggiunti i seguenti campi:
Risorsa Campo/i AssignedTargetingOption TargetingOption Sono stati aggiunti i seguenti valori enum:
Enum Valori TargetingType
8 novembre 2021
È stato aggiunto il supporto completo per la gestione degli algoritmi di offerte personalizzate e dei relativi script. È incluso quanto segue:
- Funzioni per creare nuovi contenuti ed aggiornare quelli esistenti
customBiddingAlgorithms
. - Possibilità di caricare script tramite il processo di il recupero di una località delle risorse disponibile e quindi caricamento del file in quella posizione.
- Un nuovo servizio
customBiddingAlgorithms.scripts
per recupera e creacustomBiddingScripts
.
Una nuova pagina Implementa le offerte personalizzate è stata aggiunta alla pagina la nostra guida alla gestione degli elementi pubblicitari, in cui viene descritta la il processo di creazione di un algoritmo delle offerte personalizzate, caricamento di uno script e assegnando l'algoritmo delle offerte personalizzate alla strategia di offerta dell'elemento pubblicitario.
È stato aggiunto il supporto della versione più recente dell'SDF, v5.4, tramite la
aggiunta di un valore enum SdfVersion
.
Nuove funzionalità
Sono stati aggiunti i seguenti metodi:
Servizio Metodi customBiddingAlgorithms customBiddingAlgorithms.scripts contenuti multimediali Sono stati aggiunti i seguenti valori enum:
Enum Valori SdfVersion
14 settembre 2021
Aggiunto il supporto del targeting di prossimità nei tipi di targeting
TARGETING_TYPE_BUSINESS_CHAIN
e
TARGETING_TYPE_POI
.
Aggiunta la possibilità di cercare
TARGETING_TYPE_BUSINESS_CHAIN
e
Opzioni di targeting di TARGETING_TYPE_POI
che utilizzano
targetingTypes.targetingOptions.search
, in quanto non possono essere
recuperato tramite targetingTypes.targetingOptions.get
o
targetingTypes.targetingOptions.list
metodi.
Sono stati introdotti nuovi dispositivi sharedAdvertiserIds
e
customBiddingAlgorithmState
alle offerte personalizzate
Risorsa per l'algoritmo e supporto aggiuntivo per
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 CustomBiddingAlgorithm TargetingOption Corpo della richiesta TargetingOptions.search Sono stati aggiunti i seguenti valori enum:
Enum Valori CustomBiddingAlgorithmType Piattaforma TargetingType I seguenti metodi per gli elenchi sono ora filtrabili in base alle seguenti proprietà:
Metodo Campo/i customBiddingAlgorithms.list
4 agosto 2021
Aggiunto il supporto per Open Measurement abilitato
targeting per inventario nel tipo di targeting.
TARGETING_TYPE_OMID
Aumento del numero massimo di opzioni di targeting assegnate che possono essere restituite
in una singola pagina di vari inserzionisti, campagne
targeting assegnato da ordine di inserzione ed elemento pubblicitario
metodi dell'elenco di opzioni utilizzando il parametro del metodo pageSize
.
Nuove funzionalità
Sono stati aggiunti i seguenti campi:
Risorsa Campo/i AssignedTargetingOption TargetingOption Sono stati aggiunti i seguenti valori enum:
Enum Valori TargetingType La dimensione massima della pagina è stata aumentata per i seguenti metodi di elenco:
Metodo Nuove dimensioni massime della pagina advertisers.campaigns.targetingTypes.assignedTargetingOptions.list 5000 advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.list 5000 advertisers.lineItems.targetingTypes.assignedTargetingOptions.list 5000 advertisers.targetingTypes.assignedTargetingOptions.list 5000
26 maggio 2021
Lanciato il servizio advertisers.invoices
, che consente di
utenti:
- recuperare le fatture emesse a un inserzionista nel corso di un determinato mese.
- Cercare il codice valuta utilizzato da un inserzionista durante un dato mese.
È stato aggiunto il campo campaignBudgets
alla campagna
risorsa. I segmenti di budget dell'ordine di inserzione possono essere collegati
un budget della campagna, limitando il budget complessivo
segmenti associati all'importo totale del budget della campagna.
Aggiunto il supporto per
targeting per posizione dei contenuti nativi nel nuovo
tipo di targeting TARGETING_TYPE_NATIVE_CONTENT_POSITION
.
Introdotto un nuovo campo prismaEnabled
per l'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
per la
Campo entityStatus
dell'inserzionista.
Nuove funzionalità
Sono stati aggiunti i seguenti metodi:
Servizio Metodi advertisers.invoices Sono stati aggiunti i seguenti campi:
Risorsa Campo/i Inserzionista AssignedTargetingOption TargetingOption Sono stati aggiunti i seguenti valori enum:
Enum Valori AssignedTargetingOption.Recency Piattaforma TargetingType I seguenti valori enum sono ora validi per i seguenti campi:
Risorsa Campo Valori Inserzionista entityStatus ENTITY_STATUS_PAUSED
29 aprile 2021
Sono stati aggiunti nuovi campi a Canale e
Risorse dell'elenco di parole chiave escluse che restituiscono il conteggio delle righe
che utilizzano la risorsa per il targeting. Nuova attivazione: filter
proprietà per il metodo di elenco degli elementi pubblicitari che consentono all'utente di
Recuperare solo elementi pubblicitari che utilizzano canali specifici o parole chiave escluse
elenchi nel targeting.
Nuove funzionalità
Sono stati aggiunti i seguenti campi:
Risorsa Campo/i Canale I seguenti metodi per gli elenchi 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 degli elementi pubblicitari che genera un dell'elemento pubblicitario con configurazioni predefinite. Questi valori predefiniti si basano sui specifico tipo di elemento pubblicitario, nonché le impostazioni e le targeting dell'ordine di inserzione principale.
Attivazione del recupero del targeting della campagna tramite una nuovo servizio di targeting per le campagne e metodo di elenco collettivo aggiuntivo.
Espansione del targeting per app per consentire il targeting delle app su più piattaforme.
Apportate più modifiche a advertisers.channels.sites
partners.channels.sites
e
advertisers.negativeKeywordLists.negativeKeywords
per i servizi
consentono una più facile gestione dei contenuti del canale e dell'elenco di parole chiave escluse. Questi
le modifiche includono:
- L'aggiunta di metodi
replace
, che consentono a un utente di sovrascrivere completamente contenuti esistenti di un canale o un elenco di parole chiave escluse. - La rimozione del requisito che prevede che nessuna
elementi in
createdSites
ocreatedNegativeKeywords
campi della modifica collettiva richieste. - L'aumento del numero massimo di articoli che possono essere restituiti per una singola pagina di un elenco di siti elencare le parole chiave escluse.
Nuove funzionalità
Sono stati aggiunti i seguenti metodi:
Sono stati aggiunti i seguenti campi:
Risorsa Campo/i AssignedTargetingOption.AppAssignedTargetingOptionDetails La dimensione massima della pagina è stata aumentata per i seguenti metodi di elenco:
Metodo Dimensioni massime della pagina precedenti Nuove dimensioni massime della pagina advertisers.channels.sites.list 100 10000 advertisers.negativeKeywordLists.negativeKeywords.list 100 1000 partners.channels.sites.list 100 10000
Deprecazioni
I seguenti valori 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
Ha introdotto un nuovo servizio di targeting per ordine di inserzione e metodo di elenco collettivo aggiuntivo che abilita il recupero il targeting assegnato agli ordini di inserzione. La risorsa della creatività è stata espansa, aggiungendo campi creatività che contengono solo l'output per l'utilizzo da parte di creatività audio di terze parti. Aggiunti nuovi tipi di obiettivi di rendimento per l'utilizzo da parte di ordine di inserzione e campagna Google Cloud.
Nuove funzionalità
Sono stati aggiunti i seguenti metodi:
Servizio Metodi advertisers.insertionOrders advertisers.insertionOrders.targetingTypes.assignedTargetingOptions Sono stati aggiunti i seguenti campi:
Risorsa Campo/i Creatività Sono stati aggiunti i seguenti valori enum:
Enum Valori ContentInstreamPosition PerformanceGoalType PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE
PERFORMANCE_GOAL_TYPE_CLICK_CVR
PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR
27 gennaio 2021
Recupero e gestione degli ordini di inserzione TV e della linea over-the-top attivati
elementi attraverso l'introduzione di un
nuovo campoInsertOrderType e un
nuovo valore enum di LineItemType. Aggiunto il supporto per l'app mobile
tramite un campo mobileApp
.
Piattaforma di scambio pubblicitario espansa, pubblico di Google e
Supporto dei SDF tramite valori enum aggiuntivi. Presentato
di filtrare e ordinare advertisers.list
valori in base all'ora dell'ultimo aggiornamento.
Nuove funzionalità
Sono stati aggiunti i seguenti campi:
Risorsa Campo/i InsertionOrder LineItem Sono stati aggiunti i seguenti valori enum:
Enum Valori Piattaforma GoogleAudienceType LineItemType SdfVersion I seguenti metodi di elenco possono ora essere ordinati e filtrati in base ai seguenti campi:
Metodo Campo/i inserzionisti
4 dicembre 2020
È stata aggiunta la possibilità di cercare Opzioni di targeting per regione geografica e filtro di più risorse. risultati del metodo elenco in base all'ora dell'ultimo aggiornamento. È stato introdotto un new LineItemWarningMessage per informare gli utenti quando un l'elemento pubblicitario utilizza un targeting geografico deprecato.
Nuove funzionalità
Sono stati aggiunti i seguenti metodi:
Servizio Metodi targetingTypes.targetingOptions Sono stati aggiunti i seguenti valori enum:
Enum Valori Piattaforma LineItemWarningMessage I seguenti metodi di elenco possono ora essere ordinati e filtrati in base ai seguenti campi:
Metodo Campo/i advertisers.campaigns.list advertisers.insertionOrders.list advertisers.lineItems.list
5 novembre 2020
Aggiunta la possibilità di creare, assegnare e attivare attivatori manuali che avviano gli elementi pubblicitari associati di Google Cloud. Sono state introdotte opzioni di espansione del targeting che, se impostato, puoi espandere il targeting di un elemento pubblicitario per includere utenti simili a a quelli dei segmenti di pubblico di destinazione. Campi ID segmento personalizzati aggiunti a DoubleVerify e Integral Ad Science utilizzati in targeting per la verifica di terze parti.
Nuove funzionalità
Sono stati aggiunti i seguenti servizi:
Servizio Metodi advertisers.manualTriggers Sono stati aggiunti i seguenti campi:
Risorsa Campo/i AssignedTargetingOption.DoubleVerify AssignedTargetingOption.IntegralAdScience LineItem LineItemFlight Sono stati aggiunti i seguenti valori enum:
Enum Valori LineItemFlightDateType Ora è possibile filtrare i seguenti metodi per gli elenchi in base ai seguenti campi:
Metodo Campo/i advertisers.lineItems.list
12 ottobre 2020
Sono stati introdotti messaggi di avviso di recupero dell'elemento pubblicitario
risorsa e un tipo di obiettivo di rendimento
percentuale di clic (CTR). Aggiunta
warningMessages
come campo filtrabile quando vengono elencati gli elementi pubblicitari.
Oltre alle nuove funzionalità, sono ora entrati in vigore nuovi limiti di quota e è disponibile una nuova documentazione sull'utilizzo delle richieste batch.
Nuove funzionalità
Sono stati aggiunti i seguenti campi:
Risorsa Campo/i LineItem Sono stati aggiunti i seguenti valori enum:
Enum Valori PerformanceGoalType Ora è possibile filtrare i seguenti metodi per gli elenchi in base ai campi seguenti:
Metodo Campo/i advertisers.lineItems.list
28 agosto 2020
Sono stati aggiunti nuovi campi alle risposte del metodo di controllo degli inserzionisti e nuovi campi filtrabili in vari metodi di elenco.
Nuove funzionalità
Sono stati aggiunti i seguenti campi:
Risorsa Campo/i Gruppo di risposta per inserzionisti.Audit Ora è possibile filtrare i seguenti metodi per gli elenchi in base ai campi seguenti:
Metodo Campo/i advertisers.list advertisers.campaigns.list advertisers.insertionOrders.list advertisers.lineItems.list targetingTypes.targetingOptions.list
4 agosto 2020
Lanciati nuovi servizi di gestione utenti, partner e targeting per partner. Introduzione di strumenti per aiutare gli utenti a evitare in modo proattivo il raggiungimento dei limiti previsti dalle entità dell'account. È stato aggiunto il supporto per gli elementi pubblicitari audio e l'utilizzo di algoritmi di offerte personalizzate nelle strategie di offerta per elementi pubblicitari e ordine di inserzione.
Nuove funzionalità
Sono stati aggiunti i seguenti servizi:
Servizio Metodi customBiddingAlgorithms partner partners.targetingTypes.assignedTargetingOptions utenti Sono stati aggiunti i seguenti metodi:
Servizio Metodi inserzionisti Sono stati aggiunti i seguenti campi:
Risorsa Campo/i MaximizeSpendBidStrategy PerformanceGoalBidStrategy Sono stati aggiunti i seguenti valori enum:
Enum Valori BiddingStrategyPerformanceGoalType LineItemType I seguenti metodi di elenco possono ora essere ordinati e filtrati in base ai seguenti campi:
Metodo Campo/i advertisers.lineItems.list Sono stati aggiunti i seguenti ambiti da utilizzare per i servizi seguenti:
Ambito Servizi https://www.googleapis.com/auth/display-video-user-management
24 giugno 2020
Abbiamo lanciato un piccolo aggiornamento con l'aggiunta di un metodo di creazione per i canali partner e inserzionista, nuovi campi FirstAndThirdPartyAudience e valori enum aggiuntivi della piattaforma di scambio.
Nuove funzionalità
Sono stati aggiunti i seguenti servizi:
Servizio Metodi advertisers.channels partners.channels Sono stati aggiunti i seguenti campi:
Risorsa Campo/i FirstAndThirdPartyAudience Sono stati aggiunti i seguenti valori enum:
Enum Valori Piattaforma Ora è possibile filtrare i seguenti metodi per gli elenchi in base ai campi seguenti:
Metodo Campo/i advertisers.creatives.list
2 giugno 2020
È stata introdotta la possibilità di creare, applicare patch e compilare un sottoinsieme di entità selezionabili come target e hai aggiunto la possibilità di modificare il targeting a livello di inserzionista per tre tipi di targeting: canale, esclusione di etichette per contenuti digitali ed esclusione di categorie sensibili.
Nuove funzionalità
Sono stati aggiunti i seguenti servizi:
Sono stati aggiunti i seguenti metodi:
Servizio Metodi inserzionisti advertisers.channels advertisers.locationLists advertisers.negativeKeywordLists inventorySourceGroups partners.channels Sono stati aggiunti i seguenti campi:
Risorsa Campo/i inserzionista creativo insertionOrder.insertionOrderBudgetSegment
27 aprile 2020
Lanciato un ampio set di funzionalità, ampliando l'ambito dell'API oltre SDF. Aggiunta la gestione principale delle risorse, che consente di creare, recuperare, aggiornare ed eliminare entità come inserzionisti, campagne, ordini di inserzione, elementi pubblicitari creatività. Le nuove funzionalità consentono inoltre di modificare il targeting a livello di elemento pubblicitario.
Nuove funzionalità
Sono stati aggiunti i seguenti servizi:
9 marzo 2020
Lancio di Display & API Video 360 v1. Questa è la versione iniziale dell'API.
Problemi noti
Nessuno.