Anahtar sözcükleri yönetmek için komut dosyası örnekleri

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

Anahtar sözcük ekleme

Anahtar kelime eklemek için önce anahtar kelimenin ekleneceği reklam grubunu alın. Reklam grubunu seçmek için AdGroupSelector nesnesini kullanın. Yöntemin kullanılması, withIds yöntemde withCondition reklam grubunun adını iletmekten daha iyi performans sağlar.

Ardından, anahtar kelimenin özelliklerini belirtmek için kullandığınız bir oluşturucu almak için reklam grubunun newKeywordBuilder yöntemini çağırın. Belirtmeniz gereken tek özellik anahtar sözcüğün metnidir (yönteme withText bakın). Metinde eşleşme türü bulunmalıdır (sıralı eşleme türü için tırnak işaretleri, tam eşleşme türü için köşeli parantezler, geniş eşleşme türü için hiçbir şey yok).

Bir TBM değeri belirtmezseniz, varsayılan olarak reklam grubunun TBM değeri kullanılır. Varsayılan olarak, anahtar kelimenin durumu etkindir.

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

function main() {
    // The ID of the ad group to add the keywords to.
    // IDs in Scripts are string integers.
    var adGroupId = 'AD GROUP ID GOES HERE';  
    var adGroup = getAdGroup(adGroupId);

    // Keywords to add. Update as appropriate.
    var keywords = [];
    keywords.push({
        text : "keyword 1",
        cpc : 1.25,
        finalUrl : 'http://www.example.com'
    });
    keywords.push({
        text : "keyword 2",
        cpc : 1.5,
        finalUrl : 'http://www.example.com'
    });

    var operations = [];

    if (adGroup != null)
    {
        for (var keyword of keywords) {
            var operation = addKeyword(
                adGroup, 
                keyword.text, 
                keyword.cpc, 
                keyword.finalUrl);
            operations.push(operation);
        }
    }
    else {
        Logger.log("Unable to retrieve ad group, " + adGroupId);
    }

    checkBuildStatus(operations, keywords);
}

// Get the ad group using its ID.
function getAdGroup(id) {
    var iterator = AdsApp.adGroups()
        .withIds([id])
        .get();

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

// Add the keyword to the specified ad group.
function addKeyword(adGroup, text, cpc, finalUrl) {

    return adGroup.newKeywordBuilder()
        .withText(text)
        .withCpc(cpc)
        .withFinalUrl(finalUrl)
        .build();
}

// Check the keyword's build status.
function checkBuildStatus(operations, keywords) {

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

Bir anahtar sözcüğü duraklatma

Bir anahtar sözcük eklediğinizde, durumu varsayılan olarak Etkin olur. Anahtar kelimeyi duraklatmak için anahtar kelimenin pause yöntemini çağırın. Anahtar kelimenin durumunu belirlemek için anahtar kelimeleri isEnabled ve isPaused yöntemleri çağırın.

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

    var iterator = AdsApp.keywords()
        .withCondition(`Text = '${keywordText}'`)
        .withCondition(`AdGroupName = '${adGroupName}'`)
        .withCondition(`CampaignName = '${campaignName}'`)
        .get();

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

Bir reklam grubundaki tüm anahtar kelimeleri alma

Bir reklam grubundaki tüm anahtar kelimeleri almak için, seçiciyi almak için önce AdsApp nesnesinin keywords yöntemini çağırın. Reklam grubunu ve kampanyayı withCondition belirtmek için yöntemi kullanın. Ardından, anahtar kelimeler listesini yinelemek için kullandığınız bir yineleyici elde etmek için seçicinin get yöntemini çağırın. Yineleyicideki anahtar sözcük sayısını belirlemek için yineleyicinin totalNumEntities yöntemini çağırın.

Anahtar sözcük kimliklerine erişiminiz varsa, bunun yerine bunları 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']). Kimlikleri kullanarak alabileceğiniz varlıkların sayısında sınırlamalar vardır.

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

    var iterator = AdsApp.keywords()
        .withCondition(`AdGroupName = '${adGroupName}'`)
        .withCondition(`CampaignName = '${campaignName}'`)
        .get();
        
    while (iterator.hasNext()) {
        var keyword = iterator.next();
    }
}

Tüm anahtar kelimeleri bir hesaba alma

Komut dosyalarının bir hesap için döndürebileceği anahtar kelime sayısının bir sınırı vardır. Sınır tanımsızdır ve değişebilir. Aşağıdaki örnek, bir hesapta çok fazla anahtar kelime bulunduğu durumları nasıl ele alabileceğinizi gösterir. Örnek, önce hesap düzeyindeki tüm anahtar kelimeleri getirmeyi dener. Bu, "Çok fazla varlık var" hatası nedeniyle başarısız olursa, kampanya düzeyinde genellikle daha az varlık olduğundan, kampanyaya göre anahtar kelimeleri getirmek için birden çok çağrı yapmaya çalışır.

Verim anahtar kelimesini kullanma hakkında bilgi için bkz: Büyük varlık kümeleri alırken verim anahtar sözcüğünü kullanma.

function* getEntities() {
    const applyConditions = _ => _
        .withCondition('CampaignStatus = ENABLED')
        .withCondition('AdGroupStatus = ENABLED')
        .withCondition('Status = ENABLED')
        .withCondition("CombinedApprovalStatus = DISAPPROVED");

    try {
        // Get the account's keywords. 
        const keywords = applyConditions(AdsApp.keywords()).get();

        while (keywords.hasNext()) {
            yield keywords.next();
        }
    } catch (e) {
        if (!e.message.startsWith('There are too many entities')) {
            throw e;
        }

        // If there are too many keywords at the account level,
        // get keywords by campaigns under the account.
        const campaigns = AdsApp.campaigns().get();

        while (campaigns.hasNext()) {
            const campaign = campaigns.next();

            const keywords = applyConditions(campaign.keywords()).get();

            while (keywords.hasNext()) {
                yield keywords.next();
            }
        }
    }
}

Bir anahtar kelimenin performans verilerini alma

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

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';
    var keywordText = 'KEYWORD TEXT GOES HERE';

    // Get the keyword. You need to specify the date range of the
    // performance data you want to get.
    var iterator = AdsApp.keywords()
        .forDateRange('LAST_WEEK')
        .withCondition(`Text = '${keywordText}'`)
        .withCondition(`AdGroupName = '${adGroupName}'`)
        .withCondition(`CampaignName = '${campaignName}'`)
        .get();

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

Bir anahtar kelimenin teklif değerini güncelleyin.

Bir anahtar kelimenin teklif değerinin nasıl güncelleneceğini gösteren bir örnek için, Google'ı arama hizmetleri başlıklı makaleyi inceleyin.