Parola chiave

Contiene i metodi per la gestione di una parola chiave. Per informazioni sulle parole chiave, vedere Parola chiave.

Metodi

Nome metodo Tipo restituito Descrizione
adParams AdParamSelector Ottiene un selettore utilizzato per ottenere tutti i parametri di sostituzione usati nell'annuncio per questa parola chiave.
applyLabel(string name) Vuoto Applica l'etichetta a questa parola chiave.
Offerta KeywordBidding Ottiene i metodi utilizzati per gestire l'importo dell'offerta di questa parola chiave.
clearDestinationUrl Vuoto Rimuove l'URL di destinazione di questa parola chiave.
Attivare Vuoto Abilita questa parola chiave.
getAdGroup AdGroup Ottiene il gruppo di annunci a cui appartiene questa parola chiave.
getApprovalStatus stringa Ottiene lo stato di approvazione editoriale di questa parola chiave.
getCampaign Campagna Ottiene la campagna a cui appartiene questa parola chiave.
getEntityType stringa Ottiene il tipo di questa entità.
getFirstPageCpc Doppia Ottiene l'offerta stimata necessaria per essere nella prima pagina dei risultati della ricerca.
getId stringa Ottiene l'ID che identifica in modo univoco questa parola chiave.
getMatchType stringa Ottiene il tipo di corrispondenza di questa parola chiave.
getQualityScore Intero Ottiene il punteggio di qualità di questa parola chiave.
getStats Statistiche Ottiene i dati sulle prestazioni di questa parola chiave.
Gettext stringa Ottiene il testo della parola chiave.
getTopOfPageCpc Doppia Ottiene l'offerta stimata necessaria per essere nella parte superiore dei risultati della ricerca.
Isenabled Booleano Ottiene un valore booleano che indica se questa parola chiave è abilitata.
isPaused Booleano Ottiene un valore booleano che indica se questa parola chiave è sospesa.
Etichette LabelSelector Ottiene un selettore utilizzato per filtrare l'elenco di etichette associate a questa parola chiave.
Pausa Vuoto Sospende questa parola chiave.
Rimuovere Vuoto Rimuove questa parola chiave.
removeLabel(string name) Vuoto Rimuove l'etichetta da questa parola chiave.
setAdParam(int index, string insertionText) Vuoto Aggiunge il parametro di sostituzione e ne imposta il valore sul testo specificato.
Url KeywordUrls Ottiene i metodi utilizzati per gestire gli URL finali, il modello di rilevamento e i parametri personalizzati di queste parole chiave.

adParams

Ottiene un selettore di tutti i parametri di sostituzione usati negli annunci per questa parola chiave.

I valori di sostituzione vengono usati in un annuncio se il titolo, il testo, l'URL visualizzato o l'URL di destinazione dell'annuncio contiene la stringa di sostituzione dinamica {Param1}, {Param2}o {Param3}.

Restituisce

Tipo Descrizione
AdParamSelector Selettore che contiene l'elenco dei parametri di sostituzione per questa parola chiave.

applyLabel(string name)

Applica l'etichetta alla parola chiave .

È possibile applicare un massimo di 50 etichette a una parola chiave. Per un esempio che aggiunge un'etichetta a una parola chiave, vedere Uso delle etichette.

Argomenti

Nome Tipo Descrizione
Nome stringa Nome con distinzione tra maiuscole e minuscole dell'etichetta. Per ottenere un elenco di etichette in questo account che è possibile applicare, vedere AdsApp.labels.

Restituisce

Tipo Descrizione
Vuoto Non restituisce nulla.

Offerta

Ottiene i metodi utilizzati per gestire l'importo dell'offerta di questa parola chiave.

Restituisce

Tipo Descrizione
KeywordBidding Contiene i metodi usati per gestire l'importo dell'offerta di questa parola chiave.

clearDestinationUrl

Rimuove l'URL di destinazione di questa parola chiave.

Restituisce

Tipo Descrizione
Vuoto Non restituisce nulla.

Attivare

Abilita questa parola chiave.

Restituisce

Tipo Descrizione
Vuoto Non restituisce nulla.

getAdGroup

Ottiene il gruppo di annunci a cui appartiene questa parola chiave.

Restituisce

Tipo Descrizione
AdGroup Gruppo di annunci a cui appartiene questa parola chiave.

getApprovalStatus

Ottiene lo stato di approvazione editoriale di questa parola chiave.

Restituisce

Tipo Descrizione
stringa Stato di approvazione editoriale della parola chiave. Lo stato indica se la parola chiave è in fase di revisione, è approvata o non è consentita. I valori possibili sono:
  • APPROVATO
  • APPROVED_LIMITED
  • APPROVATO
  • UNDER_REVIEW
Per informazioni sul mapping di questi valori di stato all'API Bing Ads, vedere Mapping dei valori dello stato di approvazione editoriale.

getCampaign

Ottiene la campagna a cui appartiene questa parola chiave.

Restituisce

Tipo Descrizione
Campagna Campagna a cui appartiene questa parola chiave.

getEntityType

Restituisce il tipo di questa entità.

Restituisce

Tipo Descrizione
stringa Tipo di questa entità, ovvero Parola chiave.

getId

Ottiene l'ID che identifica in modo univoco questa parola chiave.

Restituisce

