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