KeywordBuilder

Contiene i metodi per la definizione e la creazione di una parola chiave. Per informazioni sui generatori, vedere Generatori.

Nota

Tutte le parole chiave del modificatore di corrispondenza generale per gli annunci di ricerca ora fungono da parole chiave di corrispondenza generiche anziché come corrispondenza di frasi. Altre informazioni sui tipi di corrispondenza delle parole chiave.

Utilizzo di esempio:

    var operation = adGroup.newKeywordBuilder()
        .withText("KEYWORD TEXT GOES HERE")
        .withCpc(0.5)
        .withFinalUrl("http://www.contoso.com")
        .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 KeywordOperation Crea la parola chiave e restituisce un oggetto operazione utilizzato per verificare se la parola chiave è stata aggiunta correttamente.
withCpc(double cpc) KeywordBuilder Imposta l'offerta CPC massima della parola chiave.
withCustomParameters(Object customParameters) KeywordBuilder Imposta i parametri personalizzati della parola chiave.
withFinalUrl(string finalUrl) KeywordBuilder Imposta l'URL finale della parola chiave.
withMobileFinalUrl(string mobileFinalUrl) KeywordBuilder Imposta l'URL finale della parola chiave per i dispositivi mobili.
withText(string text) KeywordBuilder Imposta il testo della parola chiave.
withTrackingTemplate(string trackingTemplate) KeywordBuilder Imposta il modello di rilevamento della parola chiave.

compilazione

Crea la parola chiave e restituisce un oggetto operazione utilizzato per verificare se la parola chiave è stata aggiunta correttamente.

Restituisce

Tipo Descrizione
KeywordOperation Oggetto operazione utilizzato per verificare se la parola chiave è stata aggiunta correttamente.

withCpc(double cpc)

Imposta l'offerta CPC massima della parola chiave.

Specifica l'importo dell'offerta da utilizzare quando la parola chiave corrisponde al termine di ricerca dell'utente. Si applica solo se la strategia di offerta del gruppo di annunci è impostata su MANUAL_CPC.

Per usare l'importo dell'offerta specificato a livello di gruppo di annunci, non chiamare questo metodo.

Per altre informazioni sugli importi delle offerte, vedere Bid and BiddingScheme.For more information about bid amounts, see Bid and BiddingScheme.

Argomenti

Nome Tipo Descrizione
Cpc Doppia Offerta CPC massima da applicare alla parola chiave . La valuta del conto determina i valori minimo e massimo dell'offerta. Per altre informazioni, vedere Valute di offerta e budget.

Restituisce

Tipo Descrizione
KeywordBuilder Generatore di parole chiave con l'offerta CPC applicata.

withCustomParameters(Object customParameters)

Imposta i parametri personalizzati della parola chiave.

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 della parola chiave. 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
KeywordBuilder Generatore di parole chiave con i parametri personalizzati applicati.

withFinalUrl(string finalUrl)

Imposta l'URL finale della parola chiave.

L'URL finale identifica la pagina Web a cui l'utente viene indirizzato quando fa clic sull'annuncio. Se non specificato, l'entità eredita l'URL finale dall'entità padre. Ad esempio, l'entità parola chiave eredita l'URL finale dell'annuncio. Specificare l'URL finale della parola chiave per sostituire l'URL finale dell'annuncio.

Per altre informazioni, vedere Quali parametri di rilevamento o URL è possibile usare?

Argomenti

Nome Tipo Descrizione
finalUrl stringa L'URL finale che identifica la pagina Web a cui l'utente viene indirizzato quando fa clic sull'annuncio.

Restituisce

Tipo Descrizione
KeywordBuilder Generatore di parole chiave con l'URL finale applicato.

withMobileFinalUrl(string mobileFinalUrl)

Imposta l'URL finale della parola chiave per i dispositivi mobili.

L'URL finale identifica la pagina Web a cui l'utente viene indirizzato quando fa clic sull'annuncio. Se non specificato, l'entità eredita l'URL finale dall'entità padre. Ad esempio, l'entità parola chiave eredita l'URL finale dell'annuncio. Specificare l'URL finale della parola chiave se vuoi sostituire l'URL finale dell'annuncio.

Per altre informazioni, vedere Quali parametri di rilevamento o URL è possibile usare?

Per specificare un URL finale per i dispositivi mobili, specificare innanzitutto un URL finale per i dispositivi non mobili (vedere withFinalUrl()).

Argomenti

Nome Tipo Descrizione
mobileFinalUrl stringa URL finale per i dispositivi mobili.

Restituisce

Tipo Descrizione
KeywordBuilder Generatore di parole chiave con l'URL finale per dispositivi mobili applicato.

withText(string text)

Imposta il testo della parola chiave.

Per specificare il tipo di corrispondenza della parola chiave, usare la sintassi seguente:

  • Per la corrispondenza generale, usare la sintassi del tipo di corrispondenza , ad esempio keywordBuilder.withText("books").
  • Per il modificatore di corrispondenza generale, anteporre il testo con un segno più (+) (ad esempio, keywordBuilder.withText("+books")). Nota: se si tenta di creare nuove parole chiave BMM (Broad Match Modifier), queste verranno salvate e servite come parole chiave di corrispondenza di frasi. Le parole chiave BMM esistenti continueranno a funzionare con il comportamento di corrispondenza delle frasi. Altre informazioni sui tipi di corrispondenza delle parole chiave.
  • Per la corrispondenza di frasi, inserire le virgolette intorno al testo , keywordBuilder.withText("\"books\"")ad esempio .
  • Per la corrispondenza esatta, posizionare le parentesi quadre intorno al testo , keywordBuilder.withText("[hardcover books]")ad esempio .

Argomenti

Nome Tipo Descrizione
testo stringa Testo della parola chiave. Il testo della parola chiave è obbligatorio. Il testo può contenere un massimo di 100 caratteri. Specificare il testo nelle impostazioni locali del valore della lingua del gruppo di annunci.

Restituisce

Tipo Descrizione
KeywordBuilder Generatore di parole chiave con il testo della parola chiave applicato.

withTrackingTemplate(string trackingTemplate)

Imposta il modello di rilevamento della parola chiave.

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 questa parola chiave.

Restituisce

Tipo Descrizione
KeywordBuilder Generatore di parole chiave con il modello di rilevamento applicato.