Condividi tramite

AdGroupBuilder

  • Articolo

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`);
            }
        }
    }

Metodi

Nome metodo Tipo restituito Descrizione
Costruire AdGroupOperation Crea il gruppo di annunci e restituisce un oggetto operazione usato per verificare se il gruppo di annunci è stato aggiunto correttamente.
withBiddingStrategy(string biddingStrategy) AdGroupBuilder Imposta la strategia di offerta del gruppo di annunci.
withCpc(double cpc) AdGroupBuilder Imposta l'offerta CPC massima del gruppo di annunci.
withCpm(double cpm) AdGroupBuilder Imposta l'offerta CPM massima del gruppo di annunci.
withCpv(double cpv) AdGroupBuilder Imposta l'offerta CPV massima del gruppo di annunci.
withCustomParameters(Object customParameters) AdGroupBuilder Imposta i parametri personalizzati del gruppo di annunci.
withEndDate(string endDate) AdGroupBuilder Imposta la data in cui gli annunci nel gruppo di annunci smettono di essere pubblicati.
withEndDate(Object endDate) AdGroupBuilder Imposta la data in cui gli annunci nel gruppo di annunci smettono di essere pubblicati.
withLanguage(string language) AdGroupBuilder Imposta la lingua usata da questo gruppo di annunci.
withName(string name) AdGroupBuilder Imposta il nome del gruppo di annunci.
withStartDate(string startDate) AdGroupBuilder Imposta la data in cui gli annunci nel gruppo di annunci iniziano a essere pubblicati.
withStartDate(Object startDate) AdGroupBuilder Imposta la data in cui gli annunci nel gruppo di annunci iniziano a essere pubblicati.
withStatus(string status) AdGroupBuilder Imposta lo stato del gruppo di annunci.
withTrackingTemplate(string trackingTemplate) AdGroupBuilder Imposta il modello di rilevamento del gruppo di annunci.

compilazione

Crea il gruppo di annunci e restituisce un oggetto operazione usato per verificare se il gruppo di annunci è stato aggiunto correttamente.

Restituisce

Tipo Descrizione
AdGroupOperation Oggetto operazione usato per verificare se il gruppo di annunci è stato aggiunto correttamente.

withBiddingStrategy(string biddingStrategy)

Imposta la strategia di offerta del gruppo di annunci.

Argomenti

Nome Tipo Descrizione
biddingStrategy stringa Strategia di offerta da applicare al gruppo di annunci. Di seguito sono riportati i possibili valori con distinzione tra maiuscole e minuscole.
  • MANUAL_CPC
  • MANUAL_CPM
  • MANUAL_CPV
Per informazioni su queste strategie, vedere Tipi di strategia di offerta.

Restituisce

Tipo Descrizione
AdGroupBuilder 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.

Restituisce

Tipo Descrizione
AdGroupBuilder 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.

Restituisce

Tipo Descrizione
AdGroupBuilder 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.

Restituisce

Tipo Descrizione
AdGroupBuilder 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.

Restituisce

Tipo Descrizione
AdGroupBuilder 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.

Restituisce

Tipo Descrizione
AdGroupBuilder 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.

Restituisce

Tipo Descrizione
AdGroupBuilder 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.

Restituisce

Tipo Descrizione
AdGroupBuilder 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.

Restituisce

Tipo Descrizione
AdGroupBuilder 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.

Restituisce

Tipo Descrizione
AdGroupBuilder 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.

Restituisce

Tipo Descrizione
AdGroupBuilder Generatore di gruppi di annunci con la data di inizio applicata.

withStatus(string status)

Imposta lo stato del gruppo di annunci.

Argomenti

Nome Tipo Descrizione
stato Stringa Stato del gruppo di annunci. Di seguito sono riportati i possibili valori con distinzione tra maiuscole e minuscole.
  • ABILITATO
  • PAUSA
  • RIMOSSO
Il valore predefinito è PAUSED.

Restituisce

Tipo Descrizione
AdGroupBuilder Generatore di gruppi di annunci con lo stato applicato.

withTrackingTemplate(string trackingTemplate)

Imposta il modello di rilevamento del gruppo di annunci.

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 il gruppo di annunci.

Restituisce

Tipo Descrizione
AdGroupBuilder Generatore di gruppi di annunci con il modello di rilevamento applicato.

Vedere anche

Campaign.newAdGroupBuilder()