BingAdsAccountSelector

Contiene i metodi per filtrare e ordinare l'elenco degli account a cui l'utente ha accesso. Per informazioni sui selettori, vedere Selettori.

Esempio di utilizzo:

    var accounts = AccountsApp.accounts()
        .withCondition("Name CONTAINS_IGNORE_CASE 'PARTIAL ACCOUNT NAME GOES HERE'")
        .get();

    while (accounts.hasNext()) {
        var account = accounts.next();
    }

Metodi

Nome metodo	Tipo restituito	Descrizione
executeInParallel(stringa, nomefunzione, stringa, optionalCallbackFunctionName)	void	Esegue la funzione per ogni account restituito dal selettore.
executeInParallel(stringa functionName, stringa optionalCallbackFunctionName, stringa optionalInput)	void	Esegue la funzione per ogni account restituito dal selettore.
forDateRange(Oggetto dateFrom, Oggetto dateTo)	BingAdsAccountSelector	Applica le date di inizio e di fine per la selezione delle metriche del rendimento.
forDateRange(stringa dateRange)	BingAdsAccountSelector	Applica l'intervallo di date predefinito per la selezione delle metriche del rendimento.
Ottieni	BingAdsAccountIterator	Ottiene un iteratore utilizzato per scorrere l'elenco degli account.
orderBy(stringa orderBy)	BingAdsAccountSelector	Applica l'ordinamento specificato agli account selezionati.
withAccountNumbers(stringa[], accountNumbers)	BingAdsAccountSelector	Ottiene gli account con i numeri di account specificati.
withCondition(condizione stringa)	BingAdsAccountSelector	Applica i criteri di filtro agli account.
withIds(string[] ids)	BingAdsAccountSelector	Ottiene gli account con gli ID specificati.
withLimit(int limit)	BingAdsAccountSelector	Consente di ottenere i primi n account che corrispondono ai criteri di selezione.

executeInParallel(stringa, nomefunzione, stringa, optionalCallbackFunctionName)

Esegue la funzione per ogni account restituito dal selettore. Dopo l'esecuzione della funzione per tutti gli account selezionati, Scripts chiama la funzione di callback facoltativa.

Nota

Lo script può eseguire un massimo di 50 account in parallelo ogni volta che viene eseguito. È possibile chiamare questo metodo una o più volte, ma il numero totale di account elaborati da tutte le chiamate non deve superare 50. Se una chiamata supera il limite massimo di 50 account per lo script, nessuno degli account nella chiamata viene eseguito. Per limitare il numero di account restituiti dal selettore, è consigliabile usare il withLimit metodo OR withIds .

La funzione functionName può restituire un valore come stringa. Per restituire un oggetto complesso, usa il metodo JSON.stringify per convertire l'oggetto in una stringa. È quindi possibile utilizzare il metodo JSON.parse per convertire la stringa in un oggetto. Se la funzione restituisce un valore, è necessario specificare una funzione di callback per acquisire i valori restituiti. Di seguito viene illustrata la firma della funzione di callback. I valori restituiti vengono passati come matrice di oggetti ExecutionResult .

function myCallback(ExecutionResult[] results)

L'esempio seguente illustra come elaborare i valori restituiti nella funzione di callback.

function myCallback(results) {
    for (var result of results) {
        var object = JSON.parse(result.getReturnValue());
    }
}

Poiché questo metodo non restituisce un oggetto BingAdsAccountSelector , assicurarsi che questo metodo sia l'ultimo metodo di selezione nella catena di chiamate.

Per un esempio, vedere Individuazione degli annunci non approvati.

Argomenti

Nome	Tipo	Descrizione
functionName	stringa	Nome della funzione da eseguire per ogni account restituito dal selettore. Il metodo currentAccount identifica l'account che la funzione sta elaborando.
optionalCallbackFunctionName	stringa	Facoltativo. Nome della funzione da eseguire al termine dell'esecuzione della funzione functionName da parte di tutti gli account. Questa funzione viene eseguita una sola volta.

Restituisce

Tipo	Descrizione
void	Non restituisce nulla.

executeInParallel(stringa functionName, stringa optionalCallbackFunctionName, stringa optionalInput)

Esegue la funzione per ogni account restituito dal selettore. Dopo l'esecuzione della funzione per tutti gli account selezionati, Scripts chiama la funzione di callback facoltativa.

Nota

Lo script può eseguire un massimo di 50 account in parallelo ogni volta che viene eseguito. È possibile chiamare questo metodo una o più volte, ma il numero totale di account elaborati da tutte le chiamate non deve superare 50. Se una chiamata supera il limite massimo di 50 account per lo script, nessuno degli account nella chiamata viene eseguito. Per limitare il numero di account restituiti dal selettore, è consigliabile usare il withLimit metodo OR withIds .

