Öğeler

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

Kampanyanızı planlarken Maksimum Performans kampanyaları için öğeler ve öğe koşulları hakkında bilgi edinin.

Metin ve resim öğeleri, gerekli olan başlıca öğe türleri olduğundan bu kılavuzda her birinin nasıl yükleneceği gösterilecektir. Bu ilkeler, diğer öğe türleri için de geçerlidir. Ne tür bir öğe oluşturursanız oluşturun, 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 tüm işlemlerle aynı şekilde yapılır. Mevcut öğeleriniz varsa bunları yeniden kullanabileceğinizi ve kullanmanız gerektiğini unutmayın. Maksimum Performans kampanyası oluşturmak için öğelerinizin olması gerekir ancak bunları kampanya oluşturma sürecinde oluşturmanız 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 ID kullanın. Aksi takdirde, öğeyi bir öğe grubuna eklemek için öğeye referans vermeniz 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, base-64 kodlu biçimde yüklenir. Resimleri doğrudan Google Ads komut dosyalarına yükleyemediğiniz için resim verilerini alıp yükleme için kodlamak üzere iki farklı yaklaşım arasından seçim yapabilirsiniz.

Google Drive'dan bir resim almak için öncelikle resmin kimliğine ihtiyacınız vardır. Bu, resmi benzersiz bir ş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 istediklerinizi seçebilirsiniz. Bu kod, bilinen bir kimliğe sahip tek bir resmi nasıl yükleyeceğinizi 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())
      }
    }
  }
}
operations.push(imageAsset);

Alternatif olarak, UrlFetchApp kullanarak bir web sunucusunda barındırılan resmi URL'siyle getirebilirsiniz:

const file = UrlFetchApp.fetch(imageUrl);

Ardından, bu dosyada getBlob yöntemini tıpkı bir Drive dosyasında olduğu gibi çağırabilirsiniz. Bu nedenle, işlem yapısı bir Google Drive dosyasının adımlarıyla aynıdır.