Eseguire la migrazione da v2 a v3

Ultimo aggiornamento: 31/10/2023

Eseguire la migrazione dell'applicazione

La migrazione dalla versione 2 alla versione 3 richiede l'aggiornamento degli URL degli endpoint per chiamare la versione 3 e l'aggiornamento dell'applicazione per tenere conto delle modifiche che causano interruzioni.

Aggiorna le chiamate API dalla versione 2 alla versione 3

Per utilizzare la versione 3 anziché la versione 2, devi aggiornare le richieste in modo che utilizzino i nuovi endpoint v3.

Ad esempio, per chiamare il metodo advertisers.get con la v2, devi utilizzare il seguente URL:

GET https://displayvideo.googleapis.com/v2/advertisers/advertiserId

Per la versione 3, aggiorna l'URL come segue:

GET https://displayvideo.googleapis.com/v3/advertisers/advertiserId

Se utilizzi una libreria client per effettuare richieste all'API, utilizza la versione più recente della libreria client e aggiorna la configurazione per utilizzare la versione 3.

Apporta le modifiche desiderate

Stiamo introducendo una serie di modifiche che provocano un errore nella v3. Esamina le seguenti istruzioni e apportare le modifiche necessarie in base all'utilizzo esistente dell'API Display & Video 360.

Aggiorna le chiamate che recuperano le risorse di YouTube e il relativo targeting

• Le risorse YoutubeAdGroup e YoutubeAdGroupAd sono state sostituite dalle risorse AdGroup e AdGroupAd. Queste nuove risorse forniscono informazioni quasi identiche a quelle delle risorse v2, ma potrebbero utilizzare nomi di campi o tipi di enumerazione aggiornati. Nell'integrazione, sostituisci gli utilizzi delle risorse YoutubeAdGroup o YoutubeAdGroupAd con le risorse AdGroup e AdGroupAd e aggiorna le chiamate ai seguenti servizi v2 al servizio v3 corrispondente:
  • Da advertisers.youtubeAdGroupAds a advertisers.adGroupAds
  • Da advertisers.youtubeAdGroups a advertisers.adGroups
  • advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions a advertisers.adGroups.targetingTypes.assignedTargetingOptions
• I riferimenti agli oggetti YoutubeAndPartnersBiddingStrategy sono stati spostati in un nuovo campo youtubeAndPartnersBid all'interno dell'oggetto BiddingStrategy generale. Il campo biddingStrategy è stato rimosso dall'oggetto YoutubeAndPartnersSettings. Aggiorna l'integrazione per recuperare la strategia di offerta per gli elementi pubblicitari o i gruppi di annunci di YouTube dall'oggetto BiddingStrategy nel campo bidStrategy nella risorsa LineItem o AdGroup.
• Il campo thirdPartyMeasurementSettings è stato rinominato in thirdPartyMeasurementConfigs nell'oggetto YoutubeAndPartnersSettings e l'oggetto YoutubeAndPartnersThirdPartyMeasurementSettings è stato rinominato in ThirdPartyMeasurementConfigs. Aggiorna l'integrazione per recuperare le informazioni di configurazione della misurazione di terze parti utilizzando il nuovo campo e il nuovo oggetto.

Includere le configurazioni di fatturazione richieste durante la creazione degli inserzionisti

billingConfig è ora un campo obbligatorio nella risorsa Advertiser. Aggiorna le richieste advertisers.create per verificare che questo campo sia impostato. Le informazioni di fatturazione predefinite possono essere recuperate per il partner principale tramite il nuovo campo della risorsa Partner billingConfig.

Utilizzare il nuovo campo per controllare il targeting ottimizzato

Un nuovo campo booleano enableOptimizedTargeting ha sostituito il campo targetingExpansionLevel nell'oggetto TargetingExpansionConfig.

Aggiorna l'integrazione dell'ordine di inserzione in modo da utilizzare il nuovo campo KPI

Un nuovo campo kpi ha sostituito il campo performanceGoal nella risorsa InsertionOrder. Questo nuovo campo utilizza un oggetto Kpi al posto dell'oggetto PerformanceGoal e utilizza nuovi campi ed enum.

Rimuovere i riferimenti a servizi e campi deprecati

Nella v3 sono state rimosse varie entità per allinearsi ai ritiri di funzionalità precedenti:

• Il servizio advertisers.manualTriggers è stato rimosso perché i trigger manuali sono stati ritirati.
• Il campo billableOutcome è stato rimosso dalla risorsa InsertionOrder perché l'acquisto basato sui risultati è stato ritirato.

Ulteriori modifiche

Oltre alle modifiche che causano interruzioni elencate sopra, la v3 introduce anche nuove funzionalità.

Le funzionalità aggiunte alla versione 3 dopo il lancio iniziale sono disponibili nelle note di rilascio.

Gestione dell'elenco delle località di prossimità

Nella versione 3 puoi gestire completamente gli elenchi di località di prossimità, consentendoti di utilizzare il servizio advertisers.locationLists.assignedLocations per creare ed eliminare le località assegnate alle risorse TARGETING_LOCATION_TYPE_PROXIMITY LocationList. Le località vengono identificate utilizzando l'ID delle risorse TARGETING_TYPE_POI TargetingOption. Possono essere recuperati utilizzando targetingTypes.targetingOptions.search.

Possibilità di creare algoritmi di offerta personalizzata basati su regole

Nella v3, puoi creare e recuperare algoritmi delle offerte personalizzate basati su regole utilizzando i servizi customBiddingAlgorithms, media e customBiddingAlgorithms.rules.

Questa funzionalità è in versione beta ed è disponibile solo per i partner inclusi nella lista consentita. Se il tuo partner non è incluso nella lista consentita, la tua richiesta restituirà un errore.