Öğeler

Maksimum Performans kampanyası oluşturmadan önce kampanyada kullanmayı planladığınız tüm öğeleri içe aktarmanız önemlidir. İstediğiniz zaman geri dönüp daha sonra öğe ekleyebilirsiniz ancak başlamak için bir dizi öğeye ihtiyacınız vardır.

Kampanyanızı planlarken Maksimum Performans kampanyalarının öğeleri ve öğe koşulları hakkında bilgi edinin.

Metin öğeleri ve resim öğeleri, gerekli birincil öğe türleri olduğundan bu kılavuzda bunların her birinin nasıl yükleneceği gösterilmektedir. Bu ilkeler diğer öğe türleri için de geçerli olabilir. Ne tür bir öğe oluşturduğunuz fark etmeksizin, öğeyi oluşturmak için AssetOperation simgesini kullanın.

Öğeler, mutate kullanılmadan AdsApp kullanılarak oluşturulabilir ancak tutarlılık açısından bu kılavuzda diğer tüm işlemlerle aynı şekilde oluşturulur. Halihazırda mevcut öğeleriniz varsa bunları yeniden kullanabileceğinizi ve kullanmanız gerektiğini unutmayın. Bu nedenle, Maksimum Performans kampanyası oluşturmak için öğeleriniz olması gerekir ancak bunları kampanya oluşturma sürecinin bir parçası olarak oluşturmanız kesinlikle zorunlu olmayabilir.

Metin öğeleri

Metin öğeleri, diğer tüm işlemler gibi çalışır. Kampanya oluşturma sürecinin bir parçası olarak öğe yüklüyorsanız geçici kimlik kullanın. Aksi takdirde, öğeyi bir öğe grubuna eklemek için referans olarak kullanmanız gerektiğinde gelecekteki bir işlemde kullanmak üzere döndürülen kaynak adını not edin.

const textAsset = {
  "assetOperation": {
    "create": {
      "resourceName": `customers/${customerId}/assets/${getNextTempId()}`,
      "textAsset": {
        "text": "Travel the World"
      }
    }
  }
}
operations.push(textAsset);

Resim öğeleri

Resim öğeleri base64 kodlamalı biçimde yüklenir. Resimleri doğrudan Google Ads komut dosyalarına yükleyemeyeceğiniz için resim verilerini alma ve yükleme için kodlama konusunda iki farklı yaklaşımdan birini seçebilirsiniz.

Google Drive'dan bir resim almak için öncelikle resmin kimliğine ihtiyacınız vardır. Bu, resmi benzersiz şekilde tanımlamanın en iyi yoludur. Kimliği almanın bir yolu, Google Drive kullanıcı arayüzünden paylaşılabilir bağlantıyı kopyalayıp kimliği ayıklamaktır. Ayrıca, bir dizi dosyayı programatik olarak getirip yüklemek istediğiniz dosyaları seçebilirsiniz. Bu kod, bilinen bir kimliğe sahip tek bir resmin nasıl yükleneceğini gösterir:

const file = DriveApp.getFileById(fileId);
const imageAsset =  {
  "assetOperation": {
    "create": {
      "resourceName": `customers/${customerId}/assets/${getNextTempId()}`,
      "name": "Marketing Logo",
      "type": "IMAGE",
      "imageAsset": {
        "data": Utilities.base64Encode(file.getBlob().getBytes())
      }
    }
  }
}

Alternatif olarak, web sunucusunda barındırılan bir resmi URL'sine göre UrlFetchApp kullanarak da getirebilirsiniz:

const file = UrlFetchApp.fetch(imageUrl);

Ardından, bu dosyada getBlob işlevini bir Drive dosyasında yaptığınız gibi çağırabilirsiniz. Bu nedenle, işlem oluşturma işlemi bir Google Drive dosyası için uygulanan adımlarla aynıdır.