Öğeler

Maksimum Performans kampanyası oluşturmadan önce kampanyada kullanmayı planladığınız tüm öğeleri içe aktarmanız önemlidir. İstediğiniz zaman geri gelip daha sonra öğ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 öğeleri ve resim öğeleri, gerekli olan birincil öğe türleri olduğundan bu kılavuzda her birinin nasıl yükleneceği gösterilmektedir. Bu ilkeler diğer öğe türleri için de geçerlidir. Hangi türde öğe oluşturursanız oluşturun, AssetOperation simgesini kullanarak öğeyi oluşturun.

Öğeler, mutate kullanılmadan AdsApp ile oluşturulabilir ancak tutarlılık açısından bu kılavuzda işlemlerin geri kalanıyla aynı şekilde oluşturulur. Halihazırda mevcut öğeleriniz varsa bunları yeniden kullanabileceğinizi ve kullanmanız gerektiğini unutmayın. Dolayısıyla, Maksimum Performans kampanyası oluşturmak için öğelerinizin olması gerekirken bu öğeleri kampanya oluşturma sürecinin bir parçası olarak oluşturmanız kesinlikle gerekli olmayabilir.

Metin öğeleri

Metin öğeleri, diğer tüm işlemler gibi çalışır. Öğeleri kampanya oluşturma sürecinin bir parçası olarak yüklüyorsanız geçici bir kimlik kullanın. Aksi takdirde, öğeyi bir öğe grubuna eklemek için öğeye başvurmanı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 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 kodlamayla ilgili iki farklı yaklaşım arasından seçim yapabilirsiniz.

Google Drive'dan bir resim getirmek için öncelikle resmin kimliğini almanız gerekir. Bu, resmi benzersiz şekilde tanımlamanın en iyi yoludur. Kimliği almanın bir yolu, paylaşılabilir bağlantıyı Google Drive kullanıcı arayüzünden kopyalayıp kimliği ayıklamaktır. Ayrıca, bir dizi dosyayı programatik olarak getirebilir ve yüklemek istediğiniz dosyaları 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())
      }
    }
  }
}

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

const file = UrlFetchApp.fetch(imageUrl);

Ardından, bu dosyada Drive dosyasıyla yaptığınız gibi getBlob çağrısı yapabilirsiniz. Bu nedenle, işlem oluşturma süreci Google Drive dosyasıyla aynıdır.