Generatore di parole chiave

Contiene i metodi per la definizione e la creazione di una parola chiave. Per informazioni sui costruttori, consulta Costruttori.

Nota

Tutte le parole chiave con modificatore di corrispondenza generica per gli annunci di ricerca ora fungono da parole chiave con corrispondenza generica anziché corrispondenza a frase. Ulteriori informazioni sui tipi di corrispondenza con parole chiave.

Esempio di utilizzo:

    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
compilazione	KeywordOperation	Crea la parola chiave e restituisce un oggetto operazione utilizzato per verificare se la parola chiave è stata aggiunta correttamente.
conCpc (doppio cpc)	Generatore di parole chiave	Imposta l'offerta CPC massima della parola chiave.
withCustomParameters(Object customParameters)	Generatore di parole chiave	Imposta i parametri personalizzati della parola chiave.
withFinalUrl(string finalUrl)	Generatore di parole chiave	Imposta l'URL finale della parola chiave.
withMobileFinalUrl(string mobileFinalUrl)	Generatore di parole chiave	Imposta l'URL finale della parola chiave per i dispositivi mobili.
withText(testo stringa)	Generatore di parole chiave	Imposta il testo della parola chiave.
withTrackingTemplate(string trackingTemplate)	Generatore di parole chiave	Imposta il modello di monitoraggio 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 usato per verificare se la parola chiave è stata aggiunta correttamente.

conCpc (doppio 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 utilizzare l'importo dell'offerta specificato a livello di gruppo di annunci, non utilizzare questo metodo.

Per ulteriori informazioni sugli importi delle offerte, vedere Bid e BiddingScheme.

Argomenti

Nome	Tipo	Descrizione
CPC	doppia	Offerta CPC massima da applicare alla parola chiave. La valuta dell'account determina i valori minimo e massimo dell'offerta. Per ulteriori informazioni, vedere Valute offerte e budget.

Restituisce

Tipo	Descrizione
Generatore di parole chiave	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 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 della parola chiave. 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
Generatore di parole chiave	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 viene 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 ulteriori informazioni, vedere Quali parametri di monitoraggio o di URL è possibile utilizzare?

Argomenti

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

Restituisce

Tipo	Descrizione
Generatore di parole chiave	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 viene 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 si desidera sostituire l'URL finale dell'annuncio.

Per ulteriori informazioni, vedere Quali parametri di monitoraggio o di URL è possibile utilizzare?

Per specificare un URL finale per i dispositivi mobili, specificare prima 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
Generatore di parole chiave	Generatore di parole chiave con l'URL finale mobile applicato.

withText(testo stringa)

Imposta il testo della parola chiave.

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

• Per la corrispondenza generica, non utilizzare la sintassi del tipo di corrispondenza (ad esempio, keywordBuilder.withText("books")).
• Per il modificatore di corrispondenza generica, anteporre al testo un segno più (+) (ad esempio, keywordBuilder.withText("+books")). Nota: i modificatori BMM (Broad Match Modifier) importati verranno salvati e serviti come parole chiave di corrispondenza di frase. Le parole chiave BMM esistenti continueranno a essere usate nel comportamento di corrispondenza delle frasi. Ulteriori informazioni sui tipi di corrispondenza con parole chiave.
• Per la corrispondenza a frase, racchiudere il testo tra virgolette, keywordBuilder.withText("\"books\"")ad esempio .
• Per una corrispondenza esatta, racchiudere il testo tra parentesi quadre, 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. Specifica il testo nelle impostazioni locali del valore della lingua del gruppo di annunci.

Restituisce

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

withTrackingTemplate(string trackingTemplate)

Imposta il modello di monitoraggio della parola chiave.

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

Restituisce

Tipo	Descrizione
Generatore di parole chiave	Generatore di parole chiave con il modello di monitoraggio applicato.