Condividi tramite


ExpandedTextAdBuilder

Contiene i metodi per definire e creare un annuncio di testo espanso. Per informazioni sui generatori, vedere Generatori.

Nota

  • Aggiorna gli annunci di testo espansi agli annunci di ricerca reattivi entro il 1° febbraio 2023. Dopo questa data, non sarà più possibile creare annunci di testo espansi nuovi o modificare quelli esistenti. Per altre informazioni, vedi Informazioni sugli annunci di ricerca reattivi.
  • Gli annunci di testo espansi esistenti continueranno a essere pubblicati e potrai visualizzare i report sulle loro prestazioni.
  • Potrai comunque sospendere, abilitare o rimuovere gli annunci di testo espansi. In caso contrario, i tentativi di aggiungere o aggiornare gli annunci di testo espansi genereranno un CampaignServiceAdTypeInvalid errore.
  • Altre informazioni su questa modifica.

Utilizzo di esempio:

    var operation = adGroup.newAd().expandedTextAdBuilder()
        .withHeadlinePart1('FIRST PART OF TITLE GOES HERE')
        .withHeadlinePart2('SECOND PART OF TITLE GOES HERE')
        .withDescription('AD TEXT GOES HERE')
        .withFinalUrl('LANDING PAGE URL GOES HERE')
        .build();

    // See the Builders topic for performance considerations
    // when using the operation object's methods.
    if (!operation.isSuccessful()) {
        for (var error of operation.getErrors()) {
            Logger.log(`${error}\n`);
        }
    }

Metodi

Nome metodo Tipo restituito Descrizione
Costruire AdOperation Crea l'annuncio e restituisce un oggetto operazione usato per controllare se Scripts ha aggiunto correttamente l'annuncio.
withCustomParameters(Object customParameters) ExpandedTextAdBuilder Imposta i parametri personalizzati dell'annuncio.
withDescription(string description) ExpandedTextAdBuilder Imposta la prima descrizione dell'annuncio. Questo metodo è deprecato a favore di withDescription1(string description1).
withDescription1(string description1) ExpandedTextAdBuilder Imposta la prima descrizione dell'annuncio. Questo metodo imposta lo stesso campo di withDescription(string description).
withDescription2(string description2) ExpandedTextAdBuilder Imposta la seconda descrizione dell'annuncio.
withFinalUrl(string finalUrl) ExpandedTextAdBuilder Imposta l'URL della pagina di destinazione dell'annuncio.
withHeadlinePart1(string headlinePart1) ExpandedTextAdBuilder Imposta la prima parte del titolo dell'annuncio.
withHeadlinePart2(string headlinePart2) ExpandedTextAdBuilder Imposta la seconda parte del titolo dell'annuncio.
withHeadlinePart3(string headlinePart3) ExpandedTextAdBuilder Imposta la terza parte del titolo dell'annuncio.
withMobileFinalUrl(string mobileFinalUrl) ExpandedTextAdBuilder Imposta l'URL finale dell'annuncio per i dispositivi mobili.
withPath1(string urlPath1) ExpandedTextAdBuilder Imposta il primo percorso facoltativo da aggiungere all'URL di visualizzazione dell'annuncio.
withPath2(string urlPath2) ExpandedTextAdBuilder Imposta il secondo percorso facoltativo da aggiungere all'URL di visualizzazione dell'annuncio.
withTrackingTemplate(string trackingTemplate) ExpandedTextAdBuilder Imposta il modello di rilevamento dell'annuncio.

compilazione

Crea l'annuncio e restituisce un oggetto operazione usato per controllare se Scripts ha aggiunto correttamente l'annuncio.

Per i limiti sul numero di annunci che puoi aggiungere a un gruppo di annunci, vedi Limiti della gerarchia delle entità.

Restituisce

Tipo Descrizione
AdOperation Oggetto operazione usato per verificare se Script ha aggiunto correttamente l'annuncio.

