KeywordSelector

Contiene i metodi per filtrare e ordinare un elenco di parole chiave. Per informazioni sui selettori, vedere Selettori.

Esempio di utilizzo:

    var iterator = AdsApp.keywords()
        .withCondition("AdGroupName = 'AD GROUP NAME GOES HERE'")
        .withCondition("CampaignName = 'CAMPAIGN NAME GOES HERE'")
        .get();

    while (iterator.hasNext()) {
        var keyword = iterator.next();
    }

Metodi

Nome metodo Tipo restituito Descrizione
forDateRange(Oggetto dateFrom, Oggetto dateTo) KeywordSelector Applica le date di inizio e di fine per la selezione delle metriche del rendimento.
forDateRange(stringa dateRange) KeywordSelector Applica l'intervallo di date predefinito per la selezione delle metriche del rendimento.
Ottieni KeywordIterator Ottiene un iteratore utilizzato per scorrere l'elenco di parole chiave.
orderBy(stringa orderBy) KeywordSelector Applica l'ordinamento specificato alle parole chiave selezionate.
withCondition(condizione stringa) KeywordSelector Applica i criteri di filtro alle parole chiave.
withIds(string[] ids) KeywordSelector Ottiene le parole chiave con gli ID specificati.
withLimit(int limit) KeywordSelector Ottiene le prime n parole chiave che corrispondono ai criteri di selezione.

forDateRange(Oggetto dateFrom, Oggetto dateTo)

Applica le date di inizio e di fine per la selezione delle metriche del rendimento.

Specificare un intervallo di date solo se:

  • Applichi condizioni o ordini che fanno riferimento ai campi delle metriche delle prestazioni.
  • Si desidera ottenere dati sulle prestazioni per gli oggetti selezionati. Ad esempio, se si prevede di chiamare il getStats() metodo.

È possibile specificare i parametri di data usando stringhe o oggetti. Per usare le stringhe, specificare la data nel formato AAAAMMGG. Se si utilizzano oggetti, creare un oggetto con i campi seguenti:

  • anno
  • mese
  • giorno

Ad esempio:

var date = {year: 2018, month: 5, day: 13};

Il mese è a base unica, dove 1 è gennaio e 12 è dicembre.

L'intervallo di date è inclusivo. Se si specificano più intervalli di date, viene usato solo l'ultimo intervallo di date.

Argomenti

Nome Tipo Descrizione
dateFrom Oggetto Data di inizio dell'intervallo di date che specifica i dati sulle prestazioni da includere nel selettore.
dateTo Oggetto Data di fine dell'intervallo di date che specifica i dati sulle prestazioni da includere nel selettore.

Restituisce

Tipo Descrizione
KeywordSelector Selettore con intervallo di date applicato.

forDateRange(String dateRange)

Applica l'intervallo di date predefinito per la selezione delle metriche del rendimento.

Valori dell'intervallo di date supportato:

  • OGGI
  • IERI
  • LAST_WEEK
  • LAST_BUSINESS_WEEK
  • LAST_7_DAYS
  • THIS_WEEK_SUN_TODAY
  • LAST_14_DAYS
  • LAST_30_DAYS
  • LAST_WEEK_SUN_SAT
  • THIS_MONTH
  • LAST_MONTH
  • ALL_TIME

Specificare un intervallo di date solo se:

  • Applichi condizioni o ordini che fanno riferimento ai campi delle metriche delle prestazioni.
  • Si desidera ottenere dati sulle prestazioni per gli oggetti selezionati. Ad esempio, se si prevede di chiamare il getStats() metodo.

Se si specificano più intervalli di date, viene usato solo l'ultimo intervallo di date.

Argomenti

Nome Tipo Descrizione
dateRange Stringa Stringa dell'intervallo di date predefinito che specifica i dati sul rendimento da includere nel selettore. Per la stringa dell'intervallo di date predefinito viene fatta distinzione tra maiuscole e minuscole.

Restituisce

Tipo Descrizione
KeywordSelector Selettore con intervallo di date applicato.

Ottieni

Ottiene un iteratore utilizzato per scorrere l'elenco di parole chiave.

Restituisce

Tipo Descrizione
KeywordIterator Iteratore utilizzato per scorrere le parole chiave selezionate.

orderBy(stringa orderBy)

Applica l'ordinamento specificato alle parole chiave selezionate.

Specificare il parametro orderBy nel modulo "columnName orderDirection" dove:

  • columnName è una delle colonne supportate.
  • orderDirection è l'ordine in cui ordinare i risultati. Impostate su ASC per ordinare i risultati in ordine crescente o DESC per ordinare i risultati in ordine decrescente. L'impostazione predefinita è ASC.

