AdGroupBuilder

Contiene i metodi utilizzati per definire e aggiungere un gruppo di annunci. Per informazioni sui costruttori, consulta Costruttori.

Esempio di utilizzo:

    // 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
compilazione AdGroupOperation Crea il gruppo di annunci e restituisce un oggetto operazione utilizzato per verificare se il gruppo di annunci è stato aggiunto correttamente.
withBiddingStrategy(string biddingStrategy) AdGroupBuilder Imposta la strategia di offerta del gruppo di annunci.
conCpc (doppio cpc) AdGroupBuilder Imposta l'offerta CPC massima del gruppo di annunci.
withCpm(doppio cpm) AdGroupBuilder Imposta l'offerta CPM massima del gruppo di annunci.
withCpv(doppio cpv) AdGroupBuilder Imposta l'offerta CPV massima del gruppo di annunci.
withCustomParameters(Object customParameters) AdGroupBuilder Imposta i parametri personalizzati del gruppo di annunci.
withEndDate(stringa endDate) AdGroupBuilder Imposta la data in cui gli annunci del gruppo di annunci smettono di essere pubblicati.
withEndDate(Object endDate) AdGroupBuilder Imposta la data in cui gli annunci del gruppo di annunci smettono di essere pubblicati.
withLanguage(lingua stringa) AdGroupBuilder Imposta la lingua utilizzata da questo gruppo di annunci.
withName(nome stringa) AdGroupBuilder Imposta il nome del gruppo di annunci.
withStartDate(stringa startDate) AdGroupBuilder Imposta la data in cui gli annunci del gruppo di annunci iniziano a essere pubblicati.
withStartDate(Object startDate) AdGroupBuilder Imposta la data in cui gli annunci del 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 monitoraggio del gruppo di annunci.

compilazione

Crea il gruppo di annunci e restituisce un oggetto operazione utilizzato 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.

conCpc (doppio cpc)

Imposta l'offerta CPC del gruppo di annunci.

Specifica l'importo dell'offerta da utilizzare 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 utilizzata se un'entità di livello inferiore, ad esempio parola chiave, non la sostituisce.

Argomenti

Nome Tipo Descrizione
CPC doppia Offerta CPC massima del gruppo di annunci. La valuta dell'account determina i valori minimo e massimo dell'offerta. Per ulteriori informazioni, vedere Valute offerte e budget.

Restituisce

Tipo Descrizione
AdGroupBuilder Generatore di gruppi di annunci con l'offerta CPC applicata.

withCpm(doppio cpm)

Imposta l'offerta CPM del gruppo di annunci.

Specifica l'importo dell'offerta da utilizzare per 1.000 impressioni 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 dell'account determina i valori minimo e massimo dell'offerta. Per ulteriori informazioni, vedere Valute offerte e budget.

Restituisce

Tipo Descrizione
AdGroupBuilder Generatore di gruppi di annunci con l'offerta CPM applicata.

withCpv(doppio cpv)

Imposta l'offerta CPV del gruppo di annunci.

Specifica l'importo dell'offerta da utilizzare per ciascuna visualizzazione o 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 CPV massima del gruppo di annunci. La valuta dell'account determina i valori minimo e massimo dell'offerta. Per ulteriori informazioni, vedere Valute offerte 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 utilizzare negli URL finali o nei modelli di monitoraggio.

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 tre parametri personalizzati da applicare al gruppo di annunci. 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
AdGroupBuilder Generatore di gruppi di annunci con parametri personalizzati applicati.

withEndDate(stringa endDate)

Imposta la data in cui gli annunci del gruppo di annunci smettono di essere pubblicati. Utilizzare questo metodo solo se si desidera interrompere la visualizzazione degli annunci del gruppo in una data specifica.

Argomenti

Nome Tipo Descrizione
data di fine stringa Data in cui non pubblicare più annunci. Specificare la data nel modulo, AAAAMMGG.

Restituisce

Tipo Descrizione
AdGroupBuilder Generatore di gruppi di annunci con data di fine applicata.

withEndDate(Object endDate)

Imposta la data in cui gli annunci del gruppo di annunci smettono di essere pubblicati. Utilizzare questo metodo solo se si desidera interrompere la visualizzazione degli annunci del gruppo in una data specifica.

Argomenti

Nome Tipo Descrizione
data di fine Oggetto Data in cui non pubblicare più annunci. Specificare la data utilizzando un oggetto con i campi seguenti:
  • anno
  • mese
  • giorno

Ad esempio: var date = {year: 2018, month: 5, day: 13};

Il mese è a base unica, dove 1 è gennaio e 12 è dicembre.

Restituisce

Tipo Descrizione
AdGroupBuilder Generatore di gruppi di annunci con data di fine applicata.

withLanguage(lingua stringa)

Imposta la lingua utilizzata 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 nel caso in cui la campagna non specifichi una lingua (la lingua deve essere specificata a livello di campagna e/o di gruppo di annunci).

Argomenti

Nome Tipo Descrizione
Lingua stringa Lingua utilizzata dagli annunci del gruppo di annunci. Ad esempio, l'inglese. Per la stringa non viene fatta distinzione tra maiuscole e minuscole. Non utilizzare un codice lingua 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(nome stringa)

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 al massimo 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(stringa startDate)

Imposta la data in cui gli annunci del gruppo di annunci iniziano a essere pubblicati. Chiama questo metodo solo se vuoi che gli annunci del gruppo inizino a essere pubblicati in una data specifica; In caso contrario, gli annunci vengono pubblicati immediatamente.

Argomenti

Nome Tipo Descrizione
data di fine stringa La data in cui iniziare a pubblicare gli 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 del gruppo di annunci iniziano a essere pubblicati. Chiama questo metodo solo se vuoi che gli annunci del gruppo inizino a essere pubblicati in una data specifica; In caso contrario, gli annunci vengono pubblicati immediatamente.

Argomenti

Nome Tipo Descrizione
data di fine Oggetto La data in cui iniziare a pubblicare gli annunci. Specificare la data utilizzando un oggetto con i campi seguenti:
  • anno
  • mese
  • giorno

Ad esempio: var date = {year: 2018, month: 5, day: 13};

Il mese è a base unica, 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
L'impostazione predefinita è PAUSA.

Restituisce

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

withTrackingTemplate(string trackingTemplate)

Imposta il modello di monitoraggio del gruppo di annunci.

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

Restituisce

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

Vedere anche

Campaign.newAdGroupBuilder()

  • Ultimo aggiornamento: