Paylaşılan bütçeleri yönetmek için betik örnekleri

Aşağıdaki bölümlerde , paylaşılan bütçelere karşı çeşitli eylemler gerçekleştiren betik örnekleri gösterilir.

Paylaşılan bütçeler ekleme

Paylaşılan bütçe eklemek için Microsoft Advertising web uygulamasını kullanmanız gerekir. Ayrıntılar için bkz. Birden çok kampanyada bütçe paylaşma Nasıl yaparım??

Kampanyayı paylaşılan bütçeyle ilişkilendirme

Bir kampanyayı paylaşılan bütçeyle ilişkilendirmek için Microsoft Advertising web uygulamasını kullanmanız gerekir. Ayrıntılar için bkz. Birden çok kampanyada bütçe paylaşma Nasıl yaparım??

Tüm paylaşılan bütçeleri alma

Bir hesaptaki tüm paylaşılan bütçeleri almak için önce AdsApp nesnesinin budgets yöntemini çağırarak seçiciyi alın. Ardından, Paylaşılan bütçeler listesinde yinelemek için kullandığınız bir yineleyici almak için seçicinin get yöntemini çağırın. Örnek herhangi bir filtre belirtmediğinden, seçici hesaptaki tüm paylaşılan bütçeleri döndürür. Yineleyicideki paylaşılan bütçe sayısını belirlemek için yineleyicinin yöntemini çağırın totalNumEntities .

Not

Paylaşılan bütçeler, paylaşılmayan (tek tek kampanya) bütçeleri içermez.

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

Ada göre paylaşılan bütçe alma

Paylaşılan bütçeyi ada göre almak için önce AdsApp nesnesinin budgets yöntemini çağırarak seçiciyi alın. Seçici, bütçe listesini filtrelemek için kullandığınız bir dizi filtre yöntemi içerir. Bütçeleri withCondition ada göre filtrelemek için yöntemini kullanın. Örneğin, listeyi belirli bir ad için filtrelemek için şunu kullanın: withCondition("BudgetName = '<budgetnamegoeshere>'"). Listeyi kısmi bir ada göre filtrelemek için şunu kullanın: withCondition("BudgetName CONTAINS_IGNORE_CASE '<partialnamegoeshere>'"). İşlenenlerin ve işleçlerin büyük/küçük harfe duyarlı olduğunu unutmayın.

Ardından yineleyiciyi almak için seçicinin get yöntemini çağırın.

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

Kimliğine göre paylaşılan bütçeleri alma

Paylaşılan bütçenin kimliğine erişiminiz varsa bunu kullanın. Varlıkları almak için kimlikleri kullanmak daha iyi performans sağlar. Filtre yöntemini kullanmak withCondition yerine yöntemini kullanın withIds . Örneğin, withIds(['12345']).

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

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

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

Bütçeyi paylaşan tüm kampanyaları alma

Bütçeyi paylaşan tüm kampanyaları almak için bütçenin kampanya yöntemini çağırın. Bu yöntemi yalnızca BudgetSelector'dan edindiğiniz bir Budget nesnesinden çağırabilirsiniz; bütçenin kaynağı kampanyanın getBudget yöntemiyse bunu çağıramazsınız.

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

Paylaşılan bütçenin performans verilerini alma

Paylaşılan bütçenin performans ölçümlerini almak için bütçenin getStats yöntemini çağırın. Paylaşım bütçelerinin listesini aldığınızda, istediğiniz ölçüm verilerinin tarih aralığını belirtmeniz gerekir. Tarih aralığını LAST_MONTH veya BUGÜN gibi önceden tanımlanmış bir değişmez değer veya başlangıç ve bitiş tarihi kullanarak belirtebilirsiniz. Tarih aralığını belirtmek için bütçeleri seçtiğinizde yöntemlerden birini forDateRange kullanın (bkz. BudgetSelector).

Erişebileceğiniz ölçümlerin listesi için İstatistikler nesnesine bakın. Ölçümler, bütçeyi paylaşan tüm kampanyaların toplamıdır.

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