Recursos

Antes de criar uma campanha Performance Max, é importante importar todos os recursos que você planeja usar nela. Você pode voltar e adicionar recursos mais tarde, mas precisa de um conjunto de recursos para começar.

Leia sobre os recursos e os requisitos de recursos para campanhas Performance Max ao planejar sua campanha.

Como os recursos de texto e os recursos de imagem são os principais tipos de recursos necessários, este guia vai demonstrar como fazer o upload de cada um deles. Esses princípios também podem ser estendidos a outros tipos de recursos. Não importa o tipo de recurso que você está criando, use AssetOperation para isso.

Os recursos podem ser criados usando AdsApp sem usar mutate, mas, para manter a consistência, este guia faz isso da mesma forma que todas as outras operações. Você pode e deve reutilizar recursos existentes se já tiver alguns disponíveis. Portanto, embora seja necessário ter recursos para criar uma campanha Performance Max, talvez não seja estritamente necessário criá-los como parte do processo de criação da campanha.

Recursos de texto

Os recursos de texto funcionam como qualquer outra operação. Se você estiver fazendo upload de recursos como parte do processo de criação da campanha, use um ID temporário. Caso contrário, anote o nome do recurso retornado para usar em uma operação futura quando precisar referenciar o recurso para adicioná-lo a um grupo de recursos.

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

Recursos de imagem

Os recursos de imagem são enviados em um formato codificado em base64. Como não é possível fazer upload de imagens diretamente nos scripts do Google Ads, você tem duas abordagens diferentes para receber os dados da imagem e codificá-los para o upload.

Para buscar uma imagem do Google Drive, primeiro você precisa do ID dela, que é a melhor maneira de identificar a imagem de forma exclusiva. Uma maneira de conseguir o ID é copiar o link compartilhável da interface do Google Drive e extrair o ID. Também é possível buscar uma série de arquivos de forma programática e selecionar os que você quer enviar. Este código demonstra como fazer upload de uma única imagem com um ID conhecido:

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);

Como alternativa, é possível buscar uma imagem hospedada em um servidor da Web pelo URL usando UrlFetchApp:

const file = UrlFetchApp.fetch(imageUrl);

Em seguida, chame getBlob nesse arquivo, assim como faria com um arquivo do Drive. A construção da operação é idêntica às etapas de um arquivo do Google Drive.