Skriptbeispiele für die Verwaltung von gemeinsamen Budgets

Die folgenden Abschnitte enthalten Beispiele für Skripts, die verschiedene Aktionen für gemeinsame Budgets ausführen.

Hinzufügen von gemeinsamen Budgets

Zum Hinzufügen eines gemeinsamen Budgets müssen Sie die Microsoft Advertising-Webanwendung verwenden. Weitere Informationen finden Sie unter Gewusst wie ein Budget auf mehrere Kampagnen verteilen?

Zuordnen einer Kampagne zu einem gemeinsamen Budget

Wenn Sie eine Kampagne einem gemeinsamen Budget zuordnen möchten, müssen Sie die Microsoft Advertising-Webanwendung verwenden. Weitere Informationen finden Sie unter Gewusst wie ein Budget auf mehrere Kampagnen verteilen?

Abrufen aller gemeinsamen Budgets

Um alle gemeinsamen Budgets in einem Konto abzurufen, rufen Sie zunächst die Methode des AdsApp-Objektsbudgets auf, um den Selektor abzurufen. Rufen Sie dann die Selektormethode get auf, um einen Iterator abzurufen, mit dem Sie die Liste der gemeinsamen Budgets durchlaufen können. Da in diesem Beispiel keine Filter angegeben werden, gibt der Selektor alle gemeinsamen Budgets im Konto zurück. Um die Anzahl der gemeinsamen Budgets im Iterator zu bestimmen, rufen Sie die Methode des Iterators auf totalNumEntities .

Hinweis

Gemeinsame Budgets umfassen keine nicht geteilten Budgets (einzelne Kampagnenbudgets).

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();
    }
}

Abrufen eines gemeinsamen Budgets nach Name

Um ein gemeinsames Budget nach Name zu erhalten, rufen Sie zuerst die Methode des AdsApp-Objektsbudgets auf, um den Selektor abzurufen. Die Auswahl enthält eine Reihe von Filtermethoden, mit denen Sie die Liste der Budgets filtern können. Verwenden Sie die withCondition Methode, um die Budgets nach Namen zu filtern. Wenn Sie die Liste beispielsweise nach einem bestimmten Namen filtern möchten, verwenden Sie: withCondition("BudgetName = '<budgetnamegoeshere>'"). Wenn Sie die Liste nach einem Teil des Namens filtern möchten, verwenden Sie: withCondition("BudgetName CONTAINS_IGNORE_CASE '<partialnamegoeshere>'"). Beachten Sie, dass bei Operanden und Operatoren die Groß-/Kleinschreibung beachtet wird.

Rufen Sie als Nächstes die Selektormethode auf get , um den Iterator abzurufen.

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();
    }
}

Abrufen gemeinsamer Budgets nach ID

Wenn Sie Zugriff auf die ID des gemeinsamen Budgets haben, verwenden Sie stattdessen diese. Die Verwendung von IDs zum Abrufen von Entitäten bietet eine bessere Leistung. Anstatt die withCondition Filtermethode zu verwenden, verwenden Sie die withIds Methode. Beispiel: withIds(['12345']).

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

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

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

Abrufen aller Kampagnen mit gemeinsamem Budget

Um alle Kampagnen abzurufen, die das Budget teilen, rufen Sie die Kampagnenmethode des Budgets auf. Sie können diese Methode nur von einem Budget-Objekt aus aufrufen, das Sie von BudgetSelector erhalten. Sie können es nicht aufrufen, wenn die Quelle des Budgets die getBudget-Methode der Kampagne ist.

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();
        }
    }
}

Abrufen der Performancedaten eines gemeinsamen Budgets

Um die Leistungsmetriken eines gemeinsamen Budgets abzurufen, rufen Sie die getStats-Methode des Budgets auf. Wenn Sie die Liste der Aktienbudgets erhalten, müssen Sie den Datumsbereich der gewünschten Metrikdaten angeben. Sie können den Datumsbereich mithilfe eines vordefinierten Literals, z. B. LAST_MONTH oder HEUTE, oder eines Start- und Enddatums angeben. Um den Datumsbereich anzugeben, verwenden Sie eine der Methoden forDateRange bei der Auswahl der Budgets (siehe BudgetSelector).

Eine Liste der Metriken, auf die Sie zugreifen können, finden Sie im Objekt "Statistiken ". Die Metriken sind die Aggregation aller Kampagnen, die sich das Budget teilen.

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.
    }
}
  • Last updated on