Recursos

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

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

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

Os recursos podem ser criados usando o 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 os recursos que já tem. Portanto, embora seja necessário ter recursos para criar uma campanha Performance Max, talvez não seja estritamente necessário criar esses recursos 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 e 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 opções para receber os dados de 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. Você também pode buscar uma série de arquivos de forma programática e selecionar os que 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())
      }
    }
  }
}

Também é 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 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.