ResponsiveSearchAdBuilder

Contiene i metodi per definire e creare un annuncio di ricerca reattivo. Per informazioni sui costruttori, consulta Costruttori.

Esempio di utilizzo:

    var operation = adGroup.newAd().responsiveSearchAdBuilder()
        .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
addDescription(descrizione stringa, associazione stringa)	ResponsiveSearchAdBuilder	Aggiunge la descrizione fornita all'elenco corrente di descrizioni. È necessario specificare almeno 2 descrizioni utilizzando questo metodo o il metodo addDescription().
addHeadline(titolo stringa, aggiunta stringa)	ResponsiveSearchAdBuilder	Aggiunge il titolo fornito all'elenco corrente dei titoli. È necessario specificare almeno 3 titoli utilizzando questo metodo o il metodo addHeadline().
compilazione	AdOperation	Crea l'annuncio e restituisce un oggetto operazione utilizzato per verificare se gli script hanno aggiunto correttamente l'annuncio.
withCustomParameters(Object customParameters)	ResponsiveSearchAdBuilder	Imposta i parametri personalizzati dell'annuncio.
withDescriptions(object[] descrizioni)	ResponsiveSearchAdBuilder	Imposta le descrizioni dell'annuncio.
withFinalUrl(string finalUrl)	ResponsiveSearchAdBuilder	Imposta l'URL della pagina di destinazione dell'annuncio.
withFinalUrlSuffix(stringa, finalUrlSuffix)	ResponsiveSearchAdBuilder	Imposta il suffisso dell'URL finale dell'annuncio.
withHeadlines(object[] headlines)	ResponsiveSearchAdBuilder	Imposta i titoli dell'annuncio.
withMobileFinalUrl(string mobileFinalUrl)	ResponsiveSearchAdBuilder	Imposta l'URL finale dell'annuncio per i dispositivi mobili.
withPath1(string urlPath1)	ResponsiveSearchAdBuilder	Imposta il primo percorso facoltativo da aggiungere all'URL di visualizzazione dell'annuncio.
withPath2(stringa urlPath2)	ResponsiveSearchAdBuilder	Imposta il secondo percorso facoltativo da aggiungere all'URL di visualizzazione dell'annuncio.
withTrackingTemplate(string trackingTemplate)	ResponsiveSearchAdBuilder	Imposta il modello di monitoraggio dell'annuncio.

addDescription(descrizione stringa, associazione stringa)

Aggiunge la descrizione fornita all'elenco corrente di descrizioni. È necessario specificare almeno 2 descrizioni utilizzando questo metodo o il metodo addDescription().

Argomenti

Nome	Tipo	Descrizione
descrizione	stringa	Descrizione dell'annuncio da aggiungere. Per informazioni sui limiti e sull'inclusione di stringhe di testo dinamico, vedere API di Bing Ads.
Aggiunta	stringa	Posizione aggiunta facoltativa. I valori possibili per le descrizioni sono: DESCRIPTION_1, DESCRIPTION_2
testo	stringa	Testo dell'asset.

Restituisce

Tipo	Descrizione
ResponsiveSearchAdBuilder	Generatore di annunci con la descrizione applicata.

addHeadline(titolo stringa, aggiunta stringa)

Aggiunge il titolo fornito all'elenco corrente dei titoli. È necessario specificare almeno 3 titoli utilizzando questo metodo o il metodo addHeadline().

Argomenti

Nome	Tipo	Descrizione
titolo	stringa	Titolo dell'annuncio da aggiungere. Per informazioni sui limiti e sull'inclusione di stringhe di testo dinamico, vedere API di Bing Ads.
Aggiunta	stringa	Posizione aggiunta facoltativa. I valori possibili per i titoli sono: HEADLINE_1, HEADLINE_2 HEADLINE_3

Restituisce

Tipo	Descrizione
ResponsiveSearchAdBuilder	Generatore di annunci con il titolo applicato.

compilazione

Crea l'annuncio e restituisce un oggetto operazione utilizzato per verificare se gli script hanno aggiunto correttamente l'annuncio.

Per i limiti del numero di annunci che è possibile aggiungere a un gruppo di annunci, vedere Limiti della gerarchia delle entità.