Ad esempio, la chiamata seguente restituisce i risultati in ordine crescente per AverageCpc.

selector = selector.orderBy("AverageCpc");

I selettori supportano l'ordinamento delle entità in base a un solo campo. Non è possibile ordinare l'elenco delle entità in base al campo x e all'interno di x in base al campo y e così via. Se si specificano orderBy() più chiamate in una catena o in chiamate di selezione separate, Scripts ordina l'elenco delle entità utilizzando il campo specificato nell'ultima orderBy() chiamata. 

Argomenti

Nome Tipo Descrizione
orderBy stringa Ordine da applicare.

Restituisce

Tipo Descrizione
KeywordSelector Selettore con ordinamento applicato.

withCondition(condizione stringa)

Applica i criteri di filtro alle parole chiave.

Specificare il parametro condizione nel formato "valore operatore columnName" dove:

Operatori

L'operatore da usare dipende dal tipo di colonna. Negli operatori viene fatta distinzione tra maiuscole e minuscole. Ad esempio, usare STARTS_WITH invece di starts_with.

Operatori per le colonne che contengono numeri interi e lunghi:

<
<=
>
>=
=
!=

Operatori per le colonne che contengono valori double:

<
>

Operatori per le colonne che contengono valori stringa:

=
!=
STARTS_WITH
STARTS_WITH_IGNORE_CASE
CONTAINS
CONTAINS_IGNORE_CASE
DOES_NOT_CONTAIN
DOES_NOT_CONTAIN_IGNORE_CASE

Operatori per le colonne che contengono valori di enumerazione:

=
!=
IN []
NOT_IN []

Operatori per le colonne che contengono una matrice di stringhe:

CONTAINS_ALL
CONTAINS_ANY
CONTAINS_NONE

Colonne supportate per il filtro delle parole chiave. Nei nomi delle colonne viene fatta distinzione tra maiuscole e minuscole.

Di seguito sono riportate le colonne delle metriche delle prestazioni che è possibile specificare.

Colonna Tipo Esempio Filtro interfaccia utente Web di Microsoft Advertising
AbsoluteTopImpressionRate doppia withCondition("AbsoluteTopImpressionRate > 0.25") Abs. Top Impr. Tasso
AverageCpc doppia withCondition("AverageCpc < 2.75") CPC medio
AverageCpm doppia withCondition("AverageCpm > 0.65") CPM medio
ClickConversionRate doppia withCondition("ClickConversionRate > 0.25") Tasso di conv.
Clic long withCondition("Clicks >= 33") Clic
ConvertedClicks long withCondition("ConvertedClicks >= 10") Conv.
Costo doppia withCondition("Cost > 3.25")

Il costo è nella valuta dell'account.		 Spesa
CTR doppia withCondition("Ctr > 0.05")

Il CTR è nell'intervallo 0..1, quindi usa 0.05 per un CTR del 5%.		 CTR
Impression long withCondition("Impressions > 10") Impr.
TopImpressionRate doppia withCondition("TopImpressionRate > 0.25") Top Impr. Tasso

Di seguito sono riportate le proprietà dell'entità che è possibile specificare.

Colonna Tipo Esempio Filtro interfaccia utente Web di Microsoft Advertising
Stato Enumerazione Stato della parola chiave. I valori possibili con distinzione tra maiuscole e minuscole sono:
  • ABILITATO
  • Pausa
  • RIMOSSO
withCondition("Status = ENABLED")		 Stato
CombinedApprovalStatus stringa Stato di approvazione della parola chiave. I valori possibili con distinzione tra maiuscole e minuscole sono:
  • APPROVATO
  • APPROVED_LIMITED
  • UNDER_REVIEW
  • NON APPROVATO
Per informazioni su questi valori, vedere Valori dello stato di approvazione editoriale.

In questo esempio vengono restituite parole chiave che richiedono attenzione.

withCondition("CombinedApprovalStatus IN ['APPROVED_LIMITED', 'DISAPPROVED']")
Testo stringa Testo della parola chiave. Includere solo il testo della parola chiave. Non includere il tipo di corrispondenza della parola chiave nel testo. Se ad esempio la parola chiave è una parola chiave con corrispondenza esatta, ad esempio [libri], usare libri e non [libri].

