Eseguire la migrazione da v2 a v3

Ultimo aggiornamento: 31-10-2023

Esegui la migrazione dell'applicazione

La migrazione dalla versione v2 alla versione 3 richiede l'aggiornamento degli URL degli endpoint per chiamare la versione 3 e aggiornare l'applicazione per tenere conto delle modifiche che provocano un errore.

Aggiorna le chiamate API da v2 a v3

Per utilizzare la versione v3 anziché la versione 2, devi aggiornare le richieste in modo da utilizzare la nuova versione v3 endpoint.

Ad esempio, per chiamare il metodo advertisers.get con v2, devi utilizza 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 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 versione 3. Esamina quanto segue istruzioni e apportare le modifiche necessarie pertinenti all'utilizzo esistente dei Display e l'API Video 360.

Aggiorna le chiamate recuperando le risorse di YouTube e il relativo targeting

• Le risorse YoutubeAdGroup e YoutubeAdGroupAd sono state sostituite da Risorse AdGroup e AdGroupAd. Queste nuove risorse offrono informazioni quasi identiche alle risorse v2, ma potrebbero utilizzare il campo aggiornato nomi o tipi enum. Nell'integrazione, sostituisci gli utilizzi delle YoutubeAdGroup o YoutubeAdGroupAd risorse con AdGroup e AdGroupAd risorse e aggiorna le chiamate ai seguenti servizi v2 per il servizio v3 corrispondente:
  • Da advertisers.youtubeAdGroupAds a advertisers.adGroupAds
  • Da advertisers.youtubeAdGroups a advertisers.adGroups
  • Da advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions a advertisers.adGroups.targetingTypes.assignedTargetingOptions
• Riferimenti agli oggetti YoutubeAndPartnersBiddingStrategy sono stati spostati in un nuovo campo youtubeAndPartnersBid all'interno dell'oggetto BiddingStrategy generale. La Il campo biddingStrategy è stato rimosso da YoutubeAndPartnersSettings. Aggiorna l'integrazione in recupera la strategia di offerta per gli elementi pubblicitari o i gruppi di annunci di YouTube dal Oggetto BiddingStrategy nel campo bidStrategy nella Risorsa LineItem o AdGroup.
• Il campo thirdPartyMeasurementSettings è stato rinominato thirdPartyMeasurementConfigs nel YoutubeAndPartnersSettings e il parametro L'oggetto YoutubeAndPartnersThirdPartyMeasurementSettings è stato rinominato ThirdPartyMeasurementConfigs Aggiorna l'integrazione in Recuperare le informazioni di configurazione della misurazione di terze parti utilizzando il nuovo campo e oggetto.

Includere le configurazioni di fatturazione richieste durante la creazione degli inserzionisti.

billingConfig è ora un campo obbligatorio nella Advertiser. Aggiorna il tuo advertisers.create per verificare che questo campo sia impostato. I dati di fatturazione predefiniti possono essere recuperata per il partner principale tramite il nuovo Partner della risorsa billingConfig.

Utilizza nuovo campo per controllare il targeting ottimizzato

Un nuovo campo booleano enableOptimizedTargeting ha sostituito il Campo targetingExpansionLevel nella TargetingExpansionConfig .

Aggiorna l'integrazione dell'ordine di inserzione per utilizzare il nuovo campo KPI

Un nuovo campo kpi ha sostituito il campo performanceGoal in la risorsa InsertionOrder. Questo nuovo campo utilizza un parametro Kpi invece dell'oggetto PerformanceGoal e utilizza nuovi campi ed enum.

Rimuovi i riferimenti a servizi e campi deprecati

Nella versione 3 sono state rimosse diverse entità per allinearle con gli elementi precedenti ritiri:

• Il servizio advertisers.manualTriggers è stato rimosso come attivatore manuale sono state ritirate.
• Il campo billableOutcome è stato rimosso dalla Risorsa di InsertionOrder man mano che l'acquisto basato sui risultati è stato deprecato.

Ulteriori modifiche

Oltre alle modifiche che provocano un errore, la versione 3 introduce anche nuove le funzionalità di machine learning.

Le funzioni aggiunte alla versione 3 dopo il lancio iniziale sono disponibili nella nostra release note.

Gestione degli elenchi di località di prossimità

Nella versione v3 puoi gestire completamente gli elenchi di località di prossimità, in modo da poter utilizzare il servizio advertisers.locationLists.assignedLocations per crea ed elimina le località assegnate a TARGETING_LOCATION_TYPE_PROXIMITY LocationList di risorse. Le località sono identificate tramite l'ID TARGETING_TYPE_POI TargetingOption di risorse. Questi possono essere recuperate utilizzando targetingTypes.targetingOptions.search.

Possibilità di creare algoritmi per le offerte personalizzate basati su regole

Nella versione v3, puoi creare e recuperare algoritmi per le offerte personalizzate basate su regole utilizzando customBiddingAlgorithms, media, customBiddingAlgorithms.rules.

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