Esnek Bütçeler - Tek Hesap

Araç simgesi

Google Ads, her kampanya için günlük bütçe tutarı belirlemenize olanak tanır. Ancak, bazı pazarlama girişimlerinin bunlarla ilişkili sabit bir maliyeti olacaktır. Örneğin, "Sonbahar indirimimize kadar 5.000 TL harcamak istiyorum". Teklif stratejisi, günlük bütçenin nasıl harcanacağı üzerinde bir miktar kontrole sahip olmanızı sağlar. Ancak bütçenin kampanya sırasında nasıl kullanılacağı konusunda kontrole sahip olmazsınız.

Örneğin, sonbahar indirimimizin reklamını yapmak için yalnızca 5.000 TL harcamak ve 10 gün boyunca reklam vermek istiyorsak bütçenin tamamını kullanmak üzere 500 TL'lik bir günlük bütçe belirleyebiliriz. Ancak bu, her gün tutarın tamamını harcayacağımızı VE eşit olarak harcamak istediğimizi varsayar. Google Ads'e, son birkaç gün içinde bütçenizin büyük bir kısmını harcamak istediğinizi söylemek mümkün değildir.

Bu komut dosyası, özel bir bütçe dağıtım planıyla kampanya bütçenizi günlük olarak dinamik olarak ayarlar.

İşleyiş şekli

Bütçe stratejilerini test etme

Komut dosyası, birkaç gün çalışmanın etkilerini simüle etmek için bazı test kodları içerir. Bu, komut dosyasının belirli bir süre boyunca günlük olarak çalışacak şekilde planlanması durumunda neler olabileceği konusunda daha iyi bir fikir edinmenizi sağlar.

Varsayılan olarak bu komut dosyası, 10 gün boyunca harcanan 500 ABD doları değerinde eşit bir bütçe dağılımını simüle eder.

function main() {
  testBudgetStrategy(calculateBudgetEvenly, 10, 500);
  // setNewBudget(calculateBudgetEvenly, CAMPAIGN_NAME, TOTAL_BUDGET, START_DATE, END_DATE);
}

setNewBudget işlev çağrısı, yalnızca test kodunu çalıştıracağını belirten, açıklamada yer almaz. Aşağıda, örnekteki çıkışı görebilirsiniz:

Day 1.0 of 10.0, new budget 50.0, cost so far 0.0
Day 2.0 of 10.0, new budget 50.0, cost so far 50.0
Day 3.0 of 10.0, new budget 50.0, cost so far 100.0
Day 4.0 of 10.0, new budget 50.0, cost so far 150.0
Day 5.0 of 10.0, new budget 50.0, cost so far 200.0
Day 6.0 of 10.0, new budget 50.0, cost so far 250.0
Day 7.0 of 10.0, new budget 50.0, cost so far 300.0
Day 8.0 of 10.0, new budget 50.0, cost so far 350.0
Day 9.0 of 10.0, new budget 50.0, cost so far 400.0
Day 10.0 of 10.0, new budget 50.0, cost so far 450.0
Day 11.0 of 10.0, new budget 0.0, cost so far 500.0

Komut dosyası, bütçe harcamasının eşit bir şekilde dağıtılmasını sağlamak için her gün yeni bir bütçe hesaplar. Tahsis edilen bütçe sınırına ulaşıldığında bütçe sıfıra ayarlanır ve harcama durdurulur.

Kullanılan bütçe stratejisini, hangi işlevin kullanılacağını değiştirerek veya işlevin kendisini değiştirerek değiştirebilirsiniz. Komut dosyası, önceden oluşturulmuş iki stratejiyle birlikte gelir: calculateBudgetEvenly ve calculateBudgetWeighted. Ağırlıklı test bütçe stratejisi ayarlamak için testBudgetStrategy şu şekilde değişir:

testBudgetStrategy(calculateBudgetWeighted, 10, 500);

Preview (Önizleme) seçeneğini tıklayın ve logger çıktısını kontrol edin. Bu bütçe stratejisinin dönemin başlarında daha az, son birkaç gün içinse daha fazla bütçe ayırdığına dikkat edin.

Bu test yöntemini kullanarak bütçe hesaplama işlevlerindeki değişiklikleri simüle edebilir ve bütçeyi dağıtırken kendi yaklaşımınızı deneyebilirsiniz.

Bütçe ayırma

calculateBudgetWeighted bütçe stratejisi, aşağıdaki işlev aracılığıyla uygulanır:

