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. |