Contiene i metodi per la definizione e la creazione di un annuncio di testo espanso. Per informazioni sui costruttori, consulta Costruttori.
Nota
-
Aggiornare gli annunci di testo espansi in annunci di ricerca reattivi entro il 1° febbraio 2023. Dopo questa data, non sarà più possibile creare nuovi annunci di testo espansi né modificare quelli esistenti. Per altre informazioni, vedere Informazioni sugli annunci di ricerca reattivi.
- Gli annunci di testo espansi esistenti continueranno a essere visualizzati e sarà possibile visualizzare i relativi report sulle prestazioni.
- Sarà comunque possibile sospendere, abilitare o rimuovere gli annunci di testo espansi. In caso contrario, i tentativi di aggiungere o aggiornare gli annunci di testo espansi restituiranno un
CampaignServiceAdTypeInvalid errore.
-
Altre informazioni su questo cambiamento.
Esempio di utilizzo:
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
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
withDescription(descrizione stringa)
Imposta la prima descrizione dell'annuncio. Questo metodo è deprecato a favore di withDescription1(string description1).
Argomenti
| Nome |
Tipo |
Descrizione |
| descrizione |
stringa |
Prima descrizione dell'annuncio. Per informazioni sui limiti di copia e sull'inclusione di stringhe di testo dinamico, vedere API di Bing Ads. |
Restituisce
withDescription1(stringa description1)
Imposta la prima descrizione dell'annuncio. Questo metodo imposta lo stesso campo di withDescription(descrizione stringa).
Argomenti
| Nome |
Tipo |
Descrizione |
| descrizione1 |
stringa |
Prima descrizione dell'annuncio. Per informazioni sui limiti di copia e sull'inclusione di stringhe di testo dinamico, vedere API di Bing Ads. |
Restituisce
withDescription2(string description2)
Imposta la seconda descrizione dell'annuncio.
Argomenti
| Nome |
Tipo |
Descrizione |
| descrizione2 |
stringa |
La seconda descrizione dell'annuncio. Per informazioni sui limiti di copia e sull'inclusione di stringhe di testo dinamico, vedere API di Bing Ads. |
Restituisce
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
withHeadlinePart1(stringa headlinePart1)
Imposta la prima parte del titolo dell'annuncio.
Argomenti
| Nome |
Tipo |
Descrizione |
| headlinePart1 |
stringa |
Prima parte del titolo dell'annuncio. Quando Microsoft genera il titolo dell'annuncio utilizzando le parti 1, 2 e 3 del titolo, concatena le parti utilizzando " - ". Non specificare il trattino nelle parti del titolo. Ogni parte del titolo deve contenere almeno una parola. Per informazioni sui limiti aggiuntivi per i titoli e sull'inclusione di stringhe di testo dinamico nel titolo, vedere API di Microsoft Advertising. |
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 |
Seconda parte del titolo dell'annuncio. Quando Microsoft genera il titolo dell'annuncio utilizzando le parti 1, 2 e 3 del titolo, concatena le parti utilizzando " - ". Non specificare il trattino nelle parti del titolo. Ogni parte del titolo deve contenere almeno una parola. Per informazioni sui limiti aggiuntivi per i titoli e sull'inclusione di stringhe di testo dinamico nel titolo, vedere API di Microsoft Advertising. |
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 |
Terza parte del titolo dell'annuncio. Quando Microsoft genera il titolo dell'annuncio utilizzando le parti 1, 2 e 3 del titolo, concatena le parti utilizzando " - ". Non specificare il trattino nelle parti del titolo. Ogni parte del titolo deve contenere almeno una parola. Per informazioni sui limiti aggiuntivi per i titoli e sull'inclusione di stringhe di testo dinamico nel titolo, vedere API di Microsoft Advertising. |
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 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
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
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
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