withCustomParameters(Object customParameters)

Imposta i parametri personalizzati dell'annuncio.

I parametri personalizzati sono utili per la condivisione di informazioni dinamiche tra più URL. Per altre informazioni sull'utilizzo, vedere Parametri personalizzati.

Argomenti

Nome Tipo Descrizione
customParameters Oggetto Mappa di fino a parametri personalizzati da applicare all'URL finale dell'annuncio. Ad esempio, {key1: 'value1', key2: 'value2', key3: 'value3'}, dove chiave è il nome e il valore del parametro personalizzato è il valore del parametro. Il nome può contenere un massimo di 16 caratteri a 8 byte e il valore può contenere un massimo di 200 caratteri a 8 byte.

Restituisce

Tipo Descrizione
ExpandedTextAdBuilder Generatore di annunci con i parametri personalizzati applicati.

withDescription(string description)

Imposta la prima descrizione dell'annuncio. Questo metodo è deprecato a favore di withDescription1(string description1).

Argomenti

Nome Tipo Descrizione
descrizione stringa La prima descrizione dell'annuncio. Per informazioni sui limiti di copia e sulle stringhe di testo dinamiche, vedere API Bing Ads.

Restituisce

Tipo Descrizione
ExpandedTextAdBuilder Generatore di annunci con la descrizione applicata.

withDescription1(string description1)

Imposta la prima descrizione dell'annuncio. Questo metodo imposta lo stesso campo di withDescription(string description).

Argomenti

Nome Tipo Descrizione
description1 stringa La prima descrizione dell'annuncio. Per informazioni sui limiti di copia e sulle stringhe di testo dinamiche, vedere API Bing Ads.

Restituisce

Tipo Descrizione
ExpandedTextAdBuilder Generatore di annunci con la descrizione applicata.

withDescription2(string description2)

Imposta la seconda descrizione dell'annuncio.

Argomenti

Nome Tipo Descrizione
descrizione2 stringa Seconda descrizione dell'annuncio. Per informazioni sui limiti di copia e sulle stringhe di testo dinamiche, vedere API Bing Ads.

Restituisce

Tipo Descrizione
ExpandedTextAdBuilder Generatore di annunci con la descrizione applicata.

withFinalUrl(string finalUrl)

Imposta l'URL della pagina di destinazione dell'annuncio.

Argomenti

Nome Tipo Descrizione
finalUrl stringa URL della pagina di destinazione dell'annuncio. Per informazioni sui limiti degli URL, vedere API Bing Ads.

Restituisce

Tipo Descrizione
ExpandedTextAdBuilder Generatore di annunci con l'URL finale applicato.

withHeadlinePart1(string headlinePart1)

Imposta la prima parte del titolo dell'annuncio.

Argomenti

Nome Tipo Descrizione
headlinePart1 stringa La prima parte del titolo dell'annuncio. Quando Microsoft genera il titolo dell'annuncio usando le parti 1, 2 e 3 del titolo, concatena le parti usando " - ". Non specificare il trattino in alcuna parte del titolo. Ogni parte del titolo deve contenere almeno una parola. Per informazioni sui limiti del titolo aggiuntivi e sull'inclusione di stringhe di testo dinamiche nel titolo, vedere API Bing Ads.

Restituisce

Tipo Descrizione
ExpandedTextAdBuilder Generatore di annunci con la parte 1 del titolo dell'annuncio applicata.

withHeadlinePart2(string headlinePart2)

Imposta la seconda parte del titolo dell'annuncio.

Argomenti

Nome Tipo Descrizione
headlinePart2 stringa La seconda parte del titolo dell'annuncio. Quando Microsoft genera il titolo dell'annuncio usando le parti 1, 2 e 3 del titolo, concatena le parti usando " - ". Non specificare il trattino in alcuna parte del titolo. Ogni parte del titolo deve contenere almeno una parola. Per informazioni sui limiti del titolo aggiuntivi e sull'inclusione di stringhe di testo dinamiche nel titolo, vedere API Bing Ads.