function calculateBudgetWeighted(costSoFar, totalBudget, daysSoFar, totalDays) {
  const daysRemaining = totalDays - daysSoFar;
  const budgetRemaining = totalBudget - costSoFar;
  if (daysRemaining <= 0) {
    return budgetRemaining;
  } else {
    return budgetRemaining / (2 * daysRemaining - 1) ;
  }
}

Bu işlev şu bağımsız değişkenleri alır:

costSoFar
START_DATE tarihinden bugüne kadar kampanyaya tahakkuk eden maliyet.
totalBudget
START_DATE - END_DATE tarihleri arasındaki harcama tahsis edildi.
daysSoFar
START_DATE ile bugün arasında geçen gün sayısı.
totalDays
START_DATE ile END_DATE arasındaki toplam gün sayısı.

Bu bağımsız değişkenleri aldığı sürece kendi işlevinizi yazabilirsiniz. Bu değerleri kullanarak, şimdiye kadar ne kadar para harcadığınızı, toplamda ne kadar harcayacağınızla karşılaştırabilir ve tüm bütçe için zaman çizelgesi dahilinde şu anda nerede olduğunuzu belirleyebilirsiniz.

Bu bütçe stratejisi özellikle ne kadar bütçe kaldığını (totalBudget - costSoFar) hesaplar ve bunu kalan gün sayısının iki katına böler. Bu metrik, kampanyanın sonuna doğru bütçe dağılımını ağırlıklandırır. START_DATE tarihinden itibaren olan maliyet kullanıldığında, belirlenen bütçenin tamamen harcanmadığı "yavaş gün sayısı" da dikkate alınır.

Gerçek harcamalar için

Bütçe stratejinizden memnun kaldığınızda, bu komut dosyasını günlük olarak çalışacak şekilde planlamadan önce birkaç değişiklik yapmanız gerekir.

İlk olarak, dosyanın en üst kısmındaki sabit değerleri güncelleyin:

  • START_DATE: Bunu bütçe stratejinizin başlangıcı olarak ayarlayın. Bugün veya geçmişteki bir gün olabilir.
  • END_DATE: Bu seçeneği, bu bütçeyle reklam vermek istediğiniz son gün olarak ayarlayın.
  • TOTAL_BUDGET: Harcamaya çalıştığınız toplam tutar. Bu değer hesabın para birimindedir ve komut dosyasının çalıştırılmasının planlandığı zamana bağlı olarak aşılabilir.
  • CAMPAIGN_NAME: Bütçe stratejisinin uygulanacağı kampanyanın adı.

Daha sonra testi devre dışı bırakın ve bütçeyi gerçekten değiştirme mantığını etkinleştirin:

function main() {
  // testBudgetStrategy(calculateBudgetEvenly, 10, 500);
  setNewBudget(calculateBudgetWeighted, CAMPAIGN_NAME, TOTAL_BUDGET, START_DATE, END_DATE);
}

Scheduling (Zaman planlama)

Bir sonraki günün bütçesini mümkün olduğunca yönlendirmek için bu komut dosyasını yerel saat diliminde her gün, gece yarısından kısa bir süre sonra çalışacak şekilde planlayın. Bununla birlikte, maliyet gibi rapor verilerinin alınmasında yaklaşık 3 saat gecikebileceğini unutmayın. Bu nedenle, costSoFar parametresi, gece yarısından sonra çalışması planlanan bir komut dosyası için dünün toplamını referans alıyor olabilir.

Kurulum

  • Komut dosyasını Google Ads hesabınızda oluşturmak için aşağıdaki düğmeyi tıklayın.

    Komut dosyası şablonunu yükleme

  • Komut dosyasını kaydedin ve Önizle düğmesini tıklayın. Bu komut dosyası (varsayılan olarak), 10 gün boyunca 500 ABD doları değerinde bir bütçe stratejisini simüle eder. Logger çıktısı; simüle edilen günü, o gün için ayrılan bütçeyi ve o güne kadar harcanan toplam tutarı yansıtır.

Kaynak kodu

// Copyright 2015, Google Inc. All Rights Reserved.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

