Ресурсы

Прежде чем создавать кампанию с максимальной эффективностью, важно импортировать все объекты, которые вы планируете использовать в кампании. Вы всегда можете вернуться и добавить ресурсы позже, но для начала вам понадобится набор ресурсов.

При планировании кампании ознакомьтесь с ресурсами и требованиями к ним для кампаний с максимальной эффективностью.

Поскольку текстовые ресурсы и графические ресурсы являются основными обязательными типами ресурсов, в этом руководстве будет показано, как загрузить каждый из них. Эти принципы могут быть распространены и на другие типы активов. Независимо от того, какой тип актива вы создаете, используйте AssetOperation для его создания.

Активы можно создавать с помощью AdsApp без использования mutate, но в целях единообразия в этом руководстве это делается так же, как и все остальные операции. Обратите внимание, что вы можете и должны повторно использовать существующие ресурсы, если они у вас уже есть. Таким образом, хотя для создания кампании с максимальной эффективностью у вас должны быть ресурсы, возможно, не обязательно создавать их в рамках процесса создания кампании.

Текстовые ресурсы

Текстовые ресурсы работают так же, как и любая другая операция. Если вы загружаете ресурсы в рамках процесса создания кампании, используйте временный идентификатор. В противном случае запишите имя возвращенного ресурса, чтобы использовать его в будущей операции, когда вам понадобится сослаться на актив, чтобы добавить его в группу активов.

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

Ресурсы изображений

Ресурсы изображений загружаются в формате с кодировкой Base64 . Поскольку вы не можете загружать изображения непосредственно в скрипты Google Рекламы, у вас есть выбор из двух разных подходов для получения данных изображения и их кодирования для загрузки.

Чтобы получить изображение с Google Диска, сначала вам понадобится его идентификатор , который является лучшим способом уникальной идентификации изображения. Один из способов получить идентификатор — скопировать общую ссылку из пользовательского интерфейса Google Диска и извлечь идентификатор. Вы также можете программно получить ряд файлов и выбрать те, которые хотите загрузить. Этот код демонстрирует, как загрузить одно изображение с известным идентификатором:

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())
      }
    }
  }
}

Альтернативно вы можете получить изображение, размещенное на веб-сервере, по его URL-адресу, используя UrlFetchApp :

const file = UrlFetchApp.fetch(imageUrl);

Затем вы можете вызвать getBlob для этого файла так же, как и для файла Диска, поэтому конструкция операции идентична шагам для файла Google Диска.