Parola chiave

Contiene i metodi per gestire una parola chiave. Per informazioni sulle parole chiave, vedere Parola chiave.

Metodi

Nome metodo Tipo restituito Descrizione
adParams AdParamSelector Usa un selettore per ottenere tutti i parametri di sostituzione usati nell'annuncio per questa parola chiave.
applyLabel(nome stringa) void Applica l'etichetta a questa parola chiave.
Offerte KeywordBidding Ottiene i metodi usati per gestire l'importo dell'offerta della parola chiave.
clearDestinationUrl void Rimuove l'URL di destinazione della parola chiave.
Abilita void Abilita questa parola chiave.
getAdGroup Gruppo annunci Ottiene il gruppo di annunci a cui appartiene questa parola chiave.
getApprovalStatus stringa Ottiene lo stato di approvazione editoriale della 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 la parola chiave.
getMatchType stringa Ottiene il tipo di corrispondenza di questa parola chiave.
getQualityScore integer Ottiene il punteggio di qualità della parola chiave.
getStats Statistiche Ottiene i dati sul rendimento della parola chiave.
getText stringa Ottiene il testo della parola chiave.
getTopOfPageCpc doppia Ottiene l'offerta stimata necessaria per essere in cima ai risultati della ricerca.
isEnabled Booleano Ottiene un valore booleano che indica se la parola chiave è abilitata.
isIn pausa Booleano Ottiene un valore booleano che indica se la parola chiave è sospesa.
etichette LabelSelector Usa un selettore per filtrare l'elenco di etichette associate alla parola chiave.
pausa void Mette in pausa questa parola chiave.
remove (rimuovi) void Rimuove questa parola chiave.
removeLabel(nome stringa) void Rimuove l'etichetta da questa parola chiave.
setAdParam(int index, string insertionText) void Aggiunge il parametro substitution e imposta il relativo valore sul testo specificato.
URL URL delle parole chiave Consente di ottenere i metodi usati per gestire gli URL finali, il modello di monitoraggio e i parametri personalizzati delle parole chiave.

adParams

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

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

Restituisce

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

applyLabel(nome stringa)

Applica l'etichetta alla parola chiave.

A una parola chiave possono essere applicate al massimo 50 etichette. Per un esempio che aggiunge un'etichetta a una parola chiave, consulta Utilizzo delle etichette.

Argomenti

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

Restituisce

Tipo Descrizione
void Non restituisce nulla.

Offerte

Ottiene i metodi usati per gestire l'importo dell'offerta della parola chiave.

Restituisce

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

clearDestinationUrl

Rimuove l'URL di destinazione della parola chiave.

Restituisce

Tipo Descrizione
void Non restituisce nulla.

Abilita

Abilita questa parola chiave.

Restituisce

Tipo Descrizione
void Non restituisce nulla.

getAdGroup

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

Restituisce

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

getApprovalStatus

Ottiene lo stato di approvazione editoriale della 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
  • NON APPROVATO
  • UNDER_REVIEW
Per informazioni sul mapping di questi valori di stato all'API di 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 dell'entità.

Restituisce

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

getId

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

Restituisce

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

getFirstPageCpc

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

Restituisce

Tipo Descrizione
doppia L'offerta stimata necessaria per visualizzare l'annuncio nella 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:
  • AMPIA
  • A FRASE
  • ESATTA
Per informazioni su questi tipi, vedere Che cosa sono i tipi di corrispondenza per parole chiave e come vengono utilizzati?

getQualityScore

Ottiene il punteggio di qualità della parola chiave.

Restituisce

Tipo Descrizione
integer Punteggio di qualità della parola chiave. Il punteggio è compreso tra 1 e 10 (il più alto). Se non è possibile calcolare il punteggio di qualità della parola chiave, questo metodo restituisce NULL.

Il punteggio indica il livello di competitività degli annunci nel marketplace, ottenuto attraverso la valutazione del grado di pertinenza delle parole chiave e delle pagine di destinazione rispetto ai termini di ricerca dei clienti. Per ulteriori informazioni, vedere Report sul rendimento delle parole chiave.

getStats

Ottiene le parole chiave sui dati sul rendimento.

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

Restituisce

Tipo Descrizione
Statistiche Dati sul rendimento 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 presente. Ad esempio:

  • La parola chiave è libri se il tipo di corrispondenza è ampio oppure +libri se la parola chiave usa il modificatore di tipo ampio
  • La parola chiave è "libri" se il tipo di corrispondenza è la frase
  • La parola chiave è [libri con copertina rigida] se il tipo di corrispondenza è esatto

Per informazioni su questi tipi, vedere Che cosa sono i tipi di corrispondenza per parole chiave e come vengono utilizzati?

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 visualizzare l'annuncio sopra i risultati della ricerca organica.

isEnabled

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

Restituisce

Tipo Descrizione
Booleano Restituisce true se la parola chiave è abilitata. In caso contrario, false.

isIn pausa

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

Restituisce

Tipo Descrizione
Booleano È vero se questa parola chiave viene sospesa; In caso contrario, false.

etichette

Usa un selettore per filtrare l'elenco di etichette associate alla parola chiave.

Restituisce

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

pausa

Mette in pausa questa parola chiave.

Restituisce

Tipo Descrizione
void Non restituisce nulla.

rimuovere

Rimuove questa parola chiave.

Restituisce

Tipo Descrizione
void Non restituisce nulla.

removeLabel(nome stringa)

Rimuove l'etichetta dalla parola chiave.

Argomenti

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

Restituisce

Tipo Descrizione
void Non restituisce nulla.

setAdParam(int index, string insertionText)

Aggiunge il parametro substitution e imposta il relativo 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 di visualizzazione o l'URL finale dell'annuncio contengono 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 monitoraggio se il modello specifica i segnaposto {param1:default}, {param2:default} o {param3:default}.

Argomenti

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

Restituisce

Tipo Descrizione
void Non restituisce nulla.

URL

Consente di ottenere i metodi usati per gestire gli URL finali, il modello di monitoraggio e i parametri personalizzati delle parole chiave.

Restituisce

Tipo Descrizione
URL delle parole chiave Contiene i metodi usati, gli URL finali della parola chiave, il modello di monitoraggio e i parametri personalizzati.

Vedere anche

  • Ultimo aggiornamento: