Contiene i metodi usati per definire e aggiungere un gruppo di annunci. Per informazioni sui generatori, vedere Generatori.
Utilizzo di esempio:
// Get a campaign to add the ad group to.
var iterator = AdsApp.campaigns()
.withIds(['CAMPAIGN ID GOES HERE'])
.get();
while (iterator.hasNext()) {
var campaign = iterator.next();
// Get the campaign's ad group builder and add an ad group.
var operation = campaign.newAdGroupBuilder()
.withName("AD GROUP NAME GOES HERE")
.withStatus("ENABLED")
.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`);
}
}
}
Generatore di gruppi di annunci con la strategia di offerta applicata.
withCpc(double cpc)
Imposta l'offerta CPC del gruppo di annunci.
Specifica l'importo dell'offerta da usare quando la parola chiave corrisponde al termine di ricerca dell'utente e la strategia di offerta del gruppo di annunci è MANUAL_CPC. Questa offerta viene usata se un'entità di livello inferiore, ad esempio la parola chiave, non ne esegue l'override.
Argomenti
Nome
Tipo
Descrizione
Cpc
Doppia
Offerta CPC massima del gruppo di annunci. La valuta del conto determina i valori minimo e massimo dell'offerta. Per altre informazioni, vedere Valute di offerta e budget.
Generatore di gruppi di annunci con l'offerta CPC applicata.
withCpm(double cpm)
Imposta l'offerta CPM del gruppo di annunci.
Specifica l'importo dell'offerta da usare per 1.000 impression visualizzate e quando viene MANUAL_CPM la strategia di offerta del gruppo di annunci.
Argomenti
Nome
Tipo
Descrizione
Cpm
Doppia
Offerta CPM massima del gruppo di annunci. La valuta del conto determina i valori minimo e massimo dell'offerta. Per altre informazioni, vedere Valute di offerta e budget.
Generatore di gruppi di annunci con l'offerta CPM applicata.
withCpv(double cpv)
Imposta l'offerta CPV del gruppo di annunci.
Specifica l'importo dell'offerta da usare per visualizzazione o per clic su un annuncio video e quando viene MANUAL_CPV la strategia di offerta del gruppo di annunci.
Argomenti
Nome
Tipo
Descrizione
Cpv
Doppia
Offerta massima CPV del gruppo di annunci. La valuta del conto determina i valori minimo e massimo dell'offerta. Per altre informazioni, vedere Valute di offerta e budget.
Generatore di gruppi di annunci con l'offerta CPV applicata.
withCustomParameters(Object customParameters)
Imposta i parametri personalizzati del gruppo di annunci da usare negli URL finali o nei modelli di rilevamento.
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 un massimo di tre parametri personalizzati da applicare al gruppo di annunci. 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.
Generatore di gruppi di annunci con i parametri personalizzati applicati.
withEndDate(string endDate)
Imposta la data in cui gli annunci nel gruppo di annunci smettono di essere pubblicati. Chiama questo metodo solo se vuoi che gli annunci nel gruppo interrompano la pubblicazione in una data specifica.
Argomenti
Nome
Tipo
Descrizione
Enddate
stringa
Data in cui interrompere la pubblicazione degli annunci. Specificare la data nel modulo AAAAMMGG.
Generatore di gruppi di annunci con la data di fine applicata.
withEndDate(Object endDate)
Imposta la data in cui gli annunci nel gruppo di annunci smettono di essere pubblicati. Chiama questo metodo solo se vuoi che gli annunci nel gruppo interrompano la pubblicazione in una data specifica.
Argomenti
Nome
Tipo
Descrizione
Enddate
Oggetto
Data in cui interrompere la pubblicazione degli annunci. Specificare la data usando un oggetto con i campi seguenti:
Anno
Mese
Giorno
Ad esempio: var date = {year: 2018, month: 5, day: 13};
Il mese è in base uno, dove 1 è gennaio e 12 dicembre.
Generatore di gruppi di annunci con la data di fine applicata.
withLanguage(string language)
Imposta la lingua usata dagli annunci in questo gruppo di annunci.
Per impostazione predefinita, il gruppo di annunci eredita la lingua dalla campagna padre. Specificare una lingua a livello di gruppo di annunci per sostituire la lingua specificata a livello di campagna o se la campagna non specifica una lingua (la lingua deve essere specificata a livello di campagna e/o gruppo di annunci).
Argomenti
Nome
Tipo
Descrizione
Lingua
stringa
Lingua usata dagli annunci nel gruppo di annunci. Ad esempio, inglese. La stringa non fa distinzione tra maiuscole e minuscole. Non usare un codice di linguaggio a due caratteri. Per un elenco delle lingue supportate, vedere Lingue degli annunci.
Generatore di gruppi di annunci con la lingua applicata.
withName(string name)
Imposta il nome del gruppo di annunci.
Argomenti
Nome
Tipo
Descrizione
Nome
stringa
Nome del gruppo di annunci. Il nome è obbligatorio. Il nome può contenere un massimo di 256 caratteri e deve essere univoco tra tutti i gruppi di annunci attivi nella campagna.
Generatore di gruppi di annunci con il nome applicato.
withStartDate(string startDate)
Imposta la data in cui gli annunci nel gruppo di annunci iniziano a essere pubblicati. Chiama questo metodo solo se vuoi che gli annunci nel gruppo inizino a essere pubblicati in una data specifica; in caso contrario, gli annunci iniziano a essere pubblicati immediatamente.
Argomenti
Nome
Tipo
Descrizione
Enddate
stringa
Data di inizio della pubblicazione degli annunci. Specificare la data nel modulo AAAAMMGG.
Generatore di gruppi di annunci con la data di inizio applicata.
withStartDate(Object startDate)
Imposta la data in cui gli annunci nel gruppo di annunci iniziano a essere pubblicati. Chiama questo metodo solo se vuoi che gli annunci nel gruppo inizino a essere pubblicati in una data specifica; in caso contrario, gli annunci iniziano a essere pubblicati immediatamente.
Argomenti
Nome
Tipo
Descrizione
Enddate
Oggetto
Data di inizio della pubblicazione degli annunci. Specificare la data usando un oggetto con i campi seguenti:
Anno
Mese
Giorno
Ad esempio: var date = {year: 2018, month: 5, day: 13};
Il mese è in base uno, dove 1 è gennaio e 12 dicembre.