La funzione functionName può restituire un valore come stringa. Per restituire un oggetto complesso, usa il metodo JSON.stringify per convertire l'oggetto in una stringa. È quindi possibile utilizzare il metodo JSON.parse per convertire la stringa in un oggetto. Se la funzione restituisce un valore, è necessario specificare una funzione di callback per acquisire i valori restituiti. Di seguito viene illustrata la firma della funzione di callback. I valori restituiti vengono passati come matrice di oggetti ExecutionResult .

function myCallback(ExecutionResult[] results)

L'esempio seguente illustra come elaborare i valori restituiti nella funzione di callback.

function myCallback(results) {
    for (var result of results) {
        var object = JSON.parse(result.getReturnValue());
    }
}

Se si passa il parametro di input facoltativo, di seguito viene visualizzata la firma della funzione functionName .

function myFunction(string optionalInput)

Poiché questo metodo non restituisce un oggetto BingAdsAccountSelector , assicurarsi che questo metodo sia l'ultimo metodo di selezione nella catena di chiamate.

Per un esempio, vedere Individuazione degli annunci non approvati.

Argomenti

Nome	Tipo	Descrizione
functionName	stringa	Nome della funzione da eseguire per ogni account restituito dal selettore. Il metodo currentAccount identifica l'account che la funzione sta elaborando.
optionalCallbackFunctionName	stringa	Facoltativo. Nome della funzione da eseguire al termine dell'esecuzione della funzione functionName da parte di tutti gli account. Questa funzione viene eseguita una sola volta.
optionalInput	stringa	Facoltativo. Input da passare alla funzione functionName .

Restituisce

Tipo	Descrizione
void	Non restituisce nulla.

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
BingAdsAccountSelector	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
BingAdsAccountSelector	Selettore con intervallo di date applicato.

Ottieni

Ottiene un iteratore utilizzato per scorrere l'elenco degli account.

Restituisce

Tipo	Descrizione
BingAdsAccount	Iteratore usato per scorrere gli account selezionati.

orderBy(stringa orderBy)

Applica l'ordinamento specificato agli account selezionati.

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.

La chiamata seguente restituisce ad esempio i risultati in ordine crescente di clic.

selector = selector.orderBy("Clicks");

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
BingAdsAccountSelector	Selettore con ordinamento applicato.

withAccountNumbers(stringa[], accountNumbers)

Ottiene gli account con i numeri di account specificati.

Argomenti

Nome	Tipo	Descrizione
accountNumbers	stringa[]	Matrice di numeri di conto. Per i limiti, vedere Limiti di esecuzione degli script.

Restituisce

Tipo	Descrizione
BingAdsAccountSelector	Selettore con i numeri di account applicati.

withCondition(condizione stringa)

Applica i criteri di filtro agli account.

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

• columnName è una delle colonne supportate. Se columName è impostato su un nome di colonna di metrica sul rendimento, è necessario specificare un intervallo di date utilizzando forDateRange(String dateRange) o forDateRange(Object dateFrom, Object dateTo).
• operator è uno degli operatori supportati.

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 degli account. 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
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.

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

Colonna	Tipo	Esempio	Filtro interfaccia utente Web di Microsoft Advertising
CurrencyCode	stringa	Codice valuta della valuta utilizzata dall'account. Ad esempio, USD per dollaro degli Stati Uniti. withCondition("CurrencyCode = USD")
ManagerCustomerId	stringa	ID cliente dell'utente che gestisce gli account. withCondition("ManagerCustomerId = '123456789'")
Nome	stringa	Nome di un account gestito. withCondition("Name CONTAINS_IGNORE_CASE 'foo'")

Argomenti

Nome	Tipo	Descrizione
condizione	stringa	Condizione da aggiungere al selettore.

Restituisce

Tipo	Descrizione
BingAdsAccountSelector	Selettore con la condizione applicata.

withIds(string[] ids)

Ottiene gli account 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 l'account 33333.

AccountsApp.accounts()
    .withIds(['11111', '22222', '33333'])
    .withIds(['33333', '44444', '55555']);
    .get();

Argomenti

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

Restituisce

Tipo	Descrizione
BingAdsAccountSelector	Selettore con gli ID applicati.

withLimit(int limit)

Consente di ottenere i primi n account che corrispondono ai criteri di selezione.

Argomenti

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

Restituisce

Tipo	Descrizione
BingAdsAccountSelector	Selettore con limite applicato.

Vedere anche

• AccountsApp.accounts()
• BingAdsAccountIterator
• Accesso a più account