Esempi di script per la gestione dei budget condivisi

Le sezioni seguenti illustrano esempi di script che eseguono varie azioni rispetto ai budget condivisi.

Aggiungere budget condivisi

Per aggiungere un budget condiviso, è necessario usare l'applicazione Web Microsoft Advertising. Per informazioni dettagliate, vedere Ricerca per categorie condividere un budget tra più campagne?

Associare una campagna a un budget condiviso

Per associare una campagna a un budget condiviso, è necessario usare l'applicazione Web Microsoft Advertising. Per informazioni dettagliate, vedere Ricerca per categorie condividere un budget tra più campagne?

Ottenere tutti i budget condivisi

Per ottenere tutti i budget condivisi in un account, chiamare innanzitutto il metodo dell'oggetto budgetsAdsApp per ottenere il selettore. Chiamare quindi il metodo del get selettore per ottenere un iteratore usato per scorrere l'elenco di budget condivisi. Poiché l'esempio non specifica alcun filtro, il selettore restituisce tutti i budget condivisi nell'account. Per determinare il numero di budget condivisi nell'iteratore, chiamare il metodo dell'iteratore totalNumEntities .

function main() {
    // Gets all shared budgets in the account.
    var iterator = AdsApp.budgets().get();
    
    // Iterates through the list of shared budgets and logs 
    // each budgets's name and amount.
    while (iterator.hasNext()) {
        var budget = iterator.next();
    }
}

Ottenere un budget condiviso per nome

Per ottenere un budget condiviso in base al nome, chiamare prima il metodo dell'oggetto budgetsAdsApp per ottenere il selettore. Il selettore contiene diversi metodi di filtro usati per filtrare l'elenco dei budget. Utilizzare il withCondition metodo per filtrare i budget in base al nome. Ad esempio, per filtrare l'elenco in base a un nome specifico, usare: withCondition("BudgetName = '<budgetnamegoeshere>'"). Per filtrare l'elenco in base a un nome parziale, usare: withCondition("BudgetName CONTAINS_IGNORE_CASE '<partialnamegoeshere>'"). Si noti che gli operandi e gli operatori fanno distinzione tra maiuscole e minuscole.

Chiamare quindi il metodo del get selettore per ottenere l'iteratore.

function main() {
    // Partial name of the shared budget to get.
    var budgetName = 'PARTIAL NAME GOES HERE';

    // Get the budgets that contain the partial name.
    var iterator = AdsApp.budgets()
          .withCondition(`BudgetName CONTAINS_IGNORE_CASE '${budgetName}'`)
          .get();

    // Iterates through the list of shared budgets and logs 
    // each budget's name and amount.
    while (iterator.hasNext()) {
        var budget = iterator.next();
    }
}

Ottenere budget condivisi in base all'ID

Se si ha accesso all'ID del budget condiviso, usarlo invece. L'uso degli ID per ottenere le entità offre prestazioni migliori. Anziché usare il withCondition metodo di filtro, usare il withIds metodo . Ad esempio, withIds(['12345']).

function main() {
    var sharedBudgetId = '12345';

    var iterator = AdsApp.budgets()
        .withIds([sharedBudgetId])
        .get();

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

Ottenere tutte le campagne che condividono il budget

Per ottenere tutte le campagne che condividono il budget, chiamare il metodo delle campagne del budget. È possibile chiamare questo metodo solo da un oggetto Budget ottenuto da BudgetSelector; non è possibile chiamarlo se l'origine del budget è il metodo getBudget della campagna.

function main() {
    var sharedBudgetId = '12345';

    var budgets = AdsApp.budgets()
        .withIds([sharedBudgetId])
        .get();

    while (budgets.hasNext()) {
        var budget = budgets.next();

        var campaigns = budget.campaigns().get();

        while (campaigns.hasNext()) {
            var campaign = campaigns.next();
        }
    }
}

Ottenere i dati sulle prestazioni di un budget condiviso

Per ottenere le metriche delle prestazioni di un budget condiviso, chiamare il metodo getStats del budget. Quando si ottiene l'elenco dei budget delle condivisioni, è necessario specificare l'intervallo di date dei dati delle metriche desiderati. È possibile specificare l'intervallo di date usando un valore letterale predefinito, ad esempio LAST_MONTH o TODAY, oppure una data di inizio e fine. Per specificare l'intervallo di date, usare uno dei forDateRange metodi quando si selezionano i budget (vedere BudgetSelector).

Per un elenco delle metriche a cui è possibile accedere, vedere l'oggetto Stats . Le metriche sono l'aggregazione di tutte le campagne che condividono il budget.

function main() {
    var sharedBudgetId = '12345';

    // Get the shared budget. You need to specify the date range of the
    // performance data you want to get.
    var budgets = AdsApp.budgets()
        .forDateRange('LAST_WEEK')
        .withIds([sharedBudgetId])
        .get();
    
    // If the budget is found, log some metrics.
    while (budgets.hasNext()) {
        var budget = budgets.next();
        var metrics = budget.getStats(); // Gets the performance metrics.
    }
}