Condividi tramite

KeywordUrls

  • Articolo

Contiene i metodi per la gestione degli URL della parola chiave, del modello di rilevamento e dei parametri personalizzati. Per informazioni, vedere Rilevamento url con URL aggiornati.

Metodi

Nome metodo Tipo restituito Descrizione
clearFinalUrl Vuoto Rimuove l'URL finale della parola chiave.
clearMobileFinalUrl Vuoto Rimuove l'URL finale della parola chiave per i dispositivi mobili.
clearTrackingTemplate Vuoto Rimuove il modello di rilevamento 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 rilevamento della parola chiave.
setCustomParameters(Object customParameters) Vuoto Imposta i parametri personalizzati della parola chiave.
setFinalUrl(String finalUrl) Vuoto Imposta l'URL finale della parola chiave.
setMobileFinalUrl(String finalUrl) Vuoto Imposta l'URL finale della parola chiave per dispositivi mobili.
setTrackingTemplate(String trackingTemplate) Vuoto Imposta il modello di rilevamento della parola chiave.

clearFinalUrl

Rimuove l'URL finale della parola chiave.

Restituisce

Tipo Descrizione
Vuoto Non restituisce nulla.

clearMobileFinalUrl

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

Restituisce

Tipo Descrizione
Vuoto Non restituisce nulla.

clearTrackingTemplate

Rimuove il modello di rilevamento della parola chiave.

Restituisce

Tipo Descrizione
Vuoto Non restituisce nulla.

getCustomParameters

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

Restituisce

Tipo Descrizione
Oggetto Mappa dei parametri personalizzati della parola chiave.

Ad esempio, {key1: 'value1', key2: 'value2', key3: 'value3'}, dove key è il nome del parametro personalizzato e il valore è il valore del parametro.

getFinalUrl

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

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

Restituisce

Tipo Descrizione
stringa URL finale della parola chiave.

getMobileFinalUrl

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

Le stesse regole di sostituzione si applicano come altrove. Ad esempio, se si specifica l'URL finale per dispositivi mobili di una parola chiave, l'URL finale dell'annuncio per dispositivi mobili viene sostituito.

Restituisce

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

getTrackingTemplate

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

Restituisce

Tipo Descrizione
stringa Modello di rilevamento della parola chiave.

setCustomParameters(Object customParameters)

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

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

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

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

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 un massimo di tre parametri personalizzati da usare nella parola chiave . Ad esempio, {key1: 'value1', key2: 'value2', key3: 'value3'}, dove key è il nome del parametro personalizzato e il valore è il valore del parametro. Il nome del parametro può contenere solo caratteri alfanumerici e il valore del parametro potrebbe non 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
Vuoto 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 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?

Se il valore della proprietà non è valido, la chiamata non riesce in modo automatico. Per verificare se la proprietà è stata effettivamente aggiornata, ottenere di nuovo 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
finalUrl stringa URL finale della parola chiave.

Restituisce

Tipo Descrizione
Vuoto 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 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?

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

Se il valore della proprietà non è valido, la chiamata non riesce in modo automatico. Per verificare se la proprietà è stata effettivamente aggiornata, ottenere di nuovo 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
finalUrl stringa Dispositivi mobili URL finali della parola chiave.

Restituisce

Tipo Descrizione
Vuoto Non restituisce nulla.

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

Se il valore della proprietà non è valido, la chiamata non riesce in modo automatico. Per verificare se la proprietà è stata effettivamente aggiornata, ottenere di nuovo 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 rilevamento della parola chiave.

Restituisce

Tipo Descrizione
Vuoto Non restituisce nulla.