URL delle parole chiave

Contiene i metodi per la gestione degli URL, del modello di monitoraggio e dei parametri personalizzati della parola chiave. Per informazioni, vedere Monitoraggio dell'URL con URL aggiornati.

Metodi

Nome metodo	Tipo restituito	Descrizione
clearFinalUrl	void	Rimuove l'URL finale della parola chiave.
clearMobileFinalUrl	void	Rimuove l'URL finale della parola chiave per i dispositivi mobili.
clearTrackingTemplate	void	Rimuove il modello di monitoraggio della parola chiave.
getCustomParameters	Oggetto	Ottiene i parametri personalizzati della parola chiave.
getFinalUrl	stringa	Ottiene l'URL finale della parola chiave.
getMobileFinalUrl	stringa	Ottiene l'URL finale della parola chiave per i dispositivi mobili.
getTrackingTemplate	stringa	Ottiene il modello di monitoraggio della parola chiave.
setCustomParameters(Oggetto customParameters)	void	Imposta i parametri personalizzati della parola chiave.
setFinalUrl(String finalUrl)	void	Imposta l'URL finale della parola chiave.
setMobileFinalUrl(String finalUrl)	void	Imposta l'URL finale della parola chiave per i dispositivi mobili.
setTrackingTemplate(String trackingTemplate)	void	Imposta il modello di monitoraggio della parola chiave.

clearFinalUrl

Rimuove l'URL finale della parola chiave.

Restituisce

Tipo	Descrizione
void	Non restituisce nulla.

clearMobileFinalUrl

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

Restituisce

Tipo	Descrizione
void	Non restituisce nulla.

clearTrackingTemplate

Rimuove il modello di monitoraggio della parola chiave.

Restituisce

Tipo	Descrizione
void	Non restituisce nulla.

getCustomParameters

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

Restituisce

Tipo	Descrizione
Oggetto	Mappa dei parametri personalizzati della parola chiave. Ad esempio, {key1: 'value1', key2: 'value2', key3: 'value3'}, dove chiave è il nome del parametro personalizzato e value è il valore del parametro.

getFinalUrl

Ottiene l'URL finale della parola chiave. URL della pagina Web a cui l'utente viene reindirizzato quando fa clic sull'annuncio.

Si applicano le stesse regole di sostituzione che si applicano altrove. Ad esempio, se si specifica l'URL finale di una parola chiave viene sostituito dall'URL finale dell'annuncio.

Restituisce

Tipo	Descrizione
stringa	URL finale della parola chiave.

getMobileFinalUrl

Ottiene l'URL finale della parola chiave per i dispositivi mobili. URL della pagina Web per dispositivi mobili a cui l'utente viene reindirizzato quando fa clic sull'annuncio.

Si applicano le stesse regole di sostituzione che si applicano altrove. Ad esempio, se si specifica l'URL finale mobile di una parola chiave viene sostituito dall'URL finale mobile dell'annuncio.

Restituisce

Tipo	Descrizione
stringa	URL finale della parola chiave per i dispositivi mobili.

getTrackingTemplate

Ottiene 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?

Restituisce

Tipo	Descrizione
stringa	Modello di monitoraggio della parola chiave.

setCustomParameters(Oggetto customParameters)

Imposta i parametri personalizzati della parola chiave. Usare questo metodo se l'URL finale o il modello di monitoraggio include stringhe di sostituzione personalizzate.

Per usare un nome di parametro cliente nell'URL finale o nel modello di monitoraggio, racchiudere il nome tra parentesi graffe e anteporre un carattere di sottolineatura (_) al nome. Se ad esempio il nome del parametro è foo, usare {_foo} nel modello di monitoraggio o nell'URL finale. Non aggiungere un carattere di sottolineatura iniziale al nome del parametro quando si definisce l'oggetto parametri personalizzati.

La chiamata a questo metodo sostituisce i parametri personalizzati esistenti della parola chiave.

Per cancellare i parametri personalizzati dalla parola chiave, passare un oggetto vuoto (ad esempio, setCustomParameters({})). Se si deselezionano i parametri personalizzati della parola chiave, la parola chiave eredita gli URL dal gruppo di annunci padre (se il gruppo di annunci specifica gli URL). Per cancellare completamente i parametri personalizzati, cancellarli a tutti i livelli della gerarchia.

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 usare nella 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 del parametro può contenere solo caratteri alfanumerici e il valore del parametro non può contenere spazi vuoti. 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
void	Non restituisce nulla.

setFinalUrl(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?

Se il valore della proprietà non è valido, la chiamata non riesce automaticamente. Per verificare se la proprietà è stata effettivamente aggiornata, recuperare l'oggetto e verificare se il valore della proprietà è uguale al nuovo valore. Per informazioni, vedere Gestione di errori e avvisi.

Argomenti

Nome	Tipo	Descrizione
url finale	stringa	URL finale della parola chiave.

Restituisce

Tipo	Descrizione
void	Non restituisce nulla.

setMobileFinalUrl(String finalUrl)

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 per 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 setFinalUrl()).

Se il valore della proprietà non è valido, la chiamata non riesce automaticamente. Per verificare se la proprietà è stata effettivamente aggiornata, recuperare l'oggetto e verificare se il valore della proprietà è uguale al nuovo valore. Per informazioni, vedere Gestione di errori e avvisi.

Argomenti

Nome	Tipo	Descrizione
url finale	stringa	URL finale della parola chiave, dispositivi mobili.

Restituisce

Tipo	Descrizione
void	Non restituisce nulla.

setTrackingTemplate(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?

Se il valore della proprietà non è valido, la chiamata ha esito negativo invisibile all'utente. Per verificare se la proprietà è stata effettivamente aggiornata, recuperare l'oggetto e verificare se il valore della proprietà è uguale al nuovo valore. Per informazioni, vedere Gestione di errori e avvisi.

Argomenti

Nome	Tipo	Descrizione
trackingTemplate	stringa	Modello di monitoraggio della parola chiave.

Restituisce

Tipo	Descrizione
void	Non restituisce nulla.