Condividi tramite

BingAdsAccountSelector

  • Articolo

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

Utilizzo di esempio:

    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(string functionName, string optionalCallbackFunctionName) Vuoto Esegue la funzione per ogni account restituito dal selettore.
executeInParallel(string functionName, string optionalCallbackFunctionName, string optionalInput) Vuoto Esegue la funzione per ogni account restituito dal selettore.
forDateRange(Object dateFrom, Object dateTo) BingAdsAccountSelector Applica le date di inizio e fine per la selezione delle metriche delle prestazioni.
forDateRange(string dateRange) BingAdsAccountSelector Applica l'intervallo di date predefinito per la selezione delle metriche delle prestazioni.
Ottieni BingAdsAccountIterator Ottiene un iteratore utilizzato per scorrere l'elenco di account.
orderBy(string orderBy) BingAdsAccountSelector Applica l'ordinamento specificato agli account selezionati.
withAccountNumbers(string[] accountNumbers) BingAdsAccountSelector Ottiene gli account con i numeri di account specificati.
withCondition(string condition) BingAdsAccountSelector Applica criteri di filtro agli account.
withIds(string[] ids) BingAdsAccountSelector Ottiene gli account con gli ID specificati.
withLimit(int limit) BingAdsAccountSelector Ottiene i primi n account che corrispondono ai criteri di selezione.

executeInParallel(string functionName, string optionalCallbackFunctionName)

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

Nota

Lo script può eseguire un massimo di 50 account in parallelo ogni volta che viene eseguito lo script. È possibile chiamare questo metodo una o più volte, ma il numero totale di account che tutti i processi di chiamata non devono superare 50. Se una chiamata supera il 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 o withIds .

La funzione functionName può restituire un valore come stringa. Per restituire un oggetto complesso, usare il metodo JSON.stringify per convertire l'oggetto in una stringa. È quindi possibile usare il metodo JSON.parse per convertire nuovamente 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)

Nell'esempio seguente viene illustrato 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 del selettore nella catena di chiamate.

Per un esempio, vedi 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 dopo che tutti gli account hanno completato l'esecuzione della funzione functionName . Questa funzione viene eseguita una sola volta.

Restituisce

Tipo Descrizione
Vuoto Non restituisce nulla.

executeInParallel(string functionName, string optionalCallbackFunctionName, string optionalInput)

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

Nota

Lo script può eseguire un massimo di 50 account in parallelo ogni volta che viene eseguito lo script. È possibile chiamare questo metodo una o più volte, ma il numero totale di account che tutti i processi di chiamata non devono superare 50. Se una chiamata supera il 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 o withIds .

La funzione functionName può restituire un valore come stringa. Per restituire un oggetto complesso, usare il metodo JSON.stringify per convertire l'oggetto in una stringa. È quindi possibile usare il metodo JSON.parse per convertire nuovamente 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)

Nell'esempio seguente viene illustrato 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 illustrata 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 del selettore nella catena di chiamate.

Per un esempio, vedi 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 dopo che tutti gli account hanno completato l'esecuzione della funzione functionName . Questa funzione viene eseguita una sola volta.
optionalInput stringa Facoltativo. Input da passare alla funzione functionName .

Restituisce

Tipo Descrizione
Vuoto Non restituisce nulla.

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

Ottieni

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

Restituisce

Tipo Descrizione
BingAdsAccount Iteratore usato per scorrere gli account selezionati.

orderBy(string orderBy)

Applica l'ordinamento specificato agli account selezionati.

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

selector = selector.orderBy("Clicks");

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

withAccountNumbers(string[] accountNumbers)

Ottiene gli account con i numeri di account specificati.

Argomenti

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

Restituisce

Tipo Descrizione
BingAdsAccountSelector Selettore con i numeri di conto applicati.

withCondition(String condition)

Applica criteri di filtro agli account.

Specificare il parametro condition nel formato "columnName operator value" dove:

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

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

Colonna Tipo Esempio Filtro dell'interfaccia utente Web di Microsoft Advertising
CurrencyCode stringa Codice di valuta della valuta utilizzata dal conto. Ad esempio, USD per Stati Uniti dollaro.

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.

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

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

Argomenti

Nome Tipo Descrizione
Id string[] Matrice di ID account. Per i limiti, vedere Limiti di esecuzione dello script.

Restituisce

Tipo Descrizione
BingAdsAccountSelector Selettore con gli ID applicati.

withLimit(int limit)

Ottiene i primi n account che corrispondono ai criteri di selezione.

Argomenti

Nome Tipo Descrizione
Limite int Numero di account da restituire. Il numero effettivo può essere minore.

Restituisce

Tipo Descrizione
BingAdsAccountSelector Selettore con limite applicato.

Vedere anche