Kampanyaları yönetmek için betik örnekleri

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

Tüm kampanyaları alma

Bir hesaptaki tüm kampanyaları almak için önce AdsApp nesnesinin campaigns yöntemini çağırarak seçiciyi alın. Ardından seçicinin get yöntemini çağırarak kampanya listesinde yineleme yapmak için kullandığınız bir yineleyici alın. Örnek herhangi bir filtre belirtmediğinden, seçici hesaptaki tüm kampanyaları döndürür. Yineleyicideki kampanya sayısını belirlemek için yineleyicinin yöntemini çağırın totalNumEntities .

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

Kampanyayı ada göre alma

Bir kampanyayı ada göre almak için önce AdsApp nesnesinin campaigns yöntemini çağırarak seçiciyi alın. Seçici, kampanya listesini filtrelemek için kullandığınız bir dizi filtre yöntemini içerir. withCondition Belirli bir kampanya adı için kampanyaları filtrelemek için yöntemini kullanın. İş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. 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ğine göre kampanya alma

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öntemini kullanın withIds . Ö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 alma

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

Erişebileceğiniz ölçümlerin listesi için İstatistikler 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

Kampanyayı duraklatmak için kampanyanın yöntemini çağırın pause . Yeniden etkinleştirmek için kampanyanın yöntemini çağırın enable . Kampanyanın durumunu belirlemek için kampanyanın isEnabled, isPausedve 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();
    }
}