/**
 * @name Flexible Budgets
 *
 * @overview The Flexible budgets script dynamically adjusts campaign budget for
 *     an advertiser account with a custom budget distribution scheme on a daily
 *     basis. See
 *     https://developers.google.com/google-ads/scripts/docs/solutions/flexible-budgets
 *     for more details.
 *
 * @author Google Ads Scripts Team [adwords-scripts@googlegroups.com]
 *
 * @version 2.1
 *
 * @changelog
 * - version 2.1
 *   - Split into info, config, and code.
 * - version 2.0
 *   - Updated to use new Google Ads scripts features.
 * - version 1.0.3
 *   - Add support for video and shopping campaigns.
 * - version 1.0.2
 *   - Use setAmount on the budget instead of campaign.setBudget.
 * - version 1.0.1
 *   - Improvements to time zone handling.
 * - version 1.0
 *   - Released initial version.
 */

/**
 * Configuration to be used for the Flexible Budgets script.
 */

CONFIG = {
  'total_budget': 500,
  'campaign_name': 'Special Promotion',
  'start_date': 'November 1, 2021 0:00:00 -0500',
  'end_date': 'December 1, 2021 0:00:00 -0500'
};

const TOTAL_BUDGET = CONFIG.total_budget;
const CAMPAIGN_NAME = CONFIG.campaign_name;
const START_DATE = new Date(CONFIG.start_date);
const END_DATE = new Date(CONFIG.end_date);

function main() {
  testBudgetStrategy(calculateBudgetEvenly, 10, 500);
//  setNewBudget(calculateBudgetEvenly, CAMPAIGN_NAME, TOTAL_BUDGET,
//      START_DATE, END_DATE);
}

function setNewBudget(budgetFunction, campaignName, totalBudget, start, end) {
  const today = new Date();
  if (today < start) {
    console.log('Not ready to set budget yet');
    return;
  }
  const campaign = getCampaign(campaignName);
  const costSoFar = campaign.getStatsFor(
        getDateStringInTimeZone('yyyyMMdd', start),
        getDateStringInTimeZone('yyyyMMdd', end)).getCost();
  const daysSoFar = datediff(start, today);
  const totalDays = datediff(start, end);
  const newBudget = budgetFunction(costSoFar, totalBudget, daysSoFar,
                                   totalDays);
  campaign.getBudget().setAmount(newBudget);
}

function calculateBudgetEvenly(costSoFar, totalBudget, daysSoFar, totalDays) {
  const daysRemaining = totalDays - daysSoFar;
  const budgetRemaining = totalBudget - costSoFar;
  if (daysRemaining <= 0) {
    return budgetRemaining;
  } else {
    return budgetRemaining / daysRemaining;
  }
}

function calculateBudgetWeighted(costSoFar, totalBudget, daysSoFar,
    totalDays) {
  const daysRemaining = totalDays - daysSoFar;
  const budgetRemaining = totalBudget - costSoFar;
  if (daysRemaining <= 0) {
    return budgetRemaining;
  } else {
    return budgetRemaining / (2 * daysRemaining - 1);
  }
}

function testBudgetStrategy(budgetFunc, totalDays, totalBudget) {
  let daysSoFar = 0;
  let costSoFar = 0;
  while (daysSoFar <= totalDays + 2) {
    const newBudget = budgetFunc(costSoFar, totalBudget, daysSoFar, totalDays);
    console.log(`Day ${daysSoFar + 1} of ${totalDays}, new budget ` +
                `${newBudget}, cost so far ${costSoFar}`);
    costSoFar += newBudget;
    daysSoFar += 1;
  }
}

/**
 * Returns number of days between two dates, rounded up to nearest whole day.
 */
function datediff(from, to) {
  const millisPerDay = 1000 * 60 * 60 * 24;
  return Math.ceil((to - from) / millisPerDay);
}

function getDateStringInTimeZone(format, date, timeZone) {
  date = date || new Date();
  timeZone = timeZone || AdsApp.currentAccount().getTimeZone();
  return Utilities.formatDate(date, timeZone, format);
}

/**
 * Finds a campaign by name, whether it is a regular, video, or shopping
 * campaign, by trying all in sequence until it finds one.
 *
 * @param {string} campaignName The campaign name to find.
 * @return {Object} The campaign found, or null if none was found.
 */
function getCampaign(campaignName) {
  const selectors = [AdsApp.campaigns(), AdsApp.videoCampaigns(),
      AdsApp.shoppingCampaigns()];
  for (const selector of selectors) {
    const campaignIter = selector
        .withCondition(`CampaignName = "${campaignName}"`)
        .get();
    if (campaignIter.hasNext()) {
      return campaignIter.next();
    }
  }
  throw new Error(`Could not find specified campaign: ${campaignName}`);
}