withCondition("Text STARTS_WITH 'flowers'")		 Testo parola chiave
KeywordMatchType Enumerazione Tipo di corrispondenza della parola chiave. I valori possibili con distinzione tra maiuscole e minuscole sono:
  • AMPIA
  • ESATTA
  • A FRASE
withCondition("KeywordMatchType = EXACT")		 Tipo di corrispondenza (Match type)
MaxCpc doppia Importo massimo dell'offerta CPC della parola chiave. Il CPC è nella valuta dell'account.

withCondition("MaxCpc > 0.40")		 Offerta
DestinationUrl stringa withCondition("DestinationUrl STARTS_WITH 'http://www.contoso.com'") URL di destinazione
URL finali stringa withCondition("FinalUrls CONTAINS 'http://www.contoso.com'")
Punteggio di qualità int withCondition("QualityScore > 5") Qual. punteggio
FirstPageCpc doppia Importo medio che viene addebitato a un inserzionista ogni volta che viene fatto clic sull'annuncio visualizzato nella barra laterale. Ad esempio, se un inserzionista ha pagato un totale di $ 48,35 per 300 clic, il CPC medio dell'inserzionista è di $ 0,16. Utilizzare queste informazioni per decidere se aumentare l'offerta per parola chiave in modo da migliorare la probabilità che l'annuncio venga visualizzato nella barra laterale. Il CPC è nella valuta dell'account.

withCondition("FirstPageCpc > 6.00")		 Est. Offerta prima pagina
TopOfPageCpc doppia Importo medio che viene addebitato a un inserzionista ogni volta che viene fatto clic sul suo annuncio quando viene visualizzato al di sopra dei risultati di ricerca organici. Ad esempio, se un inserzionista ha pagato un totale di $ 48,35 per 300 clic, il CPC medio dell'inserzionista è di $ 0,16. Utilizza queste informazioni per decidere se aumentare l'offerta per le parole chiave per migliorare le probabilità che il tuo annuncio venga visualizzato prima dei risultati di ricerca organici. Il CPC è nella valuta del conto corrente.

withCondition("TopOfPageCpc > 8.00")		 Posizione migliore
AdGroupName stringa Nome del gruppo di annunci contenente le parole chiave.

withCondition("AdGroupName = 'foo'")
AdGroupStatus Enumerazione Stato del gruppo di annunci. I valori possibili con distinzione tra maiuscole e minuscole sono:
  • ABILITATO
  • Pausa
  • RIMOSSO
withCondition("AdGroupStatus = ENABLED")
CampaignName stringa Nome della campagna che contiene le parole chiave.

withCondition("CampaignName = 'bar'")
CampaignStatus Enumerazione Stato della campagna. I valori possibili con distinzione tra maiuscole e minuscole sono:
  • ABILITATO
  • Pausa
  • RIMOSSO
withCondition("CampaignStatus = ENABLED")
LabelNames set di stringhe Elenco di uno o più nomi di etichette con distinzione tra maiuscole e minuscole. Consente di ottenere le parole chiave associate alle etichette denominate.

withCondition("LabelNames CONTAINS_ANY ['bar', 'foo']")
Id Lungo ID della parola chiave da testare. Questa colonna può ad esempio essere utilizzata per cercare parole chiave con ID superiori all'ID specificato.

withCondition('Id > 1234')

Argomenti

Nome Tipo Descrizione
condizione stringa Condizione da aggiungere al selettore.

Restituisce

Tipo Descrizione
KeywordSelector Selettore con la condizione applicata.

withIds(string[] ids)

Ottiene le parole chiave con gli ID specificati.

Puoi applicare una o più condizioni a un selettore. Una catena di condizioni è considerata un'operazione AND. Ad esempio, l'entità viene selezionata solo se la condizione A è vera E la condizione B è vera. Ad esempio, la chiamata seguente seleziona solo la parola chiave 33333.

AdsApp.keywords()
    .withIds(['11111', '22222', '33333'])
    .withIds(['33333', '44444', '55555']);

Argomenti

Nome Tipo Descrizione
ID stringa[] Matrice di ID parola chiave. Per i limiti, vedere Limiti di esecuzione degli script.

Restituisce

Tipo Descrizione
KeywordSelector Selettore con gli ID applicati.

withLimit(int limit)

Ottiene le prime n parole chiave che corrispondono ai criteri di selezione.

Argomenti

Nome Tipo Descrizione
Limite int Numero di parole chiave da restituire. Il numero effettivo potrebbe essere inferiore.

Restituisce

Tipo Descrizione
KeywordSelector Selettore con limite applicato.

Vedere anche

  • Ultimo aggiornamento: