İnşaatçılar nedir?

Bir varlık eklemek için oluşturucuları kullanırsınız. Campaign gibi her üst nesne, alt varlıklar eklemek için kullandığınız oluşturucu nesnelerini almak için yöntemler içerir. Örneğin, bir kampanyaya reklam grubu eklemek için nesnenin newAdGroupBuilder yöntemini çağırırsınızCampaign.

Oluşturucu nesnesi, varlığın özellik değerlerini ayarlamak için kullandığınız yöntemleri içerir. Örneğin, bir anahtar kelimenin TBM'sini belirtmek için yöntemi kullanırsınız withCpc . Varlığın tüm özellik değerlerini ayarladıktan sonra, varlığı oluşturmak için yöntemi çağırırsınız build . Derleme işlemi, isteğin diğer derleme istekleriyle birlikte kuyruğa alındığı ve toplu olarak işlendiği zaman uyumsuz bir işlemdir. Toplu istekler, betik sonlandırılmadan önce tamamlanır.

Derleme isteklerinin başarılı olup olmadığını belirlemek için günlüklere bakabilir veya yöntemin döndürdüğü işlem nesnesini build kullanabilirsiniz. Örneğin, AdGroupBuilder , AdGroupOperation'ı döndürür. Betiklerin varlığı başarıyla oluşturup oluşturmadığını belirlemek için işlem nesnesinin yöntemlerinden herhangi birini (isSuccessful, getResult, veya getErrors) çağırabilirsiniz. Ancak bu yöntemler çağrılırken performansla ilgili dikkate alınacak noktalar vardır (bkz.

Aşağıdaki örnek, oluşturucu ve işlem nesnelerini kullanarak bir anahtar kelimenin nasıl oluşturulacağını kavramsal olarak gösterir. Büyük olasılıkla bu akışı yalnızca tek bir (veya belki birkaç) varlık oluşturuyorsanız kullanmanız gerekir.

    // Gets the first ad group in the account.
    var adGroup = AdsApp.adGroups().get().next();

    // Use the 'with' methods to specify the keyword's property values.
    // The .build() method adds the build request to the build queue.
    var keywordOperation = adGroup.newKeywordBuilder()
        .withCpc(1.2)
        .withText("shirts")
        .withFinalUrl("https://www.contoso.com/shirts")
        .build();

    // Call isSuccessful() to determine if the build succeeded.
    // Calling any of the operation object's method processes the
    // build request immediately. 
    if (keywordOperation.isSuccessful()) {
        // You only need to call getResult if you need to access
        // the new keyword entity.
        var keyword = keywordOperation.getResult();
    } else {
        // Handle the errors.
        for (var error of keywordOperation.getErrors()) {
            Logger.log(`${error}\n`);
        }
    }

Performansla ilgili dikkat edilmesi gerekenler

Performansı artırmak için Betikler, derleme isteklerini toplu olarak işler. Bir derleme isteğinin işlem yöntemini çağırırsanız, Betikleri kuyruğa alınan derleme isteklerini hemen işlemeye zorlar ve herhangi bir performans kazanımını ortadan kaldırır. Birden fazla varlık oluşturuyorsanız, işlem yöntemlerini varlığı oluşturmak için kullandığınız döngüde yürütmeyin. Bu, aynı anda yalnızca bir varlık işlendiğinden düşük performansa yol açar. Bunun yerine, işlemlerin bir dizisini oluşturun ve derleme döngüsünden sonra bunları işleyin.

Bunu yapın

    // An array to hold the operations, so you 
    // can process them after all the entities are queued.
    var operations = []; 

    // Create all the new entities.
    for (var i = 0; i < keywords.length; i++) {
        var keywordOperation = AdsApp.adGroups().get().next()
          .newKeywordBuilder()
          .withText(keywords[i])
          .build();
        operations.push(keywordOperation);
    }

    // Now call the operation method so the build requests
    // get processed in batches.
    for (var i = 0; i < operations.length; i++) {
        var newKeyword = operations[i].getResult();
    }

Bunu yapma

    for (var i = 0; i < keywords.length; i++) {
        var keywordOperation = AdsApp.adGroups().get().next()
          .newKeywordBuilder()
          .withText(keywords[i])
          .build();

        // Don't get results in the same loop that creates
        // the entity because Scripts then only processes one
        // entity at a time.
        var newKeyword = keywordOperation.getResult();
    }

İnşaatçıların listesi aşağıdadır.

Sonraki adımlar

Önizleme modu hakkında bilgi edinin

  • Last updated on