Recursos

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

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

Como os recursos de texto e imagem são os principais tipos obrigatórios, este guia demonstra 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 criar isso.

Os recursos podem ser criados usando AdsApp sem usar mutate, mas, para fins de consistência, este guia faz isso da mesma forma que todas as outras operações. Observe que você pode e deve reutilizar os recursos atuais, 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 o 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 o 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 receber o ID é copiar o link compartilhável da interface do Google Drive e extrair o ID. Você também pode buscar uma série de arquivos de forma programática e selecionar aqueles que quer fazer o upload. Este código demonstra como fazer o 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, você pode buscar uma imagem hospedada em um servidor da Web pelo URL usando UrlFetchApp:

const file = UrlFetchApp.fetch(imageUrl);

Em seguida, você pode chamar getBlob nesse arquivo da mesma forma que faria com um arquivo do Drive. Assim, a construção da operação é idêntica às etapas de um arquivo do Google Drive.