Tipo Descrizione
stringa ID che identifica in modo univoco questa parola chiave.

getFirstPageCpc

Ottiene l'offerta stimata necessaria per la visualizzazione dell'annuncio sulla barra laterale.

Restituisce

Tipo Descrizione
Doppia Offerta stimata necessaria per la visualizzazione dell'annuncio sulla barra laterale.

getMatchType

Ottiene il tipo di corrispondenza di questa parola chiave.

Restituisce

Tipo Descrizione
stringa Tipo di corrispondenza della parola chiave. I valori possibili sono:
  • AMPIO
  • FRASE
  • ESATTA
Per informazioni su questi tipi, vedere Che cosa sono i tipi di corrispondenza delle parole chiave e come usarli?

getQualityScore

Ottiene il punteggio di qualità di questa parola chiave.

Restituisce

Tipo Descrizione
Intero Punteggio di qualità della parola chiave. Il punteggio è compreso nell'intervallo da 1 a 10 (massimo). Se non è possibile calcolare il punteggio di qualità della parola chiave, questo metodo restituisce NULL.

Il punteggio mostra quanto sono competitivi i tuoi annunci nel marketplace misurando quanto siano rilevanti le parole chiave e le pagine di destinazione per i termini di ricerca dei clienti. Per altre informazioni, vedere Rapporto sulle prestazioni delle parole chiave.

getStats

Ottiene i dati sulle prestazioni di queste parole chiave.

Per chiamare questo metodo, è necessario includere uno dei forDateRange metodi nella catena del selettore di parole chiave .

Restituisce

Tipo Descrizione
Statistiche Dati sulle prestazioni della parola chiave. Ad esempio, clic e impressioni.

Gettext

Ottiene il testo della parola chiave. Il testo include la sintassi del tipo di corrispondenza della parola chiave, se disponibile. Ad esempio:

  • La parola chiave è books se il tipo di corrispondenza è ampio o +books se la parola chiave usa il modificatore di tipo broad
  • La parola chiave è "books" se il tipo di corrispondenza è frase
  • La parola chiave è [hardcover books] se il tipo di corrispondenza è esatto

Per informazioni su questi tipi, vedere Che cosa sono i tipi di corrispondenza delle parole chiave e come usarli?

Restituisce

Tipo Descrizione
stringa Testo della parola chiave.

getTopOfPageCpc

Ottiene l'offerta stimata necessaria per la visualizzazione dell'annuncio sopra i risultati della ricerca organica.

Restituisce

Tipo Descrizione
Doppia L'offerta stimata necessaria per la visualizzazione dell'annuncio sopra i risultati della ricerca organica.

Isenabled

Ottiene un valore booleano che indica se questa parola chiave è abilitata.

Restituisce

Tipo Descrizione
Booleano È true se questa parola chiave è abilitata; in caso contrario, false.

isPaused

Ottiene un valore booleano che indica se questa parola chiave è sospesa.

Restituisce

Tipo Descrizione
Booleano È true se questa parola chiave è sospesa; in caso contrario, false.

Etichette

Ottiene un selettore utilizzato per filtrare l'elenco di etichette associate a questa parola chiave.

Restituisce

Tipo Descrizione
LabelSelector Selettore utilizzato per filtrare l'elenco di etichette associate a questa parola chiave.

Pausa

Sospende questa parola chiave.

Restituisce

Tipo Descrizione
Vuoto Non restituisce nulla.

rimuovere

Rimuove questa parola chiave.

Restituisce

Tipo Descrizione
Vuoto Non restituisce nulla.

removeLabel(string name)

Rimuove l'etichetta dalla parola chiave .

Argomenti

Nome Tipo Descrizione
Nome stringa Nome con distinzione tra maiuscole e minuscole dell'etichetta. Per ottenere un elenco di etichette associate a questa parola chiave, vedere etichette.

Restituisce

Tipo Descrizione
Vuoto Non restituisce nulla.

setAdParam(int index, string insertionText)

Aggiunge il parametro di sostituzione e ne imposta il valore sul testo specificato. Se il parametro di sostituzione esiste, il testo viene sovrascritto.

I valori di sostituzione vengono usati in un annuncio se il titolo, il testo, l'URL visualizzato o l'URL finale dell'annuncio contiene le stringhe di sostituzione dinamica {Param1}, {Param2}o {Param3}. Per restrizioni e informazioni sull'uso di questi parametri, vedere Param1, Param2 e Param3.

I valori di sostituzione vengono usati anche nel modello di rilevamento se il modello specifica i segnaposto {param1:default}, {param2:default}o {param3:default}.

Argomenti

Nome Tipo Descrizione
Indice int Indice del parametro di sostituzione da impostare. I valori di indice validi sono compresi tra 1 e 3 inclusi. Usare 1 per Param1, 2 per Param2 e 3 per Param3.
insertionText stringa Testo su cui impostare il parametro di sostituzione.

Restituisce

Tipo Descrizione
Vuoto Non restituisce nulla.

Url

Ottiene i metodi utilizzati per gestire gli URL finali, il modello di rilevamento e i parametri personalizzati di queste parole chiave.

Restituisce

Tipo Descrizione
KeywordUrls Contiene i metodi utilizzati per gli URL finali della parola chiave, il modello di rilevamento e i parametri personalizzati.

Vedere anche