KeywordSelector
Contiene i metodi per filtrare e ordinare un elenco di parole chiave. Per informazioni sui selettori, vedere Selettori.
Utilizzo di esempio:
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(Object dateFrom, Object dateTo) | KeywordSelector | Applica le date di inizio e fine per la selezione delle metriche delle prestazioni. |
| forDateRange(string dateRange) | KeywordSelector | Applica l'intervallo di date predefinito per la selezione delle metriche delle prestazioni. |
| Ottieni | KeywordIterator | Ottiene un iteratore utilizzato per scorrere l'elenco di parole chiave. |
| orderBy(string orderBy) | KeywordSelector | Applica l'ordinamento specificato alle parole chiave selezionate. |
| withCondition(string condition) | KeywordSelector | Applica i criteri di filtro alle parole chiave. |
| withIds(string[] ids) | KeywordSelector | Ottiene parole chiave con gli ID specificati. |
| withLimit(int limit) | KeywordSelector | Ottiene le prime n parole chiave che corrispondono ai criteri di selezione. |
forDateRange(Object dateFrom, Object dateTo)
Applica le date di inizio e fine per la selezione delle metriche delle prestazioni.
Specificare un intervallo di date solo se:
- Si applicano condizioni o si ordinano i campi delle metriche delle prestazioni di riferimento.
- Si vogliono ottenere i dati sulle prestazioni per gli oggetti da selezionare. Ad esempio, se si prevede di chiamare il
getStats()metodo .
È possibile specificare i parametri di data usando stringhe o oggetti . Per utilizzare le stringhe, specificare la data nel formato AAAAMMGG. Se si usano oggetti , creare un oggetto con i campi seguenti:
- Anno
- Mese
- Giorno
Ad esempio:
var date = {year: 2018, month: 5, day: 13};
Il mese è in base uno, 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 delle prestazioni.
Valori dell'intervallo di date supportati:
- 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:
- Si applicano condizioni o si ordinano i campi delle metriche delle prestazioni di riferimento.
- Si vogliono ottenere i dati sulle prestazioni per gli oggetti da selezionare. 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 di intervallo di date predefinita che specifica i dati sulle prestazioni da includere nel selettore. La stringa di intervallo di date predefinita fa 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 usato per scorrere le parole chiave selezionate. |
orderBy(string orderBy)
Applica l'ordinamento specificato alle parole chiave selezionate.
Specificare il parametro orderBy nel formato "columnName orderDirection" dove:
- columnName è una delle colonne supportate.
- orderDirection è l'ordine in cui ordinare i risultati. Impostare su ASC per ordinare i risultati in ordine crescente o DESC per ordinare i risultati in ordine decrescente. Il valore predefinito è ASC.
Ad esempio, la chiamata seguente restituisce risultati in ordine crescente in base a AverageCpc.
selector = selector.orderBy("AverageCpc");
I selettori supportano l'ordinamento delle entità in base a un solo campo. Non è possibile ordinare l'elenco di entità per campo x e all'interno di x per campo y e così via. Se si specificano più chiamate orderBy() in una catena o in chiamate selettore separate, Script ordina l'elenco di entità usando il campo specificato nell'ultima orderBy() chiamata.
Argomenti
| Nome | Tipo | Descrizione |
|---|---|---|
| Orderby | stringa | Ordinamento da applicare. |
Restituisce
| Tipo | Descrizione |
|---|---|
| KeywordSelector | Selettore con ordinamento applicato. |
withCondition(String condition)
Applica i criteri di filtro alle parole chiave.
Specificare il parametro condition nel formato "columnName operator value" dove:
- columnName è una delle colonne supportate. Se columName è impostato su un nome di colonna della metrica delle prestazioni, è necessario specificare un intervallo di date usando forDateRange(String dateRange) o forDateRange(Object dateFrom, Object dateTo).
- operator è uno degli operatori supportati.
Operatori
L'operatore usato dipende dal tipo della colonna. Gli operatori fanno distinzione tra maiuscole e minuscole. Ad esempio, usare STARTS_WITH anziché starts_with.
Operatori per le colonne che contengono valori interi e valori 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. Ai nomi delle colonne viene applicata la distinzione tra maiuscole e minuscole.
Di seguito sono riportate le colonne delle metriche delle prestazioni che è possibile specificare.
| Colonna | Tipo | Esempio | Filtro dell'interfaccia utente Web di Microsoft Advertising |
|---|---|---|---|
| AbsoluteTopImpressionRate | Doppia | withCondition("AbsoluteTopImpressionRate > 0.25") |
Abs. Top Impr. Tasso |
| AverageCpc | Doppia | withCondition("AverageCpc < 2.75") |
Media CPC |
| AverageCpm | Doppia | withCondition("AverageCpm > 0.65") |
Media CPM |
| ClickConversionRate | Doppia | withCondition("ClickConversionRate > 0.25") |
Frequenza conv. |
| Clic | long | withCondition("Clicks >= 33") |
Clic |
| ConvertedClicks | long | withCondition("ConvertedClicks >= 10") |
Conv. |
| Costo | Doppia | withCondition("Cost > 3.25")Il costo è nella valuta del conto. |
Trascorrere |
| Ctr | Doppia | withCondition("Ctr > 0.05")Il CTR è compreso nell'intervallo 0..1, quindi usare 0,05 per un CTR del 5%. |
CTR |
| Impression | long | withCondition("Impressions > 10") |
Impr. |
| TopImpressionRate | Doppia | withCondition("TopImpressionRate > 0.25") |
Impr superiore. Tasso |
Di seguito sono riportate le proprietà dell'entità che è possibile specificare.
| Colonna | Tipo | Esempio | Filtro dell'interfaccia utente Web di Microsoft Advertising |
|---|---|---|---|
| Stato | Enumerazione | Stato della parola chiave. I possibili valori con distinzione tra maiuscole e minuscole sono:
withCondition("Status = ENABLED") |
Stato |
| CombinedApprovalStatus | stringa | Stato di approvazione della parola chiave. I possibili valori con distinzione tra maiuscole e minuscole sono:
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. Ad esempio, se la parola chiave è una parola chiave di corrispondenza esatta, ad esempio [libri], usare libri non [libri].withCondition("Text STARTS_WITH 'flowers'") |
Testo parola chiave |
| KeywordMatchType | Enumerazione | Tipo di corrispondenza della parola chiave. I possibili valori con distinzione tra maiuscole e minuscole sono:
withCondition("KeywordMatchType = EXACT") |
Tipo di corrispondenza (Match type) |
| MaxCpc | Doppia | Importo massimo dell'offerta CPC della parola chiave. Il CPC si trova nella valuta del conto.withCondition("MaxCpc > 0.40") |
Offerta |
| DestinationUrl | stringa | withCondition("DestinationUrl STARTS_WITH 'http://www.contoso.com'") |
URL di destinazione |
| FinalUrls | stringa | withCondition("FinalUrls CONTAINS 'http://www.contoso.com'") |
|
| QualityScore | int | withCondition("QualityScore > 5") |
Qual. Punteggio |
| FirstPageCpc | Doppia | L'importo medio addebitato a un inserzionista ogni volta che viene fatto clic sul suo annuncio quando viene visualizzato sulla barra laterale. Ad esempio, se un inserzionista ha pagato un totale di $48,35 per 300 clic, il CPC medio dell'inserzionista è $0,16. Usa queste informazioni per decidere se aumentare l'offerta di parole chiave per migliorare la possibilità che l'annuncio venga visualizzato sulla barra laterale. Il CPC si trova nella valuta del conto.withCondition("FirstPageCpc > 6.00") |
Est. offerta per la prima pagina |
| TopOfPageCpc | Doppia | L'importo medio addebitato a un inserzionista ogni volta che viene fatto clic sul suo annuncio quando viene visualizzato sopra i risultati della ricerca organica. Ad esempio, se un inserzionista ha pagato un totale di $48,35 per 300 clic, il CPC medio dell'inserzionista è $0,16. Usa queste informazioni per decidere se aumentare l'offerta di parole chiave per migliorare la possibilità che il tuo annuncio venga visualizzato sopra i risultati della ricerca organica. Il CPC si trova nella valuta del conto corrente.withCondition("TopOfPageCpc > 8.00") |
Posizione migliore |
| AdGroupName | stringa | Nome del gruppo di annunci che contiene le parole chiave.withCondition("AdGroupName = 'foo'") |
|
| AdGroupStatus | Enumerazione | Stato del gruppo di annunci. I possibili valori con distinzione tra maiuscole e minuscole sono:
withCondition("AdGroupStatus = ENABLED") |
|
| CampaignName | stringa | Nome della campagna che contiene le parole chiave.withCondition("CampaignName = 'bar'") |
|
| CampaignStatus | Enumerazione | Stato della campagna. I possibili valori con distinzione tra maiuscole e minuscole sono:
withCondition("CampaignStatus = ENABLED") |
|
| LabelNames | set di stringhe | Elenco di uno o più nomi di etichette con distinzione tra maiuscole e minuscole. Usare per ottenere le parole chiave associate alle etichette denominate.withCondition("LabelNames CONTAINS_ANY ['bar', 'foo']") |
|
| Id | Lungo | ID della parola chiave da testare. Ad esempio, è possibile usare questa colonna per verificare la presenza di parole chiave con ID maggiori dell'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 parole chiave con gli ID specificati.
È possibile 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 è true E la condizione B è true. 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 | string[] | Matrice di ID parola chiave. Per i limiti, vedere Limiti di esecuzione dello 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 può essere minore. |
Restituisce
| Tipo | Descrizione |
|---|---|
| KeywordSelector | Selettore con limite applicato. |
Vedere anche
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per