Condividi tramite


Note sulla versione per microsoft advertising scripts

Per informazioni sulle modifiche incluse in ogni versione, vedere le sezioni seguenti.

31 marzo 2021

La posizione media non è più disponibile in Microsoft Advertising.

Il metodo getAveragePosition viene rimosso dall'oggetto Stats .

La colonna AveragePosition viene rimossa come condizione con i selettori seguenti.

5 marzo 2021

Aggiunta del supporto per il tasso di impressioni più alto assoluto e il tasso di impressioni più alto come percentuale delle impressioni totali.

Sono stati aggiunti i metodi seguenti all'oggetto Stats .

Aggiunte AbsoluteTopImpressionRate e TopImpressionRate come possibili colonne che è possibile specificare con i selettori seguenti.

23 febbraio 2021

Aggiunta del supporto per gli annunci di ricerca reattivi.

  • È stato aggiunto l'oggetto ResponsiveSearchAd , che definisce un annuncio di ricerca reattivo.

  • È stato aggiunto l'oggetto ResponsiveSearchAdBuilder , usato per aggiungere un annuncio di testo espanso al gruppo di annunci.

  • Aggiunto il responsiveSearchAdBuilder metodo all'oggetto AdBuilderSpace . Se vuoi creare un annuncio di ricerca reattivo, chiami il responsiveSearchAdBuilder metodo per ottenere l'oggetto ResponsiveSearchAdBuilder .

  • È stato aggiunto l'oggetto AdTextAsset , che contiene le proprietà per le descrizioni e i titoli degli annunci di ricerca reattivi.

  • È stato aggiunto il responsiveSearchAd metodo all'oggetto AdTypeSpace , che contiene i metodi usati per verificare se un annuncio è del tipo specificato. Ad esempio, per verificare se l'annuncio è un annuncio di ricerca reattivo.

  • È stato aggiunto il responsiveSearchAd metodo all'oggetto AdViewSpace , usato per eseguire il cast di un annuncio a un tipo specifico. Ad esempio, eseguire il cast dell'oggetto annuncio di base a un annuncio di ricerca reattivo.

21 gennaio 2021

Aggiunta del supporto per gruppi di destinatari di destinazione ed esclusi.

Questa modifica ha aggiunto gli oggetti seguenti:

10 dicembre 2020

Aggiunta del supporto per le posizioni di destinazione ed escluse.

Questa modifica ha aggiunto gli oggetti seguenti:

È stato aggiunto l'oggetto ExcludedLocationOperation , usato per determinare se Scripts ha aggiunto correttamente il percorso escluso.

È stato aggiunto l'oggetto TargetedLocationOperation , usato per determinare se Script ha aggiunto correttamente il percorso di destinazione.

31 marzo 2020

Sono stati aggiunti gli oggetti seguenti che derivano da ProductGroup:

Sono stati aggiunti i metodi seguenti a ProductGroup:

  • asChannel()
  • asChannelExclusivity()

Rimozione delle chiamate a Logger.Log() da alcuni esempi di script. Poiché la registrazione è una chiamata costosa in termini di prestazioni, le indicazioni prevedono di usare la registrazione con parsimonia e probabilmente non all'interno di cicli di volume elevati, se non per fornire la notifica dei problemi. Inoltre, anziché usare più Log() chiamate per scrivere più righe, usare una singola chiamata e includere caratteri di nuova riga ('\n').

16 gennaio 2020

Aggiunta del supporto per i gruppi di prodotti. Il supporto è limitato all'enumerazione dei gruppi di prodotti e all'aggiornamento delle offerte. Per esempi, vedere esempi di script.

Questa modifica ha aggiunto gli oggetti seguenti:

Sono stati aggiunti gli oggetti seguenti che derivano da ProductGroup:

Sono stati aggiunti i metodi seguenti ad AdsApp:

Sono stati aggiunti i metodi seguenti ad AdGroup:

Aggiunta del metodo seguente a Cammpaign:

Aggiunta di CampaignType come colonna possibile al metodo withCondition dell'oggetto AdGroupSelector.

Aggiunta di Type come colonna possibile al metodo withCondition dell'oggetto CampaignSelector.

18 ottobre 2019

Aggiunta della Id colonna al withCondition() metodo degli oggetti AdSelector e KeywordSelector . È possibile usare questa colonna per verificare la presenza di annunci o parole chiave con ID maggiori dell'ID specificato , withCondition('Id > 1234')ad esempio .

Aggiunta della soluzione di script Controlla URL di annunci e parole chiave , che puoi usare per verificare se gli annunci o le parole chiave nei tuoi account contengono URL interrotti.

7 ottobre 2019

Aggiunta CombinedApprovalStatus come colonna possibile che è possibile specificare quando si selezionano le parole chiave. Ad esempio, è possibile utilizzare la colonna per selezionare le parole chiave che sono state disapprovate per motivi editoriali. Vedere KeywordSelector.withCondition.

13 settembre 2019

È stato aggiunto l'oggetto ExecutionInfo , che contiene informazioni sull'ambiente in cui lo script è attualmente in esecuzione. Ad esempio, se lo script è in esecuzione in modalità anteprima o la quantità di tempo in cui lo script può continuare l'esecuzione.

Aggiunto il getExecutionInfo metodo all'oggetto AdsApp . Utilizzare questo metodo per ottenere l'oggetto ExecutionInfo .

È stato aggiunto il getRemainingDailyQuota metodo all'oggetto UrlFetchApp . Usare questo metodo per ottenere il numero rimanente di fetch() chiamate che l'utente può effettuare oggi.

20 agosto 2019

Di seguito è riportata una modifica solo della documentazione.

  • È stato chiarito che Script usa il fuso orario dell'account come altrove in Microsoft Advertising. Ad esempio, se si usa il metodo .forDateRange() di un selettore, Script usa il fuso orario dell'account per determinare i dati da restituire. Altre informazioni
  • È stato chiarito che la latenza dei dati negli script è la stessa di un'altra parte di Microsoft Advertising. Altre informazioni

Di seguito sono riportate le modifiche all'API che non causano interruzioni per supportare le etichette.

  • Sono stati aggiunti i metodi seguenti all'oggetto AdsApp .
    • createLabel: crea un'etichetta
    • labels: ottiene un selettore utilizzato per filtrare l'elenco di etichette in questo account
  • Sono stati aggiunti gli oggetti correlati alle etichette seguenti.
    • Etichetta : definisce un'etichetta.
    • LabelSelector : ottiene un elenco di etichette per l'account.
    • LabelIterator : esegue l'iterazione su un elenco di etichette corrispondenti ai criteri di selezione del selettore.
  • Sono stati aggiunti i metodi seguenti all'oggetto Keyword .
    • applyLabel: applica l'etichetta alla parola chiave
    • labels: ottiene un selettore utilizzato per filtrare l'elenco di etichette applicate a questa parola chiave
    • removeLabel: rimuove l'etichetta da questa parola chiave
  • Aggiunta della colonna LabelNames al metodo withCondition dell'oggetto KeywordSelector.
  • Sono stati aggiunti i metodi seguenti agli oggetti Ad e ExpandedTextAd .
    • applyLabel: applica l'etichetta all'annuncio
    • labels: ottiene un selettore usato per filtrare l'elenco di etichette applicate a questo annuncio
    • removeLabel: rimuove l'etichetta da questo annuncio
  • Aggiunta della colonna LabelNames al metodo withCondition dell'oggetto AdSelector.
  • Sono stati aggiunti i metodi seguenti all'oggetto AdGroup .
    • applyLabel: applica l'etichetta al gruppo di annunci
    • labels: ottiene un selettore usato per filtrare l'elenco di etichette applicate a questo gruppo di annunci
    • removeLabel: rimuove l'etichetta da questo gruppo di annunci
  • Aggiunta della colonna LabelNames al metodo withCondition dell'oggetto AdGroupSelector.
  • Sono stati aggiunti i metodi seguenti all'oggetto Campaign .
    • applyLabel: applica l'etichetta alla campagna
    • labels: ottiene un selettore utilizzato per filtrare l'elenco di etichette applicate a questa campagna
    • removeLabel: rimuove l'etichetta da questa campagna
  • Aggiunta della colonna LabelNames al metodo withCondition dell'oggetto CampaignSelector.

30 aprile 2019

Di seguito è riportata una modifica solo della documentazione.

  • Bing Ads è ora Microsoft Advertising. Il nostro nuovo nome riflette come stiamo crescendo le nostre soluzioni pubblicitarie per aiutarti a raggiungere più clienti. Tutti i riferimenti alla piattaforma Bing Ads nella documentazione sono stati modificati in Microsoft Advertising.

Di seguito sono riportate le modifiche all'API non di rilievo per supportare l'aggiornamento del marchio.

  • Aggiunta dell'oggetto AdsApp . Gli script continueranno a supportare l'oggetto BingAdsApp per la compatibilità con le versioni precedenti; tuttavia, è consigliabile aggiornare gli script per usare i nuovi oggetti al più presto.

25 marzo 2019

Di seguito è riportata una modifica solo della documentazione.

11 febbraio 2019

Sono stati aggiunti i metodi seguenti all'oggetto BingAdsAccountStats .

Nota

Se si usano i metodi getClickConversionRate() e getConvertedClicks(), è necessario aggiornare gli script per usare invece i metodi getConversionRate() e getConversions().

Sono stati aggiunti i metodi seguenti all'oggetto Stats .

Nota

Se si usano i metodi getClickConversionRate() e getConvertedClicks(), è necessario aggiornare gli script per usare invece i metodi getConversionRate() e getConversions().

27 novembre 2018

Di seguito è riportata una modifica solo della documentazione.

7 novembre 2018

Di seguito è riportata una modifica solo della documentazione.

  • Modifica della nota di anteprima per indicare che Scripts è ora disponibile in versione beta aperta e disponibile per tutti gli utenti di Microsoft Advertising.

4 ottobre 2018

Questa è la versione beta degli script. Per informazioni sulla partecipazione al programma, contattare il proprio account manager. Le classi script e la documentazione sono soggette a modifiche.

Sono stati aggiunti gli oggetti seguenti per supportare il recupero dell'URL.

  • È stato aggiunto l'oggetto UrlFetchApp , ovvero l'oggetto di primo livello usato per recuperare le risorse dal Web.

  • Aggiunta di HTTPResponse, che contiene i metodi per accedere al contenuto della risorsa recuperata.

  • È stato aggiunto l'argomento UrlFetch limits , che elenca i limiti per il recupero delle risorse dal Web.

Aggiungere gli argomenti seguenti:

2 ottobre 2018

Sono stati aggiunti gli oggetti e i metodi seguenti per supportare più account.

  • Aggiunto il currentAccount metodo a BingAdsApp. Utilizzare questo metodo per ottenere l'oggetto Account , che contiene informazioni sull'account che lo script sta attualmente elaborando.

  • Aggiunta dell'oggetto AccountsApp . Si tratta dell'oggetto di primo livello usato se si gestiscono account per altri utenti. Usarlo per ottenere l'elenco di account a cui si ha accesso e per selezionare l'account da gestire.

  • Aggiunta dell'oggetto BingAdsAccount . Usarlo per ottenere informazioni sull'account per un account gestito, ad esempio nome, ID cliente e dati sulle prestazioni a livello di account.

  • Aggiunta dell'oggetto BingAdsAccountIterator . Usarlo per scorrere l'elenco di account gestiti selezionati.

  • Aggiunta dell'oggetto BingAdsAccountSelector . Usarlo per selezionare l'elenco di account gestiti che si desidera ottenere.

  • Aggiunta dell'oggetto BingAdsAccountStats . Usarlo per accedere ai dati sulle prestazioni dell'account gestito.

  • Aggiunta dell'oggetto ExecutionResult . Usarlo per ottenere i risultati e restituire il valore della funzione specificata nel executeInParallel metodo del selettore (vedere BingAdsAccountSelector).

Sono stati aggiunti i campi seguenti all'oggetto Budget per supportare i budget condivisi.

  • campagne: ottiene un selettore che restituisce tutte le campagne che condividono questo budget.
  • getEntityType : ottiene il tipo dell'oggetto.
  • getId: ottiene l'ID che identifica in modo univoco il budget condiviso.
  • getName: ottiene il nome del budget condiviso.
  • getStats: ottiene i dati sulle prestazioni per le campagne che condividono questo budget.
  • getType: ottiene il tipo del budget, ad esempio DAILY.
  • isExplicitlyShared : ottiene un valore booleano che indica se il budget è un budget condiviso.

I metodi , getNamee getStats restituiscono dati solo per i budget condivisi. I getIdgetId metodi e getName restituiscono null per i budget non condivisi (singole campagne).

È stato aggiunto il campo seguente all'oggetto BingAdsApp .

  • budget: ottiene tutti i budget condivisi nell'account. Usare il selettore per filtrare l'elenco dei budget condivisi.

Sono stati aggiunti gli oggetti seguenti usati per filtrare e scorrere un elenco di budget condivisi.

  • BudgetSelector : contiene i metodi per filtrare e ordinare l'elenco dei budget condivisi.

  • BudgetIterator : contiene i metodi per scorrere l'elenco dei budget condivisi. Il metodo del get selettore restituisce l'iteratore.

Il selettore restituisce solo budget condivisi, non include budget non condivisi (singole campagne). Per determinare se una campagna usa un singolo budget, ottenere il budget chiamando il metodo della getBudget campagna. Chiamare quindi il metodo del isExplicitlyShared budget per determinare se il budget è condiviso. Il budget viene condiviso se isExplicitlyShared restituisce true.

lunedì 1 ottobre 2018

È stato aggiunto il metodo seguente all'oggetto Keyword .

  • getQualityScore : ottiene il punteggio di qualità della parola chiave. Il punteggio è compreso nell'intervallo da 1 a 10 (massimo). Il punteggio mostra quanto sono competitivi i tuoi annunci nel marketplace misurando quanto siano rilevanti le parole chiave e le pagine di destinazione per i termini di ricerca dei clienti.

12 settembre 2018

Sono stati aggiunti i metodi seguenti per ottenere le entità padre e figlio di un'entità.

  • AdGroup.getCampaign : ottiene la campagna a cui appartiene il gruppo di annunci.
  • AdGroup.keywords : ottiene un selettore usato per filtrare l'elenco di parole chiave del gruppo di annunci.
  • AdParam.getAdGroup : ottiene il gruppo di annunci a cui appartiene la parola chiave associata a questo parametro di sostituzione.
  • AdParam.getKeyword : ottiene la parola chiave a cui si applica il parametro di sostituzione.
  • Campaign.adGroups : ottiene un selettore usato per filtrare l'elenco di gruppi di annunci della campagna.
  • Campaign.keywords : ottiene un selettore utilizzato per filtrare l'elenco di parole chiave della campagna.
  • Keyword.getCampaign : ottiene la campagna a cui appartiene la parola chiave.
  • Keyword.getAdGroup : ottiene il gruppo di annunci a cui appartiene la parola chiave.
  • NegativeKeywordList.campaigns : ottiene un selettore utilizzato per filtrare l'elenco di campagne a cui è associato l'elenco di parole chiave negative.

9 settembre 2018

Aggiunta del supporto per gli annunci.

  • Aggiunto il newAd metodo ad AdGroup. Il metodo restituisce un oggetto AdBuilderSpace , che viene usato per ottenere un generatore di annunci.

  • Aggiunta dell'oggetto AdBuilderSpace . L'oggetto contiene metodi per ottenere i generatori di annunci. Ad esempio, se vuoi compilare un annuncio di testo espanso, chiami il metodo dell'oggetto expandedTextAdBuilder per ottenere l'oggetto ExpandedTextAdBuilder .

  • È stato aggiunto l'oggetto ExpandedTextAdBuilder , usato per aggiungere un annuncio di testo espanso al gruppo di annunci.

  • È stato aggiunto l'oggetto AdOperation , usato per determinare se Scripts ha aggiunto correttamente l'annuncio.

  • È stato aggiunto l'oggetto AdViewSpace , che contiene i metodi usati per eseguire il cast di un annuncio a un tipo specifico. Ad esempio, eseguire il cast dell'oggetto annuncio di base a un annuncio di testo espanso.

  • È stato aggiunto l'oggetto AdTypeSpace , che contiene i metodi usati per verificare se un annuncio è del tipo specificato. Ad esempio, per verificare se l'annuncio è un annuncio di testo espanso.

  • È stato aggiunto l'oggetto Ad , che è il tipo di annuncio di base. Definisce anche un annuncio di testo.

  • È stato aggiunto l'oggetto AdUrls , che contiene i metodi per ottenere gli URL dell'annuncio, il modello di rilevamento e i parametri personalizzati.

  • È stato aggiunto l'oggetto ExpandedTextAd , che definisce un annuncio di testo espanso.

  • È stato aggiunto l'oggetto AdSelector , usato per specificare i criteri di filtro per la selezione degli annunci.

  • È stato aggiunto l'oggetto AdIterator , usato per scorrere l'elenco filtrato di annunci.

  • Aggiunto il ads metodo a BingAdsApp. Il metodo restituisce l'oggetto AdSelector , usato per specificare i criteri di filtro per la selezione degli annunci nell'account.

  • Aggiunto il ads metodo ad AdGroup. Il metodo restituisce l'oggetto AdSelector , usato per specificare i criteri di filtro per la selezione degli annunci nel gruppo di annunci.

  • Aggiunto il ads metodo a Campaign. Il metodo restituisce l'oggetto AdSelector , usato per specificare i criteri di filtro per la selezione degli annunci nella campagna.

15 giugno 2018

Versione beta chiusa. Questa versione di Microsoft Advertising Scripts è disponibile solo per selezionare i partecipanti. Per informazioni sulla partecipazione al programma di versione di anteprima, contattare il responsabile dell'account. Le classi script e la documentazione sono soggette a modifiche.

Questa versione iniziale include le funzionalità seguenti:

  • Gestione delle campagne principali (campagne, gruppi di annunci, parole chiave)
  • Dati sulle prestazioni a livello di entità (campagne, gruppi di annunci, parole chiave)
  • Elenchi di parole chiave negative condivise