Restituisce

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

withCustomParameters(Object customParameters)

Imposta i parametri personalizzati dell'annuncio.

I parametri personalizzati sono utili per condividere informazioni dinamiche su più URL. Per ulteriori informazioni sul suo utilizzo, vedere Parametri personalizzati.

Argomenti

Nome	Tipo	Descrizione
customParameters	Oggetto	Mappa di un massimo di parametri personalizzati da applicare all'URL finale dell'annuncio. Ad esempio, {key1: 'value1', key2: 'value2', key3: 'value3'}, dove chiave è il nome del parametro personalizzato e value è 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
ResponsiveSearchAdBuilder	Generatore di annunci con i parametri personalizzati applicati.

withDescriptions(object[] descrizioni)

Imposta le descrizioni dell'annuncio.

Argomenti

Nome	Tipo	Descrizione
Descrizioni	AdTextAsset[]	Descrizioni dell'annuncio. Per informazioni sui limiti e sull'inclusione di stringhe di testo dinamico, vedere API di Bing Ads.

Restituisce

Tipo	Descrizione
ResponsiveSearchAdBuilder	Generatore di annunci con le descrizioni applicate.

withFinalUrl(string finalUrl)

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

Argomenti

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

Restituisce

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

withFinalUrlSuffix(stringa, finalUrlSuffix)

Imposta il suffisso dell'URL finale dell'annuncio.

Argomenti

Nome	Tipo	Descrizione
url finale	stringa	Suffisso URL finale dell'annuncio. Per informazioni sui limiti degli URL, vedere API di Bing Ads.

Restituisce

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

withHeadlines(object[] headlines

Imposta i titoli dell'annuncio.

Argomenti

Nome	Tipo	Descrizione
Titoli	AdTextAsset[]	Titoli dell'annuncio. Per informazioni sui limiti e sull'inclusione di stringhe di testo dinamico, vedere API di Bing Ads.

Restituisce

Tipo	Descrizione
ResponsiveSearchAdBuilder	Generatore di annunci con i titoli dell'annuncio applicati.

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 prima un URL finale per i dispositivi non mobili (vedere withFinalUrl()).

Per ulteriori informazioni, vedere Quali parametri di monitoraggio o di URL è possibile utilizzare?

Argomenti

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

Restituisce

Tipo	Descrizione
ResponsiveSearchAdBuilder	Generatore di annunci con l'URL finale mobile 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 come withFinalUrl URL visualizzato. Se il dominio dell'URL finale è contoso.com e il percorso è scarpe, l'URL visualizzato dell'annuncio è contoso.com/shoes. Per l'utilizzo e i limiti, vedere il Percorso 1.

Restituisce

Tipo	Descrizione
ResponsiveSearchAdBuilder	Generatore di annunci con il percorso applicato.

withPath2(stringa urlPath2)

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

Argomenti

Nome	Tipo	Descrizione
mobileFinalUrl	stringa	Il secondo percorso facoltativo da aggiungere all'URL visualizzato dell'annuncio. Per specificare il secondo percorso, specificate prima il primo percorso (consultate withPath1). Microsoft usa il dominio specificato come withFinalUrl URL visualizzato. Se il dominio dell'URL finale è contoso.com, il primo percorso è scarpe e il secondo percorso è donne, l'URL visualizzato dell'annuncio è contoso.com/shoes/ladies. Per l'utilizzo e i limiti, vedere Percorso 2.

Restituisce

Tipo	Descrizione
ResponsiveSearchAdBuilder	Generatore di annunci con il percorso applicato.

withTrackingTemplate(string trackingTemplate)

Imposta il modello di monitoraggio dell'annuncio.

I modelli di monitoraggio vengono usati con l'URL finale della parola chiave per creare l'URL di destinazione usato dall'annuncio. Per ulteriori informazioni, vedere Quali parametri di monitoraggio o di URL è possibile utilizzare?

Argomenti

Nome	Tipo	Descrizione
trackingTemplate	stringa	Modello di monitoraggio da utilizzare con l'annuncio.

Restituisce

Tipo	Descrizione
ResponsiveSearchAdBuilder	Generatore di annunci con il modello di monitoraggio applicato.