Restituisce

Tipo Descrizione
ExpandedTextAdBuilder Generatore di annunci con la parte 1 del titolo dell'annuncio applicata.

withHeadlinePart3(string headlinePart3)

Imposta la terza parte del titolo dell'annuncio.

Argomenti

Nome Tipo Descrizione
headlinePart3 stringa La terza parte del titolo dell'annuncio. Quando Microsoft genera il titolo dell'annuncio usando le parti 1, 2 e 3 del titolo, concatena le parti usando " - ". Non specificare il trattino in alcuna parte del titolo. Ogni parte del titolo deve contenere almeno una parola. Per informazioni sui limiti del titolo aggiuntivi e sull'inclusione di stringhe di testo dinamiche nel titolo, vedere API Bing Ads.

Restituisce

Tipo Descrizione
ExpandedTextAdBuilder Generatore di annunci con la parte 1 del titolo dell'annuncio applicata.

withMobileFinalUrl(string mobileFinalUrl)

Imposta l'URL finale dell'annuncio per i dispositivi mobili.

L'URL finale identifica la pagina Web a cui l'utente viene indirizzato quando fa clic sull'annuncio. Per specificare un URL finale per i dispositivi mobili, specificare innanzitutto un URL finale per i dispositivi non mobili (vedere withFinalUrl()).

Per altre informazioni, vedere Quali parametri di rilevamento o URL è possibile usare?

Argomenti

Nome Tipo Descrizione
mobileFinalUrl stringa URL finale per i dispositivi mobili.

Restituisce

Tipo Descrizione
ExpandedTextAdBuilder Generatore di annunci con l'URL finale per dispositivi mobili applicato.

withPath1(string urlPath1)

Imposta il primo percorso facoltativo da aggiungere all'URL di visualizzazione dell'annuncio.

Argomenti

Nome Tipo Descrizione
mobileFinalUrl stringa Primo percorso facoltativo da aggiungere all'URL di visualizzazione dell'annuncio. Microsoft usa il dominio specificato in withFinalUrl come URL di visualizzazione. Se il dominio dell'URL finale è contoso.com e il percorso è shoes, l'URL visualizzato dell'annuncio viene contoso.com/shoes. Per informazioni sull'utilizzo e sui limiti, vedere Path1.

Restituisce

Tipo Descrizione
ExpandedTextAdBuilder Generatore di annunci con il percorso applicato.

withPath2(string urlPath2)

Imposta il secondo percorso facoltativo da aggiungere all'URL di visualizzazione dell'annuncio.

Argomenti

Nome Tipo Descrizione
mobileFinalUrl stringa Secondo percorso facoltativo da aggiungere all'URL di visualizzazione dell'annuncio. Per specificare il secondo percorso, specificare innanzitutto il primo percorso (vedere withPath1). Microsoft usa il dominio specificato in withFinalUrl come URL di visualizzazione. Se il dominio dell'URL finale è contoso.com, il primo percorso è shoes e il secondo percorso è ladies, l'URL di visualizzazione dell'annuncio viene contoso.com/shoes/ladies. Per informazioni su utilizzo e limiti, vedere Path2.

Restituisce

Tipo Descrizione
ExpandedTextAdBuilder Generatore di annunci con il percorso applicato.

withTrackingTemplate(string trackingTemplate)

Imposta il modello di rilevamento dell'annuncio.

I modelli di rilevamento vengono usati con FinalUrl della parola chiave per creare l'URL di destinazione usato dall'annuncio. Per altre informazioni, vedere Quali parametri di rilevamento o URL è possibile usare?

Argomenti

Nome Tipo Descrizione
trackingTemplate stringa Modello di rilevamento da usare con questo annuncio.

Restituisce

Tipo Descrizione
ExpandedTextAdBuilder Generatore di annunci con il modello di rilevamento applicato.