Ресурсы

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

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

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

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

Текстовые активы

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

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

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

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

Чтобы загрузить изображение с Google Диска, сначала вам понадобится его идентификатор (ID) , который является лучшим способом уникальной идентификации изображения. Один из способов получить идентификатор — скопировать ссылку общего доступа из интерфейса 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 Диска.