ResponsiveSearchAdBuilder

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

Utilizzo di esempio:

    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, aggiunta di stringhe)	ResponsiveSearchAdBuilder	Aggiunge la descrizione fornita all'elenco corrente di descrizioni. È necessario specificare almeno 2 descrizioni usando questo metodo o addDescription().
addHeadline(string headline, string pinning)	ResponsiveSearchAdBuilder	Aggiunge il titolo specificato all'elenco corrente dei titoli. È necessario specificare almeno 3 titoli usando questo o il metodo addHeadline().
Costruire	AdOperation	Crea l'annuncio e restituisce un oggetto operazione usato per controllare se Scripts ha aggiunto correttamente l'annuncio.
withCustomParameters(Object customParameters)	ResponsiveSearchAdBuilder	Imposta i parametri personalizzati dell'annuncio.
withDescriptions(object[] descriptions)	ResponsiveSearchAdBuilder	Imposta le descrizioni dell'annuncio.
withFinalUrl(string finalUrl)	ResponsiveSearchAdBuilder	Imposta l'URL della pagina di destinazione dell'annuncio.
withFinalUrlSuffix(string finalUrlSuffix)	ResponsiveSearchAdBuilder	Imposta il suffisso 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(string urlPath2)	ResponsiveSearchAdBuilder	Imposta il secondo percorso facoltativo da aggiungere all'URL di visualizzazione dell'annuncio.
withTrackingTemplate(string trackingTemplate)	ResponsiveSearchAdBuilder	Imposta il modello di rilevamento dell'annuncio.

addDescription(descrizione stringa, aggiunta di stringhe)

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

Argomenti

Nome	Tipo	Descrizione
descrizione	stringa	Descrizione dell'annuncio da aggiungere. Per informazioni sui limiti e sulle stringhe di testo dinamiche, vedere API Bing Ads.
Appuntare	stringa	Percorso aggiunto facoltativo. 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(string headline, string pinning)

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

Argomenti

Nome	Tipo	Descrizione
Titolo	stringa	Titolo dell'annuncio da aggiungere. Per informazioni sui limiti e sulle stringhe di testo dinamiche, vedere API Bing Ads.
Appuntare	stringa	Percorso aggiunto facoltativo. 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 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
ResponsiveSearchAdBuilder	Generatore di annunci con i parametri personalizzati applicati.

withDescriptions(object[] descriptions)

Imposta le descrizioni dell'annuncio.

Argomenti

Nome	Tipo	Descrizione
Descrizioni	AdTextAsset[]	Descrizioni dell'annuncio. Per informazioni sui limiti e sulle stringhe di testo dinamiche, vedere API 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
finalUrl	stringa	URL della pagina di destinazione dell'annuncio. Per informazioni sui limiti degli URL, vedere API Bing Ads.

Restituisce

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

withFinalUrlSuffix(string finalUrlSuffix)

Imposta il suffisso URL finale dell'annuncio.

Argomenti

Nome	Tipo	Descrizione
finalUrl	stringa	Suffisso URL finale dell'annuncio. Per informazioni sui limiti degli URL, vedere API 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 sulle stringhe di testo dinamiche, vedere API 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 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
ResponsiveSearchAdBuilder	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
ResponsiveSearchAdBuilder	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
ResponsiveSearchAdBuilder	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
ResponsiveSearchAdBuilder	Generatore di annunci con il modello di rilevamento applicato.