Reklam gruplarını yönetmek için komut dosyası örnekleri

Aşağıdaki bölümlerde, reklam gruplarına karşı çeşitli işlemler gerçekleştiren komut dosyası örnekleri gösterilmektedir.

Reklam grupları ekleme

Bir reklam grubu eklemek için, önce reklam grubunun ekleneceği kampanyayı alın. Kampanyayı seçmek için CampaignSelector nesnesini kullanın. Yöntemi withIds kullanmak, kampanyanın adını yöntemde withCondition geçirmekten daha iyi performans sağlar.

Ardından, reklam grubunun özelliklerini belirtmek için kullandığınız bir oluşturucu almak için kampanyanın newAdGroupBuilder yöntemini çağırın. Gerekli olan tek özellik, kampanya içinde benzersiz olması gereken reklam grubunun adıdır (yönteme withName bakın). Bir TBM değeri belirtmezseniz, varsayılan olarak hesabınızın para birimi için minimum teklif tutarı kullanılır. Dili yalnızca kampanya belirtmiyorsa belirtmeniz gerekir; Aksi takdirde, kampanyanın dil değerini devralır. Varsayılan olarak, reklam grubunun durumu duraklatılmıştır.

Oluşturucunun yöntemini çağırmak build , reklam grubunu eşzamansız olarak oluşturur; Betikler, betik sona ermeden önce veya derleme işleminin yöntemlerinden birini çağırırsanız reklam grubunu ekler. Bu işlem hakkında daha fazla bilgi için bkz : Oluşturucu nedir?

function main() {
    // The ID of the campaign to add the ad groups to.
    // IDs in Scripts are string integers.
    var campaignId = 'CAMPAIGN ID GOES HERE';  
    var campaign = getCampaign(campaignId);

    // Ad groups to add.
    var adGroups = [];
    adGroups.push({
        name : 'AD GROUP NAME GOES HERE',
        cpc : 2.25,
        language : 'English' // Required if the campaign doesn't specify a language
    });
    adGroups.push({
        name : 'AD GROUP NAME GOES HERE',
        cpc : 1.25,
        language : 'English' // Required if the campaign doesn't specify a language
    });

    var operations = [];

    if (campaign != null)
    {
        for (var adGroup of adGroups) {
            var operation = addAdGroup(
                campaign, 
                adGroup.name, 
                adGroup.cpc, 
                adGroup.language);
            operations.push(operation);
        }
    }
    else {
        Logger.log("Unable to retrieve campaign, " + campaignId);
    }

    checkBuildStatus(operations, adGroups);
}

// Get the campaign using its ID.
function getCampaign(id) {
    var iterator = AdsApp.campaigns()
        .withIds([id])
        .get();

    // Return the campaign if it exists; otherwise, null.
    if (iterator.hasNext()) {
        return iterator.next();
    }
    else {
        return null;
    }
}

// Add the ad group to the specified campaign.
// Returns the builder's operation object, which you use to 
// check the status of the add operation.
function addAdGroup(campaign, name, cpc, language) {

    return campaign.newAdGroupBuilder()
        .withName(name)
        .withCpc(cpc)
        .withLanguage(language)
        .build();
}

// Check the ad group's build status.
function checkBuildStatus(operations, adGroups) {

    for (var i = 0; i < operations.length; i++) {
        if (!operations[i].isSuccessful()) {
            for (var error of operations[i].getErrors()) {
                Logger.log(`Failed to add, ${adGroups[i].name}. Error: ${error}`);
            }
        }
    }
}

Tüm reklam gruplarını al

Tüm reklam gruplarını bir hesaba almak için, seçiciyi almak için önce AdsApp nesnesinin adGroups yöntemini çağırın. Ardından, reklam grupları 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 reklam gruplarını döndürür. Yineleyicideki reklam gruplarının sayısını belirlemek için yineleyicinin totalNumEntities yöntemini çağırın.

function main() {
    // Gets all ad groups in the account.
    var iterator = AdsApp.adGroups().get();
    
    // Iterates through the list of ad groups and logs 
    // each ad group's name.
    while (iterator.hasNext()) {
        var adGroup = iterator.next();
    }
}

Ada göre reklam grubu alma

Bir reklam grubunu ada göre almak için, seçiciyi almak üzere önce AdsApp nesnesinin adGroups yöntemini çağırın. Seçici, reklam grupları listesini filtrelemek için kullanacağınız bir dizi filtreleme yöntemi içerir. withCondition Belirli bir reklam grubu adı için reklam gruplarını filtrelemek üzere bu 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. Bir kampanyadaki reklam grubu adları benzersizdir, ancak birden fazla kampanyada aynı ada sahip reklam grupları olabilir. Bu nedenle, yalnızca ada göre filtrelerseniz, yineleyici birden fazla reklam grubu içerebilir.

Belirli bir kampanyadan ada göre bir reklam grubu almak istiyorsanız, kampanyanın adını (CampaignName = '<campaignnamegoeshere>') belirten bir withCondition yöntem ekleyin.

function main() {
    // The name of the ad group to get.
    var adGroupName = 'AD GROUP NAME GOES HERE';

    // Get the ad groups with the specified name.
    var iterator = AdsApp.adGroups()
          .withCondition(`Name = '${adGroupName}'`)
          .get();

    // Need a loop because multiple campaigns can have 
    // an ad group with the same name.
    while (iterator.hasNext()) {
        var adGroup = iterator.next();
    }
}

Kimliğe göre reklam grubu alma

Reklam grubunun kimliğine erişiminiz varsa bunun yerine 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 adGroupId = '12345';

    var iterator = AdsApp.adGroups()
        .withIds([adGroupId])
        .get();

    if (iterator.hasNext()) {
        var adGroup = iterator.next();
    }
}

Belirli bir kampanyadan ada göre reklam grubu alma

function main() {
    var adGroupName = 'AD GROUP NAME GOES HERE';
    var campaignName = "CAMPAIGN NAME GOES HERE";

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

    if (iterator.hasNext()) {
        var adGroup = iterator.next();
    }
}

Bir reklam grubunun performans verilerini alma

Bir reklam grubunun performans metriklerini almak için reklam grubunun getStats yöntemini çağırın. Reklam grubunu 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, reklam grubunu seçerken yöntemlerden birini forDateRange kullanın ( AdGroupSelector sayfasına bakın).

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

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

    // Get the ad group. You need to specify the date range of the
    // performance data you want to get.
    var iterator = AdsApp.adGroups()
        .forDateRange('LAST_WEEK')
        .withCondition(`Name = '${adGroupName}'`)
        .withCondition(`CampaignName = '${campaignName}'`)
        .get();
    
    // If the ad group is found, log some metrics.
    if (iterator.hasNext()) {
        var adGroup = iterator.next();
        var metrics = adGroup.getStats(); // Gets the performance metrics.
    }
}

Bir reklam grubunu duraklatma

Bir reklam grubu eklediğinizde, durumu varsayılan olarak Duraklatıldı olur. Reklam grubunu etkinleştirmek için reklam grubunun enable yöntemini çağırın. Reklam grubunun durumunu Duraklatıldı olarak değiştirmek için reklam grubunun pause yöntemini çağırın. Reklam grubunun durumunu belirlemek için reklam grubunun isEnabled, isPaused, ve isRemoved yöntemlerini çağırın.

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

    // Get the ad group. 
    var iterator = AdsApp.adGroups()
        .withCondition(`Name = '${adGroupName}'`)
        .withCondition(`CampaignName = '${campaignName}'`)
        .get();

    if (iterator.hasNext()) {
        var adGroup = iterator.next();
        adGroup.pause();
    }
}