Paylaşılan bütçeleri yönetmeye yönelik senaryo örnekleri

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

Paylaşılan bütçeler ekleyin

Paylaşılan bütçe eklemek için Microsoft Advertising web uygulamasını kullanmanız gerekir. Ayrıntılar için Nasıl yaparım? kadar kampanyada bütçe paylaşılsın mı? adlı makaleyi inceleyin.

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

Bir kampanyayı paylaşılan bir bütçeyle ilişkilendirmek için Microsoft Advertising web uygulamasını kullanmanız gerekir. Ayrıntılar için Nasıl yaparım? kadar kampanyada bütçe paylaşılsın mı? adlı makaleyi inceleyin.

Tüm paylaşılan bütçeleri alın

Tüm paylaşılan bütçeleri bir hesapta almak için, seçiciyi almak için önce AdsApp nesnesinin budgets yöntemini çağırın. Ardından, Paylaşılan bütçeler get listesini yinelemek için kullandığınız bir yineleyici almak için seçicinin yöntemini çağırın. Örnekte herhangi bir filtre belirtilmediğinden, seçici hesaptaki tüm paylaşılan bütçeleri döndürür. Yineleyicide paylaşılan bütçelerin sayısını belirlemek için yineleyicinin totalNumEntities yöntemini çağırın.

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

Ada göre paylaşılan bir bütçe almak için, seçiciyi almak için önce AdsApp nesnesinin budgets yöntemini çağırın. Seçici, bütçe listesine filtre uygulamak için kullanacağınız bir dizi filtre yöntemi içerir. Bütçeleri withCondition ada göre filtrelemek için bu yöntemi 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ğuna dikkat edin.

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

Paylaşılan bütçeleri kimliğe göre alma

Paylaşılan bütçenin kimliğine erişiminiz varsa bunun yerine bunu kullanın. Varlıkları almak için kimlikleri kullanmak daha iyi performans sağlar. Filtre yöntemini kullanmak withCondition yerine, yöntemi withIds kullanın. Ö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 kampanyalar yöntemini çağırın. Bu yöntemi yalnızca BudgetSelector'dan aldığınız 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 bir bütçenin performans verilerini alma

Paylaşılan bir 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 metrik verilerinin tarih aralığını belirtmeniz gerekir. Tarih aralığını, LAST_MONTH veya BUGÜN gibi önceden tanımlanmış bir değişmez değer ya da başlangıç ve bitiş tarihi kullanarak belirtebilirsiniz. Tarih aralığını belirtmek için, bütçeleri seçerken kullanılan yöntemlerden birini forDateRange kullanın (bkz.

Erişebileceğiniz metriklerin listesi için Stats nesnesine bakın. Metrikler, 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.
    }
}