Kampanyaları yönetmek için komut dosyası örnekleri

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

Not

Maksimum Performans kampanyalarının komut dosyalarıyla yönetilmesi desteklenmez.

Tüm kampanyaları al

Tüm kampanyaları bir hesaba almak için, seçiciyi almak için önce AdsApp nesnesinin campaigns yöntemini çağırın. Ardından, kampanya listesini yinelemek için kullandığınız bir yineleyici almak için seçicinin get yöntemini çağırın. Örnekte herhangi bir filtre belirtilmediğinden, seçici hesaptaki tüm kampanyaları döndürür. Yineleyicideki kampanya sayısını belirlemek için yineleyicinin totalNumEntities yöntemini çağırın.

function main() {
    // Gets all campaigns in the account.
    var iterator = AdsApp.campaigns().get();

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

Ada göre kampanya alma

Bir kampanyayı adıyla almak için, seçiciyi almak için önce AdsApp nesnesinin campaigns yöntemini çağırın. Seçici, kampanya listesini filtrelemek için kullanacağınız bir dizi filtre yöntemi içerir. Kampanyaları withCondition , belirli bir kampanya adı için filtrelemek üzere yöntemi kullanın. İş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. Kampanya adları benzersizdir, bu nedenle varsa yalnızca bir tane geri alırsınız.

function main() {
    var campaignName = 'CAMPAIGN NAME GOES HERE';

    var iterator = AdsApp.campaigns()
        .withCondition(`Name = '${campaignName}'`)
        .get();

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

Kimliğe göre kampanya al

Kampanyanın kimliğine erişiminiz varsa, bunun yerine bu kimliği 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 campaignId = '12345';

    var iterator = AdsApp.campaigns()
        .withIds([campaignId])
        .get();

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

Kampanyanın performans verilerini alın

Bir kampanyanın performans metriklerini almak için kampanyanın getStats yöntemini çağırın. Kampanyayı 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, kampanyayı seçerken yöntemlerden birini forDateRange kullanın (bkz.

Erişebileceğiniz metriklerin listesi için Stats nesnesine bakın.

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

    // Get the campaign. You need to specify the date range of the
    // performance data you want to get.
    var iterator = AdsApp.campaigns()
        .withIds([campaignId])
        .forDateRange('LAST_WEEK')
        .get();

    // If the campaign is found, log some metrics.
    while (iterator.hasNext()) {
        var campaign = iterator.next();
        var metrics = campaign.getStats(); // Gets the performance metrics.
    }
}

Kampanyayı duraklatma

Bir kampanyayı duraklatmak için kampanyanın pause yöntemini çağırın. Tekrar etkinleştirmek için kampanyanın enable yöntemini çağırın. Kampanyanın durumunu belirlemek için kampanyanın isEnabled, isPaused, ve isRemoved yöntemlerini çağırın.

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

    var iterator = AdsApp.campaigns()
        .withIds([campaignId])
        .get();

    // If the campaign is found, pause it.
    while (iterator.hasNext()) {
        var campaign = iterator.next();
        campaign.pause();
    }
}