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 recursos e requisitos de recurso para campanhas Performance Max ao planejar sua campanha.

Como os recursos de texto e de imagem são os principais tipos de recursos necessá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. Independentemente do tipo de recurso que você está criando, use AssetOperation para criar.

Os recursos podem ser criados usando o AdsApp sem usar o mutate, mas, para manter a consistência, este guia faz isso da mesma maneira que o restante das operações. Você pode e deve reutilizar os recursos disponíveis. Portanto, embora seja necessário ter recursos para criar uma campanha Performance Max, talvez não seja 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 fazer referência ao 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ê pode escolher entre duas abordagens diferentes para receber os dados da imagem e codificá-los para o upload.

Para buscar uma imagem do Google Drive, 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 aqueles 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())
      }
    }
  }
}

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 você faria com um arquivo do Drive. Assim, a construção da operação é idêntica às etapas de um arquivo